From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: owner@emacsbugs.donarmstrong.com (Emacs bug Tracking System) Newsgroups: gmane.emacs.bugs Subject: bug#3101: marked as done (23.0.92; Emacs manual, node Tags) Date: Sat, 25 Apr 2009 07:30:05 +0000 Message-ID: References: <83skjxfb7t.fsf@gnu.org> <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----------=_1240644605-7195-0" X-Trace: ger.gmane.org 1240644756 28368 80.91.229.12 (25 Apr 2009 07:32:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 25 Apr 2009 07:32:36 +0000 (UTC) To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 25 09:33:55 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LxcOK-0004Ti-Pr for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2009 09:33:50 +0200 Original-Received: from localhost ([127.0.0.1]:60253 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LxcMv-0001YV-0q for geb-bug-gnu-emacs@m.gmane.org; Sat, 25 Apr 2009 03:32:13 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LxcMq-0001YQ-Ew for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2009 03:32:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LxcMl-0001YE-T7 for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2009 03:32:07 -0400 Original-Received: from [199.232.76.173] (port=52354 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LxcMl-0001YB-Ni for bug-gnu-emacs@gnu.org; Sat, 25 Apr 2009 03:32:03 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:44870) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LxcMi-0007UF-2I; Sat, 25 Apr 2009 03:32:00 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LxcMf-0004Qc-Dw; Sat, 25 Apr 2009 03:31:57 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3P7VolL008358; Sat, 25 Apr 2009 00:31:50 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n3P7U5Ox007213; Sat, 25 Apr 2009 00:30:05 -0700 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: closed 3101 X-Emacs-PR-Package: emacs X-detected-kernel: by mx20.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:27445 Archived-At: This is a multi-part message in MIME format... ------------=_1240644605-7195-0 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 Your message dated Sat, 25 Apr 2009 10:23:34 +0300 with message-id <83skjxfb7t.fsf@gnu.org> and subject line Re: bug#3101: 23.0.92; Emacs manual, node Tags has caused the Emacs bug report #3101, regarding 23.0.92; Emacs manual, node Tags to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com immediately.) --=20 3101: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3D3101 Emacs Bug Tracking System Contact owner@emacsbugs.donarmstrong.com with problems ------------=_1240644605-7195-0 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-0 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@emacsbugs.donarmstrong.com 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-0--