RFC: RPM Changelog thoughts

[Tommy Reynolds]

Uttered "Paul W. Frields" <stickster at 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 at 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 at 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 at 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 at 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 at redhat.com		-
jtr	Tommy.Reynolds at MegaCoder.com		Tommy Reynolds
kwade	Karsten.Wade at 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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: rpm-changelog
Type: application/octet-stream
Size: 1689 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20051031/81b9c701/attachment.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20051031/81b9c701/attachment.sig>