From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3101: 23.0.92; Emacs manual, node Tags Date: Fri, 24 Apr 2009 13:36:31 -0700 Message-ID: <007501c9c51c$5a6c8f70$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 3101@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1240607538 21917 80.91.229.12 (24 Apr 2009 21:12:18 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 24 Apr 2009 21:12:18 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 24 23:13:36 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 1LxSiF-0000YP-QU for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Apr 2009 23:13:36 +0200 Original-Received: from localhost ([127.0.0.1]:45949 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LxSgq-0004Uq-6P for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Apr 2009 17:12:08 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LxSgl-0004U1-1b for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2009 17:12:03 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LxSgg-0004Sb-3x for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2009 17:12:02 -0400 Original-Received: from [199.232.76.173] (port=53254 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LxSgf-0004SK-RH for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2009 17:11:57 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:52339) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LxSgf-0003bX-9G for bug-gnu-emacs@gnu.org; Fri, 24 Apr 2009 17:11: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 n3OLBoUa003251; Fri, 24 Apr 2009 14:11:53 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n3OKj3Qg018730; Fri, 24 Apr 2009 13:45:03 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 24 Apr 2009 20:45:02 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3101 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124060540417323 (code B ref -1); Fri, 24 Apr 2009 20:45:02 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 24 Apr 2009 20:36:44 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from dradamslap1 (/98.210.250.59) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 24 Apr 2009 13:36:31 -0700 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) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Fri, 24 Apr 2009 17:12:02 -0400 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:27435 gmane.emacs.pretest.bugs:24326 Archived-At: 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)'