* Please help check the Emacs 26 manual
@ 2017-11-27 23:30 Richard Stallman
0 siblings, 0 replies; 2+ messages in thread
From: Richard Stallman @ 2017-11-27 23:30 UTC (permalink / raw)
To: emacs-devel
[[[ 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 version of the 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.
^ permalink raw reply [flat|nested] 2+ messages in thread
* Please help check the Emacs 26 manual
@ 2017-12-13 23:04 Richard Stallman
0 siblings, 0 replies; 2+ messages in thread
From: Richard Stallman @ 2017-12-13 23:04 UTC (permalink / raw)
To: emacs-devel
[[[ 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-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.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2017-12-13 23:04 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-12-13 23:04 Please help check the Emacs 26 manual Richard Stallman
-- strict thread matches above, loose matches on Subject: below --
2017-11-27 23:30 Richard Stallman
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).