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

Previous Next

Package: idutils;

Reported by: Tom Tromey <tromey <at> redhat.com>

Date: Wed, 12 Feb 2014 20:46:02 UTC

Severity: normal

Tags: patch

Done: Jim Meyering <jim <at> meyering.net>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Jim Meyering <jim <at> meyering.net>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#16732: closed ([PATCH] update manual for texinfo 5.1)
Date: Thu, 13 Feb 2014 16:13:02 +0000
[Message part 1 (text/plain, inline)]
Your message dated Thu, 13 Feb 2014 08:12:29 -0800
with message-id <CA+8g5KHYeyrmQH_eTbyTQ98Hrm=5OpUVLjJO-bD872LFqtNvmQ <at> mail.gmail.com>
and subject line Re: [bug-idutils] bug#16732: [PATCH] update manual for texinfo 5.1
has caused the debbugs.gnu.org bug report #16732,
regarding [PATCH] update manual for texinfo 5.1
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
16732: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16732
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
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 part 3 (message/rfc822, inline)]
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.


This bug report was last modified 11 years and 158 days ago.

Previous Next


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