From: Juri Linkov <juri@jurta.org>
Subject: Re: Grep Searching node in building.texi
Date: Wed, 10 Aug 2005 07:05:29 +0300 [thread overview]
Message-ID: <87br46zhlq.fsf@jurta.org> (raw)
In-Reply-To: <874qa6xv68.fsf@jurta.org> (Juri Linkov's message of "Thu, 04 Aug 2005 05:14:03 +0300")
> 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/
prev parent reply other threads:[~2005-08-10 4:05 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2005-08-04 2:14 Grep Searching node in building.texi Juri Linkov
2005-08-10 4:05 ` Juri Linkov [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87br46zhlq.fsf@jurta.org \
--to=juri@jurta.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).