unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Inconsistent ChangeLog terminology in the Emacs manual.
@ 2005-04-01 13:34 Lute Kamstra
  0 siblings, 0 replies; only message in thread
From: Lute Kamstra @ 2005-04-01 13:34 UTC (permalink / raw)


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  <rms@gnu.org>

             * 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  <rms@gnu.org>

             * 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.

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2005-04-01 13:34 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-04-01 13:34 Inconsistent ChangeLog terminology in the Emacs manual Lute Kamstra

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).