all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Please help check the Emacs 26 manual
@ 2017-11-27 23:30 Richard Stallman
  0 siblings, 0 replies; 7+ 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] 7+ messages in thread

* Please help check the Emacs 26 manual
@ 2017-12-02  0:07 Richard Stallman
  2017-12-02  3:03 ` Emanuel Berg
  0 siblings, 1 reply; 7+ messages in thread
From: Richard Stallman @ 2017-12-02  0:07 UTC (permalink / raw)
  To: help-gnu-emacs

[[[ 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] 7+ messages in thread

* Re: Please help check the Emacs 26 manual
  2017-12-02  0:07 Please help check the Emacs 26 manual Richard Stallman
@ 2017-12-02  3:03 ` Emanuel Berg
  0 siblings, 0 replies; 7+ messages in thread
From: Emanuel Berg @ 2017-12-02  3:03 UTC (permalink / raw)
  To: help-gnu-emacs

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




^ permalink raw reply	[flat|nested] 7+ messages in thread

* Please help check the Emacs 26 manual
@ 2017-12-13 23:04 Richard Stallman
  0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2017-12-13 23:04 UTC (permalink / raw)
  To: help-gnu-emacs

[[[ 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] 7+ messages in thread

* Please help check the Emacs 26 manual
@ 2017-12-13 23:04 Richard Stallman
  0 siblings, 0 replies; 7+ 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] 7+ messages in thread

* Please help check the Emacs 26 manual
@ 2018-01-09  2:52 Richard Stallman
  0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2018-01-09  2:52 UTC (permalink / raw)
  To: help-gnu-emacs

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




^ permalink raw reply	[flat|nested] 7+ messages in thread

* Please help check the Emacs 26 manual
@ 2018-01-22  2:14 Richard Stallman
  0 siblings, 0 replies; 7+ messages in thread
From: Richard Stallman @ 2018-01-22  2:14 UTC (permalink / raw)
  To: help-gnu-emacs

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




^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2018-01-22  2:14 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-12-02  0:07 Please help check the Emacs 26 manual Richard Stallman
2017-12-02  3:03 ` Emanuel Berg
  -- strict thread matches above, loose matches on Subject: below --
2018-01-22  2:14 Richard Stallman
2018-01-09  2:52 Richard Stallman
2017-12-13 23:04 Richard Stallman
2017-12-13 23:04 Richard Stallman
2017-11-27 23:30 Richard Stallman

Code repositories for project(s) associated with this external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.