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: Grep Searching node in building.texi Date: Wed, 10 Aug 2005 07:05:29 +0300 Organization: JURTA Message-ID: <87br46zhlq.fsf@jurta.org> References: <874qa6xv68.fsf@jurta.org> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1123648346 23007 80.91.229.2 (10 Aug 2005 04:32:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 10 Aug 2005 04:32:26 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Aug 10 06:32:24 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1E2iEW-0002wz-6X for ged-emacs-devel@m.gmane.org; Wed, 10 Aug 2005 06:30:28 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E2iHb-0002XS-Vn for ged-emacs-devel@m.gmane.org; Wed, 10 Aug 2005 00:33:40 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1E2iEH-0000se-5k for emacs-devel@gnu.org; Wed, 10 Aug 2005 00:30:13 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1E2iE6-0000nN-Vw for emacs-devel@gnu.org; Wed, 10 Aug 2005 00:30:04 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E2iE4-0000hS-QL for emacs-devel@gnu.org; Wed, 10 Aug 2005 00:30:00 -0400 Original-Received: from [194.126.101.111] (helo=mail.neti.ee) by monty-python.gnu.org with esmtp (Exim 4.34) id 1E2i8q-0003Xm-Lu for emacs-devel@gnu.org; Wed, 10 Aug 2005 00:24:37 -0400 Original-Received: from mail.neti.ee (80-235-36-237-dsl.mus.estpak.ee [80.235.36.237]) by Relayhost1.neti.ee (Postfix) with ESMTP id 5B1571ED9 for ; Wed, 10 Aug 2005 07:10:10 +0300 (EEST) Original-To: emacs-devel@gnu.org In-Reply-To: <874qa6xv68.fsf@jurta.org> (Juri Linkov's message of "Thu, 04 Aug 2005 05:14:03 +0300") 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:41844 > I checked the node `Grep Searching' and want to propose the following > corrections. I think mentioning the `-nH' option is essential > (and also I find the phrase `where there were' too clumsy). Grep commands are described in the node `Grep Searching' but their headings currently are located in the node `Compilation'. This diverges from the documentation standard where nodes start with headings containing a command name and short description, and the rest of the node provides more complete description. Even though grep-mode is based on compilation-mode, this fact is already mentioned in the beginning of `Grep Searching', and any mention of grep in the node `Compilation' is irrelevant. Index: man/building.texi =================================================================== RCS file: /cvsroot/emacs/emacs/man/building.texi,v retrieving revision 1.66 diff -c -r1.66 building.texi *** man/building.texi 9 Aug 2005 21:48:12 -0000 1.66 --- man/building.texi 10 Aug 2005 00:32:32 -0000 *************** *** 48,63 **** @item M-x recompile Invoke a compiler with the same command as in the last invocation of @kbd{M-x compile}. - @item M-x grep - Run @code{grep} asynchronously under Emacs, with matching lines - listed in the buffer named @samp{*grep*}. - @item M-x grep-find - @itemx M-x find-grep - Run @code{grep} via @code{find}, with user-specified arguments, and - collect output in the buffer named @samp{*grep*}. @item M-x kill-compilation ! @itemx M-x kill-grep ! Kill the running compilation or @code{grep} subprocess. @end table @findex compile --- 48,55 ---- @item M-x recompile Invoke a compiler with the same command as in the last invocation of @kbd{M-x compile}. @item M-x kill-compilation ! Kill the running compilation subprocess. @end table @findex compile *************** *** 323,335 **** @node Grep Searching @section Searching with Grep under Emacs - @findex grep Just as you can run a compiler from Emacs and then visit the lines with compilation errors, you can also run @code{grep} and then visit the lines on which matches were found. This works by treating the matches reported by @code{grep} as if they were ``errors.'' ! To do this, type @kbd{M-x grep}, then enter a command line that specifies how to run @code{grep}. Use the same arguments you would give @code{grep} when running it normally: a @code{grep}-style regexp (usually in single-quotes to quote the shell's special characters) --- 315,339 ---- @node Grep Searching @section Searching with Grep under Emacs Just as you can run a compiler from Emacs and then visit the lines with compilation errors, you can also run @code{grep} and then visit the lines on which matches were found. This works by treating the matches reported by @code{grep} as if they were ``errors.'' ! @table @kbd ! @item M-x grep ! Run @code{grep} asynchronously under Emacs, with matching lines ! listed in the buffer named @samp{*grep*}. ! @item M-x grep-find ! @itemx M-x find-grep ! Run @code{grep} via @code{find}, with user-specified arguments, and ! collect output in the buffer named @samp{*grep*}. ! @item M-x kill-grep ! Kill the running @code{grep} subprocess. ! @end table ! ! @findex grep ! To run @code{grep}, type @kbd{M-x grep}, then enter a command line that specifies how to run @code{grep}. Use the same arguments you would give @code{grep} when running it normally: a @code{grep}-style regexp (usually in single-quotes to quote the shell's special characters) -- Juri Linkov http://www.jurta.org/emacs/