emacs-devel
[Top][All Lists]
Advanced

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

Re: Please help get ready for proofreading of Emacs manual


From: Richard Stallman
Subject: Re: Please help get ready for proofreading of Emacs manual
Date: Tue, 19 Sep 2017 15:33:22 -0400

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > The following parts may not all need to be proofread:


  > Part 32
  > The GNU Manifesto ..................................... 544

That's right.  This is unchanged.

  > Part 33
  > Glossary...............................................552

That one should be checked, if it has changed since Emacs 21.

  > Part 34
  > Key (Character) Index ................................... 575
  > Command and Function Index............................. 585

  > Part 35
  > Variable Index.......................................... 599
  > Concept Index.......................................... 607

The indices need to be checked in two special, simple ways:

* Looking for items that are too long (so they mess up the formatting).

* Looking for items that are effectively duplicates.
If they start with the same word and go to the same page,
usually one should be deleted (but not absolutely always).
Here's an artificial example:

  string constant ......................................42
  string ...............................................42

Also, multiple pages for the same topic might mean one should be
deleted, keeping the one that gives the full explanation of that
topic.

Also, there can be spelling errors in the index as anywhere else.



-- 
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.




reply via email to

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