unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: Need better doc of compilation mode
Date: Sun, 10 Sep 2006 17:10:03 -0700	[thread overview]
Message-ID: <MEEKKIABFKKDFJMPIOEBGEOLDEAA.drew.adams@oracle.com> (raw)

1. I just discovered this feature (yes, I think it's a feature) by accident:
Click (mouse-2) a grep hit on the file name or line number, and the text
that matches the regexp is highlighted in the source buffer. Click instead
anywhere else on the grep hit and the whole line is highlighted in the
source buffer. Nice.

I see no documentation for this. The logical place to document it would be
in the Compilation Mode node of the Emacs manual.

2. Node Compilation Mode says that the source hit is only momentarily
highlighted. The word "momentarily" should be removed - that is just the
default behavior. It also says "You can change the behavior of this
highlighting with the variable `next-error-highlight'." It should instead
say that that variable determines whether and for how long the hit is
highlighted.

3. I filed a bug separately about the default highlight period
(`next-error-highligt') being ridiculously short - it is 0.1 sec, so short I
never even see the highlighting; it should be perhaps 10 or 30 seconds. I
personally think the default value should be `t', which just moves the
highlight each time you use `next-error'.

4. Node Grep Searching does not even say that what is said about
`compilation-mode' in node Compilation Mode applies also to grep. It should
say that buffer *grep* is in Grep mode, which has Compilation mode as a
parent mode. More importantly, it should contain a link to node Compilation
Mode, so readers can learn how to use Grep mode! We should never assume that
users read the manual linearly, front to back. If a user goes to the manual
looking for information on `grep', then s?he should be able to easily get to
all pertinent information about it.

             reply	other threads:[~2006-09-11  0:10 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-09-11  0:10 Drew Adams [this message]
2006-09-11  3:18 ` Need better doc of compilation mode Eli Zaretskii
2006-09-11 19:58 ` Richard Stallman
2006-09-11 20:13   ` Drew Adams
2006-09-17 15:30 ` Drew Adams

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=MEEKKIABFKKDFJMPIOEBGEOLDEAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    /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).