[GRASS-dev] Grass Documentation How-to html page

[Maciej Sieczka]

Hamish wrote:
> Patton, Eric wrote:
>> Maciek had advised me to make diffs from the original description
>> html, because I had tried diffing a copy of a manpage somewhere in
>> /home, and he had problems applying it to CVS. (?) I'm not sure why it
>> didn't work, just following suggestions. I'll CC: him on this to see
>> why.

Eric,

I asked you for that, because if the diff header looks like this:

Index: description.html
===================================================================
RCS file:
/home/grass/grassrepository/grass6/vector/v.segment/description.html,v
retrieving revision 1.4
diff -u -r1.4 description.html
--- description.html	2 Jan 2006 14:44:52 -0000	1.4
+++ description.html	26 Sep 2006 19:03:32 -0000

	it is easy to apply to cvs, but if it is like:

--- description.html	2005-11-04 09:39:12.000000000 -0400
+++ v.out.ascii_improved.html	2006-08-29 12:04:27.000000000 -0300

it is not that easy, at least I can't (this might be the main problem
;)) without further manual editing.



There's got be something to it because
http://grass.itc.it/devel/index.php#submission reads:

"In general, please generate differences to the current CVS instead of
sending full files:
cvs diff -u [file.c] > grassdiff"

I realize it might be to cumbersome and discourage many eventuall
commiters, but on the other hand it is also necessary to keep applying
the changes into CVS simple. I'd love to have a compromise solution -
an easy way for creating documentation diffs, which will also be easy
to apply to cvs.

I'm a complete CVS noob and I don't have time to investigate that
further in the momment, so any thoughts are wellcome.

Best,
Maciek

P.S.
Eric, thanks for taking care of this. Your how-to will surely help many
folks to get involved!