changelog vs ChangeLog and policy dictates
I am not on the policy mailing list, so please cc me on this thread.
On Wed, 8 Apr 1998, Juan Cespedes wrote:
> On Mon, Mar 30, 1998 at 09:11:30AM -0500, Dale Scheetz wrote:
> >
> > Changelogs are to inform the user of "recent" changes to the programs in
> > the package. The current changelog so provided includes all but changlog.6
> > which is information that is a year old. I see no reason to clutter up the
> > docs with ancient information.
>
> OK. Many people wouldn't like a lot of disk space wasted in
> changelogs they will never use.
>
> But: According to the Debian Policy 2.4.0.0, section 5.8, the
> upstream changelog file should be installed in
> /usr/doc/<package>/changelog.gz, and not ChangeLog.gz.
>
> Please rename that file in the next release.
>
I have done as Juan has asked, but I am uncomfortable with the change for
several reasons.
Does/Should the policy manual detail which letters may, or may not, be
upper or lower case?
Is such a "violation" of policy a bug that should get higher severity than
wishlist?
In defense of violating this policy:
Upper/Lower case lettering does not confuse the average reader.
The upstream source uses the ChangeLog style in the original source.
The rules file moves several files into the doc directory with a for loop
against a name list. This one file must now be dealt with in a seperate
cp -a line, which is ugly. (sorry, I couldn't think of another word)
There are several other components of this package that also supply
changelogs of the form ChangeLog.<addon>. Are these files also in
violation of policy? This is a lot of "mucking around" for what looks to
me to be very little gain.
I find the typology of ChangeLog much easier to read than changelog. They
parse the same for me, and it is the fact that they don't parse the same
for *nix systems that allows them to be of such value, even in this small
case.
Advice?
Dwarf
--
_-_-_-_-_- Author of "The Debian Linux User's Guide" _-_-_-_-_-_-
aka Dale Scheetz Phone: 1 (850) 656-9769
Flexible Software 11000 McCrackin Road
e-mail: dwarf@polaris.net Tallahassee, FL 32308
_-_-_-_-_-_- If you don't see what you want, just ask _-_-_-_-_-_-_-
--
To UNSUBSCRIBE, email to debian-policy-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: