Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss

Please help check the Emacs 26 manual

7 views
Skip to first unread message

Richard Stallman

unread,
Dec 1, 2017, 8:46:21 PM12/1/17
to help-gn...@gnu.org
[[[ 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. ]]]

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-ma...@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-ma...@gnu.org, or
to emacs...@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.


Emanuel Berg

unread,
Dec 1, 2017, 10:03:27 PM12/1/17
to help-gn...@gnu.org
Richard Stallman wrote:

> We are going to publish a new printed Emacs
> manual for Emacs 26.

Wonderful! The only printed copy I own is
version 18 :)

If you send me a dozen or so copies, I'll make
sure they end up in every library and archive
I frequent, including those connected to the
university and other "official" establishments
and institutions.

Pepp pepp :)

--
underground experts united
http://user.it.uu.se/~embe8573


0 new messages