From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: Emacs-diffs Digest, Vol 6, Issue 5 Date: Sat, 03 May 2003 11:15:16 +0300 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <8011-Sat03May2003111515+0300-eliz@elta.co.il> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1051950230 5243 80.91.224.249 (3 May 2003 08:23:50 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 3 May 2003 08:23:50 +0000 (UTC) Cc: Glenn Morris Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 03 10:23:48 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19BsJA-0001MN-00 for ; Sat, 03 May 2003 10:23:48 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 19BsL7-0005zm-00 for ; Sat, 03 May 2003 10:25:49 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19BsFb-00080U-05 for emacs-devel@quimby.gnus.org; Sat, 03 May 2003 04:20:07 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 19BsF6-0007Ve-00 for emacs-devel@gnu.org; Sat, 03 May 2003 04:19:36 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 19BsEu-0006t4-00 for emacs-devel@gnu.org; Sat, 03 May 2003 04:19:30 -0400 Original-Received: from bilbo.inter.net.il ([192.114.186.18]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 19BsE6-0005NW-00 for emacs-devel@gnu.org; Sat, 03 May 2003 04:18:35 -0400 Original-Received: from zaretsky (cable-128-43.inter.net.il [213.8.128.43]) by bilbo.inter.net.il (Mirapoint Messaging Server MOS 3.2.2-GA) with ESMTP id ANQ84225; Sat, 3 May 2003 11:18:32 +0300 (IDT) Original-To: emacs-devel@gnu.org X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: (emacs-diffs-request@gnu.org) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:13641 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:13641 Glenn, I have a few comments regarding the last changes in the FAQ. > + Sometimes users are unsure as to where their @file{.emacs} file should > + be found. Visiting the file as @file{~/.emacs} from Emacs will find > + the correct file. I think every useful piece of information in the FAQ should be indexed. A FAQ, even more than a manual, is a large collection of small pieces of information, so it is practically impossible to quickly get to the info one is looking for without that info being indexed. The above snippet should certainly have an index entry, IMHO. > + The version available from @uref{http://meltin.net/hacks/emacs/} is > + more recent, and has been tested under Emacs 21.2. I think "under Emacs" sounds awkward. "has been tested with Emacs 21.2" is better, in my opinion. > ! The Emacs Lisp List (ELL), > ! @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.html}, maintained by I think it's better to use @uref with 2 arguments here, like this: @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.html, The Emacs Lisp List (ELL)}, maintained by The results will look better in HTML, for example. > ! internet. The ELL can be browsed over the web, or from Emacs using the > ! @file{ell} package, @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.el}. Same here: make "@file{ell} package" be part of @uref. > ! Many authors post their packages to the newsgroup > ! @uref{news:gnu.emacs.sources}. And here. I'd rewrite this as Many authors post their packages to the @uref{news:gnu.emacs.sources, Emacs sources news group}. There are more such instances in the changes; I think almost all of them should be revised as above. > ! For a long time, the Emacs Lisp Archive provided a central repository > ! for Emacs packages. Sadly, it has not been active for some time, > ! although you can still access the old files at This should probably have an index entry, about the archive being unmaintained. > ! * AUC-TeX:: > * BBDB:: > * Ispell:: > * w3-mode:: > --- 3874,3880 ---- > * Supercite:: > * Calc:: > * VIPER:: > ! * AUCTeX:: Isn't "AUC-TeX" the official spelling of the package, as Per wants it? Last, but not least, thanks for working on these changes!