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

Previous Next

To reply to this bug, email your comments to 18274 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Arthur Schwarz" <aschwarz1309 <at> att.net>
To: <bug-automake <at> gnu.org>
Subject: [ENHANCEMENT] Additional Tables
Date: Fri, 15 Aug 2014 14:28:14 -0700

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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.