Open Source Hebrew Roots Bible; darcs the right software to use?

Hello.  I'm starting up a project to correct the
translation of the King
James Bible to better fit the underlying Hebrew language,
and release it
under some free license, such as Creative Commons or GFDL.
Maybe dual
license.

I want to leave a clear paper trail of every change I made,
and the
reason for it.

Some changesets will touch a large number of verses, while
others will
only touch a few.

There will be only one (large) file in this project, the
plain text of
the Bible itself.

I want to not only keep a clear record of every change I
make and the
reason for it, but I want to allow web browsers to easily
see the
changes that were made to a particular verse, to see what
changesets
altered that verse, and what the rationale is for each
changeset.

It is my understanding that --annotate only shows the most
recent
changeset to touch a line; is that true?  I would like to
show my
viewers ALL the changesets that effect a particular verse.

In addition, I want to highlight the changes from each
changeset on a
word by word basis using a GNU wdiff algorithm.

Because each "verse" is on a line by itself,
typical patch format isn't
very useful for seeing the changes that were made in a
verse.   We
already know it changed; we want to see what changed.

If this sounds like something that darcs would support,
please let me
know.  I don't mind writing wrapper scripts or touching the
_darcs/
directory directly, but I'd prefer not to have to modify
darcs itself.

Ted

-- 
          It's not true unless it makes you laugh,         
                 
     but you don't understand it until it makes you weep.

Eukleia: Ted Walther
Address: 5690 Pioneer Ave, Burnaby, BC  V5H2X6 (Canada)
Contact: 604-430-4973

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

On 4/3/06, Ted Walther <kroogerdebian.org> wrote:
> Hello.  I'm starting up a project to correct the
translation of the King
> James Bible to better fit the underlying Hebrew
language, and release it
> under some free license, such as Creative Commons or
GFDL. Maybe dual
> license.

Can you copyright derivative works of your bible?  I'm not
a lawyer,
but I know derivative works tend to have rules at least here
in the
US.

> There will be only one (large) file in this project,
the plain text of
> the Bible itself.
>
> I want to not only keep a clear record of every change
I make and the
> reason for it, but I want to allow web browsers to
easily see the
> changes that were made to a particular verse, to see
what changesets
> altered that verse, and what the rationale is for each
changeset.

If that is the case, I'd recommend using a wiki instead of
version
control (depending on the wiki you can limit edit access). 
If you
really don't want to use a wiki then darcs is probably very
close to
ideal.

> It is my understanding that --annotate only shows the
most recent
> changeset to touch a line; is that true?  I would like
to show my
> viewers ALL the changesets that effect a particular
verse.

I think the various darcs web front ends do a better job of
annotation.  Specifically, darcs.cgi is probably close to
what you
want in that department.

> In addition, I want to highlight the changes from each
changeset on a
> word by word basis using a GNU wdiff algorithm.
>
> Because each "verse" is on a line by
itself, typical patch format isn't
> very useful for seeing the changes that were made in a
verse.   We
> already know it changed; we want to see what changed.

Hmm..I can't comment on this part.

HTH,
Jason

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

On Monday 03 April 2006 14:17, Jason Dagit wrote:
> On 4/3/06, Ted Walther <kroogerdebian.org> wrote:
> > Hello.  I'm starting up a project to correct the
translation of the King
> > James Bible to better fit the underlying Hebrew
language, and release it
> > under some free license, such as Creative Commons
or GFDL. Maybe dual
> > license.
>
> Can you copyright derivative works of your bible?  I'm
not a lawyer,
> but I know derivative works tend to have rules at least
here in the
> US.

The King James Bible, while almost insulting to bibles by
calling it a bible, 
is not copyrighted and is a public domain work. Remember, it
was translated 
about 200-300 years ago (maybe more?).

-- 
Patrick "Diablo-D3" McFarland || diablod3gmail.com
"Computer games don't affect kids; I mean if Pac-Man
affected us as kids,
we'd all be running around in darkened rooms, munching
magic pills and
listening to repetitive electronic music." -- Kristian
Wilson, Nintendo,
Inc, 1989


_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

On Mon, Apr 03, 2006 at 11:17:24AM -0700, Jason Dagit wrote:
>On 4/3/06, Ted Walther <kroogerdebian.org> wrote:
>> Hello.  I'm starting up a project to correct the
translation of the
>> King James Bible to better fit the underlying
Hebrew language, and
>> release it under some free license, such as
Creative Commons or GFDL.
>> Maybe dual license.
>
>Can you copyright derivative works of your bible?  I'm
not a lawyer,
>but I know derivative works tend to have rules at least
here in the US.

You can modify a public domain work and copyright it.  Heck,
they even
put page numbers on publicly available legislation and
copyright THAT.
(c.f. Westlaw)

>If that is the case, I'd recommend using a wiki instead
of version
>control (depending on the wiki you can limit edit
access).  If you
>really don't want to use a wiki then darcs is probably
very close to
>ideal.

My project is unique in that the number of lines shouldn't
change,
although to harmonize some things from the Septuagint some
verses may be
added, e.g. the last few verse of the book of Job.

Each line is prefixed with a verse reference, and a line may
change, but
will never be deleted.

>I think the various darcs web front ends do a better job
of annotation.
>Specifically, darcs.cgi is probably close to what you
want in that
>department.

So I can hack it up?  I'll need a listing of all changesets
that touch a
particular line.  And if I add lines, will that be tracked. 
Let's say I
want to view changes to Lk13:2, but I've added a couple
verses to Jb42;
will annotate follow that change backward?

Also, because I want to run GNU wdiff, how do I do that? 
Maybe I'll
have to write my own thing simple software for this simple
project.

Ted

-- 
          It's not true unless it makes you laugh,         
                 
     but you don't understand it until it makes you weep.

Eukleia: Ted Walther
Address: 5690 Pioneer Ave, Burnaby, BC  V5H2X6 (Canada)
Contact: 604-430-4973

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

Your best bet is probably using a modified WikiEngine.

On 4/3/06, Ted Walther <kroogerdebian.org> wrote:
> So I can hack it up?  I'll need a listing of all
changesets that touch a
> particular line.  And if I add lines, will that be
tracked.  Let's say I
> want to view changes to Lk13:2, but I've added a
couple verses to Jb42;
> will annotate follow that change backward?

It would be much easier in darcs if you kept each verse in
its own
seperate file, as darcs' change management tools of this
form (darcs
changes, darcs mv) are really at the file/directory level. 
This would
be a bit unusual perhaps, but you could create a very simple
script to
"cat" the entire work into that one monolithic
file you are seeking,
which becomes akin to the "compilation" stage of
a program, and that
you could even use ``darcs dist`` to run.  You could even
add the
verse notations in that script and avoid having it stored
redundantly
in the "source" files.

I'm not sure how happy you would be to work with such a
structure like
Luke\13\2.txt and Job\4\2.txt, though.

> Also, because I want to run GNU wdiff, how do I do
that?  Maybe I'll
> have to write my own thing simple software for this
simple project.

Right now darcs definitely does not support arbitrary
diff-based
patches (ie, patches for now will always be line-based).

``darcs diff``, for examing changes after the fact, could
use
alternate diff tools, but currently is hardwired to call
``diff``. 
You could override your path before calling darcs and and
use a
symlink diff -> wdiff.

--
--Max Battcher--
http://www.worldmaker.net/

All progress is based upon a universal innate desire on the
part of
every organism to live beyond its income. --Samuel Butler

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

On Mon, Apr 03, 2006 at 11:17:24AM -0700, Jason Dagit wrote:
>On 4/3/06, Ted Walther <kroogerdebian.org> wrote:
>> Hello.  I'm starting up a project to correct the
translation of the
>> King James Bible to better fit the underlying
Hebrew language, and
>> release it under some free license, such as
Creative Commons or GFDL.
>> Maybe dual license.
>
>Can you copyright derivative works of your bible?  I'm
not a lawyer,
>but I know derivative works tend to have rules at least
here in the US.

You can modify a public domain work and copyright it.  Heck,
they even
put page numbers on publicly available legislation and
copyright THAT.
(c.f. Westlaw)

>If that is the case, I'd recommend using a wiki instead
of version
>control (depending on the wiki you can limit edit
access).  If you
>really don't want to use a wiki then darcs is probably
very close to
>ideal.

My project is unique in that the number of lines shouldn't
change,
although to harmonize some things from the Septuagint some
verses may be
added, e.g. the last few verse of the book of Job.

Each line is prefixed with a verse reference, and a line may
change, but
will never be deleted.

>I think the various darcs web front ends do a better job
of annotation.
>Specifically, darcs.cgi is probably close to what you
want in that
>department.

So I can hack it up?  I'll need a listing of all changesets
that touch a
particular line.  And if I add lines, will that be tracked. 
Let's say I
want to view changes to Lk13:2, but I've added a couple
verses to Jb42;
will annotate follow that change backward?

Also, because I want to run GNU wdiff, how do I do that? 
Maybe I'll
have to write my own thing simple software for this simple
project.

Ted

-- 
          It's not true unless it makes you laugh,         
                 
     but you don't understand it until it makes you weep.

Eukleia: Ted Walther
Address: 5690 Pioneer Ave, Burnaby, BC  V5H2X6 (Canada)
Contact: 604-430-4973

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users

I don't think darcs can do a good job on your project.
Darcs
works for lines collected in files, not for words collected
in
lines. If each verse was a separate file as Max Battcher
suggested, and in addition each word was on a separate line,
darcs would however do a great job.

The problem with single line verses is that hunk patches
won't
commute. Each patch will completely replace the old line
with a
new one and therefore depend on the most previous line, so
cherry picking among patches on a single verse will not be
possible.

There is a wish item in the darcs bug tracker for user
supplied
filters that transform data before it enters or leaves
darcs.
Such filters could split verse files (if you verse willing
to
use one file per verse) up in one word per line as they are
fed
to darcs, and conversely join them back to single lines of
text
when they come out again. That would make the
one-word-per-line
invisible and transparent, but the output of 'darcs diff'
and
the contents of darcs patches would look, hm... different.
And
these filters are not implemented yet anyway.

Some sort of word based paragraph patch has also been
discussed,
but nothing has been implemented.


-- 
Tommy Pettersson <ptplysator.liu.se>

_______________________________________________
darcs-users mailing list
darcs-usersdarcs.net
http://www.abridgegame.org/mailman/listinfo/darcs-users