Uttered "Paul W. Frields" <stickster(a)gmail.com>, spake thus:
I think the CVS log would be nice, but my understanding is that
it's
difficult to parse for this content.
I hacked together the attached shell script and ran it against the
current "release-notes/" document. It gave this output:
==[release-notes/rpm-Changelog]==
* Mon Oct 31 2005 04:48 bbbush <fedora-docs-list(a)redhat.com>
- RELEASE-NOTES-zh_CN.xml (1.1), daemons-zh_CN.xml (1.1),
- desktop-zh_CN.xml (1.1), development-tools-zh_CN.xml (1.1),
- entertainment-zh_CN.xml (1.1), feedback-zh_CN.xml (1.1),
- file-servers-zh_CN.xml (1.1), hardware-reqs-zh_CN.xml (1.1),
- i18n-zh_CN.xml (1.1), install-notes-zh_CN.xml (1.1), intro-zh_CN.xml
- (1.1), java-package-zh_CN.xml (1.1), kernel-zh_CN.xml (1.1),
- legacy-zh_CN.xml (1.1), misc-server-zh_CN.xml (1.1),
- multimedia-zh_CN.xml (1.1), networking-zh_CN.xml (1.1),
- overview-zh_CN.xml (1.1), package-movement-zh_CN.xml (1.1),
- package-notes-zh_CN.xml (1.1), printing-zh_CN.xml (1.1),
- project-overview-zh_CN.xml (1.1), samba-zh_CN.xml (1.1),
- security-zh_CN.xml (1.1), server-tools-zh_CN.xml (1.1),
- splash-zh_CN.xml (1.1), web-servers-zh_CN.xml (1.1), xorg-zh_CN.xml
- (1.1): Simplified Chinese translations of relnotes of fc5test1, of
- test and incomplete quality. Problems in package-notes-en.xml are
- translated AS-IS because of the freeze.
* Sat Oct 29 2005 21:36 Tommy Reynolds <Tommy.Reynolds(a)MegaCoder.com>
- Makefile (1.5): If the document directory has a "figs/" subdirectory,
- create an "figs/" subdirectory in the HTML output directory. Copy any
- ordinary files with a dot in their names to the newly-created
- "${DOCBASE}-${LANG}/figs/" subdirectory. To be copied, a graphics
- file must: 1) Have an extention that is NOT ".eps", since HTML
- doesn't grok EPS files. 2) Have a filename matching "*-${LANG}.*" --
- be a graphic for the selected language. 3) Have a filename that DOES
- NOT HAVE A DASH at all -- this allows for "language-independent"
- graphics.
* Sat Oct 29 2005 08:26 tsekine <fedora-docs-list(a)redhat.com>
- Makefile (1.4): fix the figs directory making rule so that 2 or more
- lauguages are able to be specified in LANGUAGES variable
* Tue Oct 25 2005 14:40 Karsten Wade <Karsten.Wade(a)RedHat.com>
- package-movement-en.xml (1.4), package-notes-en.xml (1.4) (utags:
- FC-5-TEST1-TRANS-FREEZE): Typos that broke the build, sorry, forgot
- to test the build before I did my last commits.
<snip>
In addition to the attached shell script, I propose adding an
"AUTHORS" file to each document. The example one I used above is:
==[release-notes/AUTHORS]==
########################################################################
# We use this AUTHORS file to map CVS checkin names to real names and
# email addresses.
########################################################################
# DEFAULT fedora-docs-list(a)redhat.com -
jtr Tommy.Reynolds(a)MegaCoder.com Tommy Reynolds
kwade Karsten.Wade(a)RedHat.com Karsten Wade
Now that I look at the voluminous output, I'm less sure that we want
the CVS log in the RPM. I think your current dummied-up %changelog
is perhaps more useful.
Cheers