GNU bug report logs -
#3101
23.0.92; Emacs manual, node Tags
Previous Next
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
This is an automatic notification regarding your bug report
which was filed against the emacs package:
#3101: 23.0.92; Emacs manual, node Tags
It has been closed by Eli Zaretskii <eliz <at> gnu.org>.
Their explanation is attached below along with your original report.
If this explanation is unsatisfactory and you have not received a
better one in a separate message then please contact Eli Zaretskii <eliz <at> gnu.org> by
replying to this email.
--
3101: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3101
Emacs Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
> From: "Drew Adams" <drew.adams <at> oracle.com>
> Date: Fri, 24 Apr 2009 13:36:31 -0700
> Cc:
>
> The first sentence of this node doesn't sound right to me. At least
> it's not clear what is meant.
>
> "A "tags table" is a description of how a multi-file
> program is broken up into files."
>
> A multi-file program? What program would that be? There is no further
> mention of this. I don't understand this sentence, and I cannot
> imagine how it describes what a tags table is.
I changed this to
A @dfn{tags table} is a description of how program's sources are
broken up into individual source files.
I hope this is more clear.
> Also confusing is the part that starts "When a file parsed by `etags'
> is generated from a different source file, like a C file generated
> from a Cweb source file,..." To understand this (and I don't), a
> reader needs to already understand what `etags' is and what its
> parsing amounts to, and s?he needs to know what Cweb is (I don't). Not
> to mention that it is mysterious what is meant by "a different source
> file" - different from what?
The text reads now
Each entry in the tags table records the name of a tag, the name of
the file that the tag is defined in (implicitly), and the position in
that file of the tag's definition. If the file is a generated file,
its tags reference the originating source file. Examples of generated
files include C files generated from Cweb source files or from a Yacc
parser or Lex scanner definitions, @file{.i} preprocessed C files, and
Fortran files produced by preprocessing @file{.fpp} source files.
OK?
[Message part 3 (message/rfc822, inline)]
The first sentence of this node doesn't sound right to me. At least
it's not clear what is meant.
"A "tags table" is a description of how a multi-file
program is broken up into files."
A multi-file program? What program would that be? There is no further
mention of this. I don't understand this sentence, and I cannot
imagine how it describes what a tags table is.
Also confusing is the part that starts "When a file parsed by `etags'
is generated from a different source file, like a C file generated
from a Cweb source file,..." To understand this (and I don't), a
reader needs to already understand what `etags' is and what its
parsing amounts to, and s?he needs to know what Cweb is (I don't). Not
to mention that it is mysterious what is meant by "a different source
file" - different from what?
One cannot understand this text without knowing how tags work, the
role of "source files" in that, and so on. IOW, this doesn't help; it
confuses.
In GNU Emacs 23.0.92.1 (i386-mingw-nt5.1.2600)
of 2009-03-30 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
This bug report was last modified 16 years and 107 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.