[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/emacs maintaining.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs/doc/emacs maintaining.texi |
Date: |
Sun, 26 Apr 2009 19:01:25 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Eli Zaretskii <eliz> 09/04/26 19:01:25
Modified files:
doc/emacs : maintaining.texi
Log message:
(Tags): Clarify the text some more.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/maintaining.texi?cvsroot=emacs&r1=1.19&r2=1.20
Patches:
Index: maintaining.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/emacs/maintaining.texi,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- maintaining.texi 26 Apr 2009 18:07:29 -0000 1.19
+++ maintaining.texi 26 Apr 2009 19:01:24 -0000 1.20
@@ -1484,22 +1484,22 @@
document. In program source code, tags reference syntactic elements
of the program: functions, subroutines, data types, macros, etc. In a
document, tags reference chapters, sections, appendices, etc. Each
-tag specifies the file name on which the corresponding subunit is
+tag specifies the name of the file where the corresponding subunit is
defined, and the position of the subunit's definition in that file.
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 subunits in 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
address@hidden source files.
-
- To produce tags tables, you use the @samp{etags} command, submitting
-it a document or the source code of a program. @samp{etags} writes
-the tags to files called @dfn{tags table files}, or @dfn{tags file} in
-short. The conventional name for a tags file is @file{TAGS}.
+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.
+
+ To produce a tags table, you use the @samp{etags} command,
+submitting it a document or the source code of a program.
address@hidden writes the tags to a @dfn{tags table file}, or @dfn{tags
+file} in short. The conventional name for a tags file is @file{TAGS}.
Emacs uses the information recorded in tags tables in commands that
search or replace through multiple source files: these commands use