GNU bug report logs - #18274
additional tables/indices in manual for easier navigation

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 15 Aug 2014 21:32:34 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Aug 15 17:32:34 2014
Received: from localhost ([127.0.0.1]:44170 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1XIP6v-0002v2-4T
	for submit <at> debbugs.gnu.org; Fri, 15 Aug 2014 17:32:33 -0400
Received: from eggs.gnu.org ([208.118.235.92]:34236)
 by debbugs.gnu.org with esmtp (Exim 4.80)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP3T-0002nX-Fu
 for submit <at> debbugs.gnu.org; Fri, 15 Aug 2014 17:29:00 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP3E-00088O-5u
 for submit <at> debbugs.gnu.org; Fri, 15 Aug 2014 17:28:54 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: *
X-Spam-Status: No, score=1.1 required=5.0 tests=BAYES_50,
 FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,T_DKIM_INVALID autolearn=disabled
 version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:50142)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP3E-00088K-2R
 for submit <at> debbugs.gnu.org; Fri, 15 Aug 2014 17:28:44 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:35949)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP35-0001yq-Ly
 for bug-automake@HIDDEN; Fri, 15 Aug 2014 17:28:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP2t-00083w-MT
 for bug-automake@HIDDEN; Fri, 15 Aug 2014 17:28:35 -0400
Received: from nm21-vm3.access.bullet.mail.gq1.yahoo.com ([216.39.63.79]:43087)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <aschwarz1309@HIDDEN>) id 1XIP2t-00083r-9x
 for bug-automake@HIDDEN; Fri, 15 Aug 2014 17:28:23 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s2048;
 t=1408138102; bh=O0NhRCETGJa05hG6NOnLXg3LGWnWgLCTpewLpVQbfmg=;
 h=Received:Received:Received:DKIM-Signature:X-Yahoo-Newman-Id:X-Yahoo-Newman-Property:X-YMail-OSG:X-Yahoo-SMTP:From:To:Subject:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:X-Mailer:thread-index:X-MimeOLE;
 b=IgQu0mHKdeagSEwMdxTWVS/DXUOR3te+Alyk5McFIE36Z3DzHnZskLn0rRTX+H5D58y54EVAjwMGYaSURCK8Dsf9LTxxQAVwSt2wOUx8Z1vstDsK7QQlDPhfUob3vbC6kG+hgMvSde7A5QVhB8P8WEMR/E+usw3kXFHnRl20hvze28VkAEV/9kxLWd3/sP3g5nNnnmHCJr31tyqFo2WqwlOlt4VMTrfufMU7aEPHo0l4VDFOlkgD6Isn5wkXu7sjgGTvh9A3xsBqt9qRhf9YiK/TkzKS3vHeKe7W2gBdBYL780Pp/986WVpWzg1/9BHVtwqdBJQ/XV8YhxxiZKaBiA==
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s2048; d=att.net;
 b=Dwcwk7vc77xVBBV+9zkYni0Sl38QZRO35dXkUXyAveZ7potyZxhVl5G7v/RKcxXd8WGPenjoHmcOyadiDQpzBn22TGVnYw/yqPOh4PFpdMjlDqb5SY4RUD6rqBmgvu+mBpzelrKNVkxqvhsWCG52t8R1NDQBoZ1PDLv3tTk/T0BvaHZu3/Bst2vsY9AqWawVQoelEVpAkLZVve5cU7vQsGLmE43ZYf+TkaDccoXENFh/NTGIPKac8fJZHb8/qM8o9jtj2aKyw15S0if+iHqxVKb3xp1tJJD1aBv4Bmm0ZalJpkeUb9Kg6lCDfCks7owKWfJ/lLA8i1/wJBL6n19H2g==;
Received: from [216.39.60.166] by nm21.access.bullet.mail.gq1.yahoo.com with
 NNFMP; 15 Aug 2014 21:28:22 -0000
Received: from [67.195.23.148] by tm2.access.bullet.mail.gq1.yahoo.com with
 NNFMP; 15 Aug 2014 21:28:22 -0000
