[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-25 1562706: Minor copyedits of doc/emacs/maintaining
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-25 1562706: Minor copyedits of doc/emacs/maintaining.texi |
Date: |
Tue, 19 Jan 2016 17:32:10 +0000 |
branch: emacs-25
commit 156270697deb9895f381faf0de1a23cfb9b217d7
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Minor copyedits of doc/emacs/maintaining.texi
* doc/emacs/maintaining.texi (List Identifiers): More accurate
description of "C-M-i" wrt tags tables.
(Tags Tables): Move the definition of "tag" to a footnote.
---
doc/emacs/maintaining.texi | 33 +++++++++++++++++----------------
1 files changed, 17 insertions(+), 16 deletions(-)
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 989d8ff..90af5c8 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1990,8 +1990,8 @@ Searching}.
@table @kbd
@item C-M-i
@itemx address@hidden
-Perform completion on the text around point, using the selected tags
-table if one is loaded (@code{completion-at-point}).
+Perform completion on the text around point, possibly using the
+selected tags table if one is loaded (@code{completion-at-point}).
@item M-x xref-find-apropos @key{RET} @var{regexp} @key{RET}
Display a list of all known identifiers matching @var{regexp}.
@item M-x list-tags @key{RET} @var{file} @key{RET}
@@ -2004,9 +2004,10 @@ Visit files recorded in the selected tags table.
@cindex completion (symbol names)
In most programming language modes, you can type @kbd{C-M-i} or
@address@hidden (@code{completion-at-point}) to complete the symbol
-at point. If there is a tags table loaded, this command can use it to
-generate completion candidates more intelligently. @xref{Symbol
-Completion}.
+at point. Some modes provide specialized completion for this command
+tailored to the mode; for those that don't, if there is a tags table
+loaded, this command can use it to generate completion candidates.
address@hidden Completion}.
@findex list-tags
@kbd{M-x list-tags} reads the name of one of the files covered by
@@ -2047,17 +2048,17 @@ file. This command requires a tags table to be
selected.
@subsection Tags Tables
@cindex tags and tag tables
address@hidden tag
- A @dfn{tag} is a synonym for identifier reference. @xref{Xref}.
-
- A @dfn{tags table} records the tags extracted by scanning the source
-code of a certain program or a certain document. Tags extracted from
-generated files reference the original files, rather than the
-generated files that were scanned during tag extraction. Examples of
-generated files include C files generated from Cweb source files, from
-a Yacc parser, or from Lex scanner definitions; @file{.i} preprocessed
-C files; and Fortran files produced by preprocessing @file{.fpp}
-source files.
+ A @dfn{tags table} records the address@hidden
+A @dfn{tag} is a synonym for identifier reference. Commands and
+features based on the @code{etags} package traditionally use ``tag''
+with this meaning, and this subsection follows that tradition.
+} extracted by scanning the source code of a certain program or a
+certain document. Tags extracted from generated files reference the
+original files, rather than the generated files that were scanned
+during tag extraction. Examples of generated files include C files
+generated from Cweb source files, from a Yacc parser, or from Lex
+scanner definitions; @file{.i} preprocessed C files; and Fortran files
+produced by preprocessing @file{.fpp} source files.
@cindex etags
To produce a tags table, you run the @command{etags} shell command
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-25 1562706: Minor copyedits of doc/emacs/maintaining.texi,
Eli Zaretskii <=