Re: who needs script `update-patch-version`?

[Werner LEMBERG]

>>Unfortunately, this is next to impossible since there are so many
>>changes.  I will provide a PDF that holds the changed pages so that
>>you and others can simply read what's written there, comparing it
>>with the current version of the Contributor guide if necessary.
>
> It was this condition (to provide small incremental changes) that
> made me abandon editing the docs many years ago.  At the time I was
> part-way through a major reorganisation of 2.1 Vocal Music which I
> had to abandon as it was simply impossible to do it incrementally.
> Since then the docs have virtually stagnated.  Hope you're able to
> work this out better than I was able to do, Werner.

Well, I revise the stuff, I don't rewrite it, so it's definitely
easier, I guess.  The main thing is that these extra steps take a
significant amount of time, which I think are not really justified for
documentation changes (in contrast to code changes) and could be
invested into more useful things.  In particular, for what I'm going
to do, the command

  git diff --word-diff-regex=. --word-diff=color ...

makes it almost trivial to see the changes, as shown in the attachment
that holds the very first differences (you should use `less` or
something similar to view it, ideally using a black background).


    Werner

zzz.diff.color
Description: Binary data