Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
What's new
7
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Open sidebar
emacs
emacs
Commits
7be4f7c0
Commit
7be4f7c0
authored
Apr 26, 2009
by
Eli Zaretskii
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
(Tags): Clarify the text some more.
parent
e8025f0e
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
26 additions
and
26 deletions
+26
-26
doc/emacs/maintaining.texi
doc/emacs/maintaining.texi
+26
-26
No files found.
doc/emacs/maintaining.texi
View file @
7be4f7c0
...
...
@@ -1480,34 +1480,34 @@ Of course, you should substitute the proper years and copyright holder.
@section Tags Tables
@cindex tags and tag tables
A @dfn{tag} is a
named
subunit
of
a program or
of a document. In
program source code, tags
a
re syntactic elements
of the program:
functions, subroutines, data types, macros, etc. In a
document, tags
ar
e chapters, sections, appendices, etc.
A @dfn{tags table} records the names of the tags extracted from the
source code of a certain program or from a certain document. Each tag
is listed together with the file name on which it is defined, and th
e
position of the tag in that file
. Tags extracted from
generated files
reference the original file from which they were generated, rather
th
an the file from which these tags were
extract
ed
. 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.
T
ags tables are produced by scanning a document or the source code
of
a
program with a special
program
called
@samp{etags}
, and stored in
files called @dfn{tags table files}
. The conventional name for a tags
table
file is @file{TAGS}.
A @dfn{tag} is a
reference to a
subunit
in
a program or
in a
document. In
program source code, tags r
eferenc
e syntactic elements
of the program:
functions, subroutines, data types, macros, etc. In a
document, tags referenc
e chapters, sections, appendices, etc.
Each
tag specifies the file name on which 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
sourc
e
code
of
a
certain
program
or
a
certain
document
.
Tags
extracted
from
generated
files
reference
subunits
in
the
original
files
,
rather
than
th
e
generated
files
that
were
scanned
during
tag
extract
ion
.
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
.
T
o
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
}.
Emacs
uses
the
information
recorded
in
tags
tables
in
commands
that
search or replace through multiple files: these commands use
the names
of the source files recorded in the tags table to know which
files to
search. Other commands, such as @kbd{M-.}, which finds the
definition
of a function, use the recorded information about the
function names
and positions to find the source file and the position
within that
file where the function is defined.
search
or
replace
through
multiple
source
files
:
these
commands
use
the
names
of
the
source
files
recorded
in
the
tags
table
to
know
which
files
to
search
.
Other
commands
,
such
as
@
kbd
{
M
-.},
which
finds
the
definition
of
a
function
,
use
the
recorded
information
about
the
function
names
and
positions
to
find
the
source
file
and
the
position
within
that
file
where
the
function
is
defined
.
@
cindex
C
++
class
browser
,
tags
@
cindex
tags
,
C
++
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment