help-gnu-emacs
[Top][All Lists]
Advanced

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

Please help check the Emacs 26 manual


From: Richard Stallman
Subject: Please help check the Emacs 26 manual
Date: Mon, 08 Jan 2018 21:52:57 -0500

[[[ 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. ]]]

Several chapters of the Emacs 26 manual have been checked, but many
more remain to be looked at.  Please help us by checking a few sections.


We are going to publish a new printed Emacs manual for Emacs 26.
Please help us make it error-free.

To participate, please pick a part to check (see the list below), and
write to emacs-manual-bugs@gnu.org saying which part you will check.
Then download the draft, available as source code and as a PDF file in
https://www.gnu.org/software/emacs/draft/manual/.

Please start checking the same day you volunteer, to avoid falling
into procrastination.  That doesn't mean you have to finish checking
the whole part the same day.

After checking one part, please volunteer to check another.
We aim to have each part checked by several different people.

You can report a flaw by sending mail to emacs-manual-bugs@gnu.org, or
to emacs-devel@gnu.org if you think the issue calls for discussion.
The Emacs developers will decide whether to make a change.

Please report problems the same day you detect them -- don't save them
up or batch them.  If the flaw is superficial and obvious, just
showing the sentence with the flaw is enough.  Otherwise, please also
state in a general way what kind of change you propose.

We would like to know about any and all sorts of flaws, including
spelling errors, punctuation errors, word usage errors, grammatical
errors, unclear wording, unfortunate choice of words, unfortunate
choice of examples, suboptimal ordering of points, technical
inaccuracies, and omission of points that belong in the manual.

If you check the PDF file, please also look for widows, orphans, and
lines that are too long.

Technical inaccuracies and omissions are the most important flaws.  To
help you notice them, please read quickly through
https://www.gnu.org/software/emacs/26-news-excerpts before you start
checking.

There is no need to try to remember the details of those excerpts.
Just looking at them will help you notice when the manual talks about
any of those features.  At that point you can check the manual against
the NEWS excerpts and see if they disagree.

Here is a list of parts.  Each part is described both by page numbers
and by section names, so you can find a part either in the PDF file or
in the source file.  You can do your checking on whichever form you
prefer.  Either one is enough; don't bother to check the same part two
ways.

The parts are short, so after you finish one, please do another.
Please do as many as you can -- we would like each part to be checked
by several people.  We encourage choosing parts randomly.


Part 1
Preface..................................................1
Distribution..............................................2
Introduction ............................................. 5
1       The Organization of the Screen .......................... 6

Part 2
2       Characters, Keys and Commands........................11
3       Entering and Exiting Emacs............................ 14
4       Basic Editing Commands .............................. 16

Part 3
5       The Minibuffer.......................................26
6       Running Commands by Name .......................... 36

Part 4
7       Help............................................... 38

Part 5
8       The Mark and the Region.............................. 47
9       Killing and Moving Text............................... 54

Part 6
10      Registers ........................................... 66

11      Controlling the Display
Part 7a Chapter Beginning - Font Lock mode..................... 71-82
Part 7b Interactive Highlighting - Chapter End ................ 82-93

12      Searching and Replacement
Part 8a Chapter Beginning - Regular Expression Search ........ 94-103
Part 8b Syntax of Regular Expressions - Chapter End .......... 103-117

Part 9
13      Commands for Fixing Typos...........................118
14      Keyboard Macros....................................124

15      File Handling
Part 10a Chapter Beginning - Saving Files .................. 132-143
Part 10b Reverting a Buffer - Chapter End .................. 143-156

Part 11
16      Using Multiple Buffers ............................... 157
17      Multiple Windows ................................... 166

Part 12
18      Frames and Graphical Displays ........................ 173

Part 13
19      International Character Set Support .................... 190 LONG

Part 14
20      Major and Minor Modes.............................. 212 SHORT
21      Indentation.........................................218

22      Commands for Human Languages
Part 15a Chapter Beginning - Outline Mode ................. 221 - 236
Part 15b TeX Mode - Chapter End ........................... 236 - 253

23      Editing Programs
Part 16a Chapter Beginning - Commands for editing w/ parentheses ... 254-263
Part 16b Manipulating Comments - Chapter End .............. 263-275

Part 17
24      Compiling and Testing Programs ....................... 276

25      Maintaining Large Programs
Part 18a Version Control ................................... 296-313
Part 18b Change Logs - Chapter End ......................... 313-326

Part 19
26      Abbrevs ........................................... 327 SHORT

Part 20
27      Dired, the Directory Editor............................333

Part 21
28      The Calendar and the Diary........................... 350

Part 22
29      Sending Mail ....................................... 369 SHORT

Part 23
30      Reading Mail with Rmail ............................. 378

31      Miscellaneous Commands
Part 24a Chapter Beginning - Running Shell Commands from Emacs ... 398-415
Part 24b Using Emacs as a Server - Chapter End ............. 415-431

Part 25
32      Emacs Lisp Packages................................. 432 SHORT

33      Customization
Part 26a Chapter Beginning - Variables ..................... 437-454
Part 26a Customizing Key Bindings - Chapter End ............ 454-468

Part 27
34      Dealing with Common Problems ....................... 469

Part 28
A       GNU GENERAL PUBLIC LICENSE ................... 487
B       GNU Free Documentation License...................... 498

Part 29
C       Command Line Arguments for Emacs Invocation.......... 506

Part 30
D       X Options and Resources ............................. 521
E       Emacs 25 Antinews .................................. 528

Part 31
F       Emacs and Mac OS / GNUstep ........................ 531
G       Emacs and Microsoft Windows/MS-DOS ................ 534

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

Special checking needed on these

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

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


-- 
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]