GNU bug report logs - #16732
[PATCH] update manual for texinfo 5.1

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 16732 in the body.
You can then email your comments to 16732 AT debbugs.gnu.org in the normal way.

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

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

From: Tom Tromey <tromey <at> redhat.com>
To: bug-idutils <bug-idutils <at> gnu.org>
Subject: [PATCH] update manual for texinfo 5.1
Date: Wed, 12 Feb 2014 13:42:31 -0700

Change the manual to build with texinfo 5.1.

	* doc/idutils.texi (Top): Rearrange menu.
	(Quick start): Use @itemize and @item.
	(Common options): Rearrange menu.
	(Walker options): Use @item, not @itemx.
	(Past and Future): Use @itemize and @item.
---
 doc/idutils.texi | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/doc/idutils.texi b/doc/idutils.texi
index 9d681ba..0a6da92 100644
--- a/doc/idutils.texi
+++ b/doc/idutils.texi
@@ -36,7 +36,7 @@ END-INFO-DIR-ENTRY
 @copying
 This file documents the @file{idutils} database utilities.
 
-Copyright @copyright{} 1996, 1999-2000, 2008-2012 Free Software Foundation,
+Copyright @copyright{} 1996, 1999-2000, 2008-2012, 2014 Free Software Foundation,
 Inc.
 
 @quotation
@@ -75,8 +75,8 @@ This manual documents version @value{VERSION} of the ID utilities.
 * mkid invocation::             Creating an ID database.
 * lid invocation::              Querying an ID database by token.
 * fid invocation::              Listing a file's tokens.
-* gid invocation::              Token-based grep
 * fnid invocation::             Looking up file names.
+* gid invocation::              Token-based grep
 * xtokid invocation::           Testing language scanners.
 * Past and Future::             History and future directions.
 * Index::                       General index.
@@ -164,23 +164,29 @@ sometimes difficult to infer.  @xref{Bugs, , , gcc, GNU CC}.
 @node Quick start
 @chapter Quick Start Procedure
 
-@table @bullet
+@itemize @bullet
 
+@item
 Unpack the distribution.
 
+@item
 Type @file{./configure}
 
+@item
 Type @samp{make}
 
+@item
 Type @samp{make install} as a user with the appropriate privileges
 (e.g., @samp{bin} or perhaps even @samp{root}).
 
+@item
 Type @samp{cd /usr/include; mkid} to build an ID database covering
 all of the system header files.
 
+@item
 Type @samp{lid FILE}, then @samp{gid strtok}, then @samp{aid stdout}.
 
-@end table
+@end itemize
 
 You have just built, installed and used the most common commands of the
 GNU ID utilities.  If you ever need help remembering which system header
@@ -202,11 +208,11 @@ rather than repeating them for each program.
 
 @menu
 * Universal options::     Options common to all programs.
-* Extraction options::    Options for programs that extract tokens from source files.
-* Walker options::        Options for programs that walk file and directory trees.
 * Reading options::       Options for programs that read ID databases.
 * Writing options::       Options for programs that write ID databases.
+* Walker options::        Options for programs that walk file and directory trees.
 * File listing options::  Options for programs that list file names.
+* Extraction options::    Options for programs that extract tokens from source files.
 @end menu
 
 @c ************* gkm *********************************************************
@@ -311,7 +317,7 @@ One or more file or directory names may appear in @var{names}.  The file
 tree walker will stop short at these files and directories and their
 contents will not be scanned.
 
-@itemx --files0-from=@var{FILE}
+@item --files0-from=@var{FILE}
 @opindex --files0-from=@var{FILE}
 Rather than processing files named on the command line, process those
 named in file @var{FILE}; each name is terminated by a null byte.
@@ -1357,16 +1363,19 @@ with the other GNU package names.
 @cindex future
 Future releases of @code{idutils} might include:
 
-@table @bullet
+@itemize @bullet
 
+@item
 an optional coupling with GNU @code{grep}, so that @code{grep} can use
 an ID database for hints
 
+@item
 a @code{cscope} work-alike query interface
 
+@item
 incremental update of the ID database.
 
-@end table
+@end itemize
 
 @c ***************************************************************************
 @node Index
-- 
1.8.5.3

Message #10 received at 16732-done <at> debbugs.gnu.org (full text, mbox):

From: Jim Meyering <jim <at> meyering.net>
To: Tom Tromey <tromey <at> redhat.com>
Cc: 16732-done <at> debbugs.gnu.org
Subject: Re: [bug-idutils] bug#16732: [PATCH] update manual for texinfo 5.1
Date: Thu, 13 Feb 2014 08:12:29 -0800

On Wed, Feb 12, 2014 at 12:42 PM, Tom Tromey <tromey <at> redhat.com> wrote:
> Change the manual to build with texinfo 5.1.
>
>         * doc/idutils.texi (Top): Rearrange menu.
>         (Quick start): Use @itemize and @item.
>         (Common options): Rearrange menu.
>         (Walker options): Use @item, not @itemx.
>         (Past and Future): Use @itemize and @item.

Thanks, Tom!
Applied and pushed.
Along the way, I've also updated copyright years and gnulib, so that
"make syntax-check" passes once again.

Previous Next

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