From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Please help check the Emacs 26 manual Date: Wed, 13 Dec 2017 18:04:24 -0500 Message-ID: Reply-To: rms@gnu.org NNTP-Posting-Host: blaine.gmane.org Content-Type: text/plain; charset=Utf-8 X-Trace: blaine.gmane.org 1513206331 20858 195.159.176.226 (13 Dec 2017 23:05:31 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 13 Dec 2017 23:05:31 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 14 00:05:27 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ePG5d-0005BI-UI for ged-emacs-devel@m.gmane.org; Thu, 14 Dec 2017 00:05:26 +0100 Original-Received: from localhost ([::1]:38168 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ePG5l-0001Sd-7X for ged-emacs-devel@m.gmane.org; Wed, 13 Dec 2017 18:05:33 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53077) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ePG4h-00019l-FI for emacs-devel@gnu.org; Wed, 13 Dec 2017 18:04:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ePG4f-0007zK-Pc for emacs-devel@gnu.org; Wed, 13 Dec 2017 18:04:27 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44652) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ePG4f-0007z3-MT for emacs-devel@gnu.org; Wed, 13 Dec 2017 18:04:25 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1ePG4e-0000Tk-Ln; Wed, 13 Dec 2017 18:04:24 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:221035 Archived-At: [[[ 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.