Mercurial > emacs
changeset 103079:479179722385
(Tags): Clarify the text some more.
author | Eli Zaretskii <eliz@gnu.org> |
---|---|
date | Sun, 26 Apr 2009 19:01:24 +0000 |
parents | ffe7eb45a537 |
children | 9b4c664289a3 |
files | doc/emacs/maintaining.texi |
diffstat | 1 files changed, 11 insertions(+), 11 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/emacs/maintaining.texi Sun Apr 26 18:07:29 2009 +0000 +++ b/doc/emacs/maintaining.texi Sun Apr 26 19:01:24 2009 +0000 @@ -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 -@file{.fpp} source files. +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 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}. + To produce a tags table, you use the @samp{etags} command, +submitting it a document or the source code of a program. +@samp{etags} 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