Received: from [127.0.0.1] by smtp120.sbc.mail.gq1.yahoo.com with NNFMP;
 15 Aug 2014 21:28:22 -0000
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s1024;
 t=1408138102; bh=O0NhRCETGJa05hG6NOnLXg3LGWnWgLCTpewLpVQbfmg=;
 h=X-Yahoo-Newman-Id:X-Yahoo-Newman-Property:X-YMail-OSG:X-Yahoo-SMTP:From:To:Subject:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:X-Mailer:thread-index:X-MimeOLE;
 b=T6vqSsF9s62JTbyxGGRxm8rmCmU/14ixPHAuuev6krpXgs3EfGSsOomI1dYqv07CRkowCP+GXKXpDQbTc0qCaLdAmHsilP0MNGNC07UVWr0z4u4peHHeicUAyygn0TIp76il0M0tcG8jyzNQ8OW8MzvCIpztF3QoK3MoC1pdlMA=
X-Yahoo-Newman-Id: 287074.94715.bm@HIDDEN
X-Yahoo-Newman-Property: ymail-3
X-YMail-OSG: GGa6ZbQVM1mL.AuVPiFw0uobngGyGkWAOtoal0dkIrBSfXT
 GKqmSyQ2UehBlRlS5uXqwUiCjMk_bOvIPMJdVkDEHxMuqpGnAprOvULGmbeB
 EB4RriXA07h.00Q0bLokvzsCCdzXfb..6uMlcCFoI17x3MAqYFsw3z0W9hon
 aawdolOyj5iobyugzz8QSMPI9JRUxzEQG2XZPrgnanXye8ZUpwNDtNfe93ml
 VBb_FAVa49riOw1zKJVUXXPyDPXRucMQYcpMlnkpe6kQtM5247lF_4vXse77
 LHMnlPxl48sjKJQAb.v5WghEStvcDS3vEVhn3DNlxNt14FcIV8BJFnw9m42E
 PMb9Ja6FEp0x.P0OpVWUFW1hGO7DMTedtKEzJndB_fHeyFqOMo2.4kUN6WlC
 _Ol.LC44entJv6Cm4Qr4f7W.R1hJxfQvEmMj.x4fDEkfWwtso5GqBeWBWbBb
 0otmhQ8b7y26kuN0UGNjgEVqE8tkYgSOAN5Yvs68yoy_HKo.eTz56WTnw8WV
 sK41kssgz7EaUyKPCifXMBUVlhXBDFbGRLHLLTZzF
X-Yahoo-SMTP: 0z5TJLmswBDohOc2QznCIeoaEiEalQiTSMLFNdKdTt4t
From: "Arthur Schwarz" <aschwarz1309@HIDDEN>
To: <bug-automake@HIDDEN>
Subject: [ENHANCEMENT] Additional Tables
Date: Fri, 15 Aug 2014 14:28:14 -0700
Message-ID: <95CB111C37ED4B38A118EA69FABFDA55@HPDV7TNotebook>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook 11
thread-index: Ac+4z9KtwQaGdocXQnOztIMUkDxBHQ==
X-MimeOLE: Produced By Microsoft MimeOLE V6.1.7601.17609
X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x
X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address
 (bad octet value).
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.7 (----)
X-Debbugs-Envelope-To: submit
X-Mailman-Approved-At: Fri, 15 Aug 2014 17:32:31 -0400
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <http://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <http://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <http://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -4.7 (----)

It would be useful for there to be a set of tables to allow ready
identification of macros and variables and .. required for different
functional areas (especially for newbies like me). 

For example:
  What stuff is optional/required/relevant for
     Placing support files into standard places (README, NEWS, .)
       make  
       make install
       make dist
       make distclear

  And whatever else comes to mind.

The current index provides two extremely useful views, macros and variables,
but these are not associated with functionality. It's the same as saying
read everything to get anything. 

For the non-discriminating reader it is a daunting task to read the entire
manual to find some simple thing. The resources currently available are the
topic headings in the TOC, index topics and the macro and variable tables. I
wonder if these things can be leveraged to provide a more focused look.

I'd be glad to help.

art