From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: faq.texi Date: Thu, 09 Feb 2006 19:43:29 +0200 Organization: JURTA Message-ID: <87pslwo2f3.fsf@jurta.org> References: <878xstfkz2.fsf@pacem.orebokech.com> <87d5i23qek.fsf@pacem.orebokech.com> <87psm0n9x9.fsf@pacem.orebokech.com> <87lkwnkmcb.fsf@pacem.orebokech.com> <87vevpcxr6.fsf@pacem.orebokech.com> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1139517293 9518 80.91.229.2 (9 Feb 2006 20:34:53 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 9 Feb 2006 20:34:53 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Feb 09 21:34:48 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1F7IUK-0006G3-HD for ged-emacs-devel@m.gmane.org; Thu, 09 Feb 2006 21:34:00 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F7IUJ-0000jS-Ns for ged-emacs-devel@m.gmane.org; Thu, 09 Feb 2006 15:33:59 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1F7Fry-0000la-Dn for emacs-devel@gnu.org; Thu, 09 Feb 2006 12:46:14 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1F7Frw-0000kV-9u for emacs-devel@gnu.org; Thu, 09 Feb 2006 12:46:12 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F7Fru-0000jk-Ub for emacs-devel@gnu.org; Thu, 09 Feb 2006 12:46:11 -0500 Original-Received: from [194.126.101.111] (helo=mail.neti.ee) by monty-python.gnu.org with esmtp (Exim 4.52) id 1F7FvV-00020f-8z for emacs-devel@gnu.org; Thu, 09 Feb 2006 12:49:53 -0500 Original-Received: from mail.neti.ee (80-235-37-98-dsl.mus.estpak.ee [80.235.37.98]) by Relayhost2.neti.ee (Postfix) with ESMTP id 6CA367F1F; Thu, 9 Feb 2006 19:46:09 +0200 (EET) Original-To: Romain Francoise In-Reply-To: <87vevpcxr6.fsf@pacem.orebokech.com> (Romain Francoise's message of "Wed, 08 Feb 2006 23:05:17 +0100") User-Agent: Gnus/5.110004 (No Gnus v0.4) Emacs/22.0.50 (gnu/linux) X-Virus-Scanned: by amavisd-new-2.2.1 (20041222) (Debian) at neti.ee X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:50251 Archived-At: > Okay. The manual is very clear about this, but I've added an entry to > the FAQ about it nonetheless, pointing people to the relevant node in > the manual. Actually there is already a special node in FAQ that describes how to use C-q C-j to match newlines: (info "(efaq)Working with unprintable characters") with the title: 5.10 How do I search for, delete, or replace unprintable (eight-bit or control) characters? So the new node `Searching for/replacing newlines' duplicates it. BTW, the node `Working with unprintable characters' says: * You don't need to quote with either isearch or typing something in the minibuffer. But I think it's better to suggest to always quote because in the minibuffer its behavior depends on `indent-tabs-mode', and in isearch mode it is bound to completion. I also looked briefly at other parts of the FAQ and noticed other inaccuracies and omissions: 1. The Top node says: If you find any errors, or have any suggestions, please use `M-x report-emacs-bug' to report them. This is correct, but the node (info "(efaq)Reporting bugs") doesn't mention `M-x report-emacs-bug' at all, and has no xref to (info "(emacs)Bugs"). 2. A xref from (info "(efaq)Highlighting a region") to (info "(efaq)Turning on syntax highlighting") seems inappropriate to me. Region highlighting and syntax highlighting are different things. 3. The node (info "(efaq)Replacing highlighted text") could be placed just after (info "(efaq)Highlighting a region") in the menu. 4. I propose to merge nodes (info "(efaq)Turning on auto-fill by default") and (info "(efaq)Wrapping words automatically"). And also to merge nodes (info "(efaq)Repeating commands") and (info "(efaq)Repeating a command as many times as possible") 5. I think (info "(efaq)Horizontal scrolling") should mention `truncate-partial-width-windows'. 6. (info "(efaq)Forcing the cursor to remain in the same column") should mention `track-eol', `C-x C-n' and `C-u C-x C-n' and have a xref to (info "(emacs)Moving Point"). 7. (info "(efaq)Inserting text at the beginning of each line") could have a xref to (info "(efaq)Changing the included text prefix"). 8. The node (info "(efaq)Newsgroup archives") could also contain a link to `http://gmane.org/'. And the node (info "(efaq)Packages that do not come with Emacs") could have a reference to the file `etc/MORE.STUFF'. -- Juri Linkov http://www.jurta.org/emacs/