emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Inconsistent ChangeLog terminology in the Emacs manual.


From: Lute Kamstra
Subject: Inconsistent ChangeLog terminology in the Emacs manual.
Date: Fri, 01 Apr 2005 15:34:18 +0200
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)

The node Change Logs in the Emacs manual uses "entry" and "item"
inconsistently.  Maybe someone with a good idea of what things
_should_ be could correct that node?

Here are a few examples to illustrate the problem:

First an "entry" is defined a something starting with a
date-name-email header line and an "item" is defined as something
starting with a whitespace-star.  Then this example is shown:

     1993-05-25  Richard Stallman  <address@hidden>

             * man.el: Rename symbols `man-*' to `Man-*'.
             (manual-entry): Make prompt string clearer.

             * simple.el (blink-matching-paren-distance):
             Change default to 12,000.

     1993-05-24  Richard Stallman  <address@hidden>

             * vc.el (minor-mode-map-alist): Don't use it if it's void.
             (vc-cancel-version): Doc fix.

It is supposed to comprise "two entries, both dated in May 1993, each
with two items".  I count one item in the second entry.  A bit further
on, it is said that "the second entry above contains two items grouped
in this way", which also suggests a different definition of "item".

It is also said that "When the variable `add-log-keep-changes-together'
is non-`nil', `C-x 4 a' adds to any existing entry for the file rather
than starting a new entry."  Here, "entry" should probably be "item".

Lute.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]