From unknown Mon Aug 18 17:58:15 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#3101: 23.0.92; Emacs manual, node Tags Reply-To: "Drew Adams" , 3101@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 24 Apr 2009 20:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 3101 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124060540417323 (code B ref -1); Fri, 24 Apr 2009 20:45:02 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 24 Apr 2009 20:36:44 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.1 required=4.0 tests=FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3OKaecx017316 for ; Fri, 24 Apr 2009 13:36:42 -0700 Received: from mx10.gnu.org ([199.232.76.166]:33583) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1LxS8W-0002RT-9v for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:40 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1LxS8U-0000Y4-Di for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:39 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:28941) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LxS8T-0000XJ-Ro for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:38 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n3OKabfr004280 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 24 Apr 2009 20:36:39 GMT Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n3OKaY3Z007222 for ; Fri, 24 Apr 2009 20:36:35 GMT Received: from dradamslap1 (/98.210.250.59) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 24 Apr 2009 13:36:31 -0700 From: "Drew Adams" To: Date: Fri, 24 Apr 2009 13:36:31 -0700 Message-ID: <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 thread-index: AcnFHFnAuMj4HXmHR3enNlA/LJiJYw== X-Source-IP: acsinet15.oracle.com [141.146.126.227] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010204.49F222D3.0046:SCFMA922111,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) 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)' From unknown Mon Aug 18 17:58:15 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: "Drew Adams" Subject: bug#3101 closed by Eli Zaretskii (Re: bug#3101: 23.0.92; Emacs manual, node Tags) Message-ID: References: <83skjxfb7t.fsf@gnu.org> <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> X-Emacs-PR-Message: they-closed 3101 X-Emacs-PR-Package: emacs Reply-To: 3101@debbugs.gnu.org Date: Sat, 25 Apr 2009 07:30:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1240644605-7195-1" This is a multi-part message in MIME format... ------------=_1240644605-7195-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" 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 . 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 by replying to this email. --=20 3101: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D3101 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1240644605-7195-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 3101-done) by emacsbugs.donarmstrong.com; 25 Apr 2009 07:23:43 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-3.0 required=4.0 tests=HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from mtaout5.012.net.il (mtaout5.012.net.il [84.95.2.13]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3P7NcbR005859 for <3101-done@emacsbugs.donarmstrong.com>; Sat, 25 Apr 2009 00:23:40 -0700 Received: from conversion-daemon.i_mtaout5.012.net.il by i_mtaout5.012.net.il (HyperSendmail v2004.12) id <0KIN00B00B4PEC00@i_mtaout5.012.net.il> for 3101-done@emacsbugs.donarmstrong.com; Sat, 25 Apr 2009 10:23:32 +0300 (IDT) Received: from HOME-C4E4A596F7 ([77.127.175.232]) by i_mtaout5.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KIN00DN8B78QNN4@i_mtaout5.012.net.il>; Sat, 25 Apr 2009 10:23:32 +0300 (IDT) Date: Sat, 25 Apr 2009 10:23:34 +0300 From: Eli Zaretskii Subject: Re: bug#3101: 23.0.92; Emacs manual, node Tags In-reply-to: <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> X-012-Sender: halo1@inter.net.il To: Drew Adams , 3101-done@debbugs.gnu.org Reply-to: Eli Zaretskii Message-id: <83skjxfb7t.fsf@gnu.org> References: <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> > From: "Drew Adams" > 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? ------------=_1240644605-7195-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 24 Apr 2009 20:36:44 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.1 required=4.0 tests=FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3OKaecx017316 for ; Fri, 24 Apr 2009 13:36:42 -0700 Received: from mx10.gnu.org ([199.232.76.166]:33583) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1LxS8W-0002RT-9v for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:40 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1LxS8U-0000Y4-Di for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:39 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:28941) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LxS8T-0000XJ-Ro for emacs-pretest-bug@gnu.org; Fri, 24 Apr 2009 16:36:38 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n3OKabfr004280 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 24 Apr 2009 20:36:39 GMT Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n3OKaY3Z007222 for ; Fri, 24 Apr 2009 20:36:35 GMT Received: from dradamslap1 (/98.210.250.59) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 24 Apr 2009 13:36:31 -0700 From: "Drew Adams" To: Subject: 23.0.92; Emacs manual, node Tags Date: Fri, 24 Apr 2009 13:36:31 -0700 Message-ID: <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 thread-index: AcnFHFnAuMj4HXmHR3enNlA/LJiJYw== X-Source-IP: acsinet15.oracle.com [141.146.126.227] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010204.49F222D3.0046:SCFMA922111,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) 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)' ------------=_1240644605-7195-1--