From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.windows,gmane.emacs.help Subject: Re: Call for volunteers to check manual files Date: Tue, 08 Nov 2005 03:03:22 +0100 Message-ID: <4370076A.8010406@student.lu.se> References: <87hdanx5x0.fsf@stupidchicken.com> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: Quoted-Printable X-Trace: sea.gmane.org 1131415494 24433 80.91.229.2 (8 Nov 2005 02:04:54 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 8 Nov 2005 02:04:54 +0000 (UTC) Cc: help-gnu-emacs@gnu.org Original-X-From: help-emacs-windows-bounces+gnu-help-emacs-windows=m.gmane.org@gnu.org Tue Nov 08 03:04:49 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EZIqA-0005He-Th for gnu-help-emacs-windows@m.gmane.org; Tue, 08 Nov 2005 03:04:03 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EZIqA-0006Oq-EV for gnu-help-emacs-windows@m.gmane.org; Mon, 07 Nov 2005 21:04:02 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EZIpo-0006OS-1z for help-emacs-windows@gnu.org; Mon, 07 Nov 2005 21:03:40 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EZIpn-0006OF-Be for help-emacs-windows@gnu.org; Mon, 07 Nov 2005 21:03:39 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EZIpn-0006OC-8X; Mon, 07 Nov 2005 21:03:39 -0500 Original-Received: from [81.228.11.159] (helo=pne-smtpout2-sn1.fre.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EZIpi-0006FD-5n; Mon, 07 Nov 2005 21:03:39 -0500 Original-Received: from [192.168.123.121] (83.249.218.244) by pne-smtpout2-sn1.fre.skanova.net (7.2.060.1) id 436FB1AD0000D3AC; Tue, 8 Nov 2005 03:03:23 +0100 User-Agent: Mozilla Thunderbird 1.0.7 (Windows/20050923) X-Accept-Language: en-us, en Original-To: Chong Yidong , help-emacs-windows In-Reply-To: <87hdanx5x0.fsf@stupidchicken.com> X-BeenThere: help-emacs-windows@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussion forum for users of the GNU Emacs port to Windows List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-emacs-windows-bounces+gnu-help-emacs-windows=m.gmane.org@gnu.org Errors-To: help-emacs-windows-bounces+gnu-help-emacs-windows=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.windows:2878 gmane.emacs.help:30899 Archived-At: *** This is an important message so I add a bit for those using MS Window= s: If you are using MS Windows then you can get a precompiled version of=20 Emacs (or instructions for building on MS Windows), see=20 http://www.emacswiki.org/cgi-bin/wiki/CategoryWThirtyTwo. There are actually also lacking some MS Windows specific information in=20 the manuals currently. Chong Yidong wrote: >This is a call for volunteers to help check the manuals for the >upcoming Emacs 22 release. > >Before the Emacs developers can release Emacs 22, we need to check the >manuals for factual accuracy, especially the parts describing new >features. Any help that you can provide would be greatly appreciated. > >We need to keep track of how many people have checked different parts >of the manual. So, if you would like to help, please read and >*follow* these simple instructions: > >1. Download the development version of Emacs from CVS. Instructions > can be found at > > http://savannah.gnu.org/cvs/?group=3Demacs > >2. Build Emacs. See INSTALL.CVS, in the source tree, for > instructions; basically, > > $ ./configure > $ make bootstrap > >3. Read etc/NEWS (in the Emacs source tree) to find the changes made > to Emacs since version 21.4. > > This is a very long file, but try to read as much as you can. If > you can't digest it in one go, skim through it now and come back to > specific sections later, when you're checking the manuals. > >4. Visit admin/FOR-RELEASE, and find the list of Emacs manual files > that have not been checked. There are two manuals that need to be > checked: the Emacs Manual, and the Emacs Lisp Reference Manual. > Choose a file that has not been checked by at least two people. > (It is OK if you want to check the others, but the unchecked files > are more important.) > >5. Read the manual file. These are Texinfo files (*.texi), and can be > found in the directory man/ (for the Emacs Manual) or lispref/ (for > the Emacs Lisp Reference Manual.) You can also read the manuals > using Info-mode in the Emacs that you built. > > What you are looking for, IN ORDER OF IMPORTANCE, are > > * Wrong facts > * Unclear or misleading statements > * Spelling or grammar mistakes > > The main goal is to find wrong facts! It is OK to report other > types of mistakes, but don't let that detract from this purpose. > > Look out, in particular, for features that are new to Emacs 22. If > you are unsure if something is a mistake, go back and check in > etc/NEWS, or test it out on the Emacs that you built. > >6. Once you have checked the *the entire file*, send an email to > emacs-devel@gnu.org, stating > > * "I have checked [which file(s)]." > * What mistakes you found (if any). > > The best way to report mistakes is to comment the Texinfo file as > you are checking it, and send a patch at the end. For example, > when you find such a mistake: > > The commands @kbd{M-f} (@code{forward-word}) and @kbd{M-b} > (@code{forward-word}) move forward and backward over words. These > Meta characters are thus analogous to the corresponding control > > Add a comment to it like this: > > The commands @kbd{M-f} (@code{forward-word}) and @kbd{M-b} > (@code{forward-word}) move forward and backward over words. These > @c Should be backward-word. > Meta characters are thus analogous to the corresponding control > > At the end, run M-x diff and attach the patch to your report. > >Thanks for your time. >_______________________________________________ >Help-gnu-emacs mailing list >Help-gnu-emacs@gnu.org >http://lists.gnu.org/mailman/listinfo/help-gnu-emacs > =20 > --=20 Lennart fr=E5n Lund lennart.borgman.073@student.lu.se