From unknown Sat Aug 16 14:25:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#16732: [PATCH] update manual for texinfo 5.1 Resent-From: Tom Tromey Original-Sender: "Debbugs-submit" Resent-CC: bug-idutils@gnu.org Resent-Date: Wed, 12 Feb 2014 20:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 16732 X-GNU-PR-Package: idutils X-GNU-PR-Keywords: patch To: 16732@debbugs.gnu.org X-Debbugs-Original-To: bug-idutils Received: via spool by submit@debbugs.gnu.org id=B.139223791021587 (code B ref -1); Wed, 12 Feb 2014 20:46:02 +0000 Received: (at submit) by debbugs.gnu.org; 12 Feb 2014 20:45:10 +0000 Received: from localhost ([127.0.0.1]:49299 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDgg9-0005c7-Ps for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:45:10 -0500 Received: from eggs.gnu.org ([208.118.235.92]:55450) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDgg2-0005bF-CF for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:45:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDgfo-0007DR-BM for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:44:57 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49290) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgfo-0007BV-85 for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:44:48 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56500) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgdm-0003xg-HW for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDgde-0006S8-LB for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:42 -0500 Received: from mx1.redhat.com ([209.132.183.28]:23592) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgde-0006S3-DN for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:34 -0500 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s1CKgXEq012332 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 12 Feb 2014 15:42:33 -0500 Received: from barimba (ovpn-113-148.phx2.redhat.com [10.3.113.148]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s1CKgV5G018736 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Wed, 12 Feb 2014 15:42:32 -0500 From: Tom Tromey X-Attribution: Tom Date: Wed, 12 Feb 2014 13:42:31 -0700 Message-ID: <87wqh0rrk8.fsf@fleche.redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.68 on 10.5.11.25 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.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: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) 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 From unknown Sat Aug 16 14:25:50 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Tom Tromey Subject: bug#16732: closed (Re: [bug-idutils] bug#16732: [PATCH] update manual for texinfo 5.1) Message-ID: References: <87wqh0rrk8.fsf@fleche.redhat.com> X-Gnu-PR-Message: they-closed 16732 X-Gnu-PR-Package: idutils X-Gnu-PR-Keywords: patch Reply-To: 16732@debbugs.gnu.org Date: Thu, 13 Feb 2014 16:13:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1392307983-32422-1" This is a multi-part message in MIME format... ------------=_1392307983-32422-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #16732: [PATCH] update manual for texinfo 5.1 which was filed against the idutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 16732@debbugs.gnu.org. --=20 16732: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D16732 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1392307983-32422-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 16732-done) by debbugs.gnu.org; 13 Feb 2014 16:12:58 +0000 Received: from localhost ([127.0.0.1]:50941 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDyuI-0008Qf-6I for submit@debbugs.gnu.org; Thu, 13 Feb 2014 11:12:58 -0500 Received: from mail-pb0-f49.google.com ([209.85.160.49]:49295) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDyuG-0008QI-5P for 16732-done@debbugs.gnu.org; Thu, 13 Feb 2014 11:12:56 -0500 Received: by mail-pb0-f49.google.com with SMTP id up15so10949937pbc.22 for <16732-done@debbugs.gnu.org>; Thu, 13 Feb 2014 08:12:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc:content-type; bh=vG31WxGbLyb5zuBl7zF/0saEBBgpn60l1skWEIysF5w=; b=hKEb5aVD5CQ/7Euz3XpX5XjfGSMzzbIm7lHv5ryK1IxFOT7SocJc+ZyrKQxA4q+V9R HX9tkvwjnIJvSgXCOORnYje1Y41a3VWs1pvCjn+0uOfgbpGH+yVsK9wjuYx3qJs2zWPq IiFYkXyOqdEs2QJKoaSvuv2C5C7b3n51Cowuq86t9RAQpzuuA5DUjhTHyKWoPd/T1Zac qjunRSIwSM2FSi29uKTE354ozVZNCmuWC3Yo7sUQRnT8kDLEVmrGYzzkWxWJ1v5ZQxwg zemgk+zMRlp+GD6Vj+lV/r+Ut0k+ACdyuNWoiv/TP5t36KY1zasG4mY71YMwFdGty6IK 6jeA== X-Received: by 10.66.138.40 with SMTP id qn8mr2731434pab.154.1392307969577; Thu, 13 Feb 2014 08:12:49 -0800 (PST) MIME-Version: 1.0 Received: by 10.68.201.231 with HTTP; Thu, 13 Feb 2014 08:12:29 -0800 (PST) In-Reply-To: <87wqh0rrk8.fsf@fleche.redhat.com> References: <87wqh0rrk8.fsf@fleche.redhat.com> From: Jim Meyering Date: Thu, 13 Feb 2014 08:12:29 -0800 X-Google-Sender-Auth: qaQez4wcBGRzegfmZqR_DhD-Bjk Message-ID: Subject: Re: [bug-idutils] bug#16732: [PATCH] update manual for texinfo 5.1 To: Tom Tromey Content-Type: text/plain; charset=ISO-8859-1 X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 16732-done Cc: 16732-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) On Wed, Feb 12, 2014 at 12:42 PM, Tom Tromey 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. ------------=_1392307983-32422-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 12 Feb 2014 20:45:10 +0000 Received: from localhost ([127.0.0.1]:49299 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDgg9-0005c7-Ps for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:45:10 -0500 Received: from eggs.gnu.org ([208.118.235.92]:55450) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDgg2-0005bF-CF for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:45:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDgfo-0007DR-BM for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:44:57 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49290) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgfo-0007BV-85 for submit@debbugs.gnu.org; Wed, 12 Feb 2014 15:44:48 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56500) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgdm-0003xg-HW for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WDgde-0006S8-LB for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:42 -0500 Received: from mx1.redhat.com ([209.132.183.28]:23592) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WDgde-0006S3-DN for bug-idutils@gnu.org; Wed, 12 Feb 2014 15:42:34 -0500 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s1CKgXEq012332 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 12 Feb 2014 15:42:33 -0500 Received: from barimba (ovpn-113-148.phx2.redhat.com [10.3.113.148]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s1CKgV5G018736 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Wed, 12 Feb 2014 15:42:32 -0500 From: Tom Tromey To: bug-idutils Subject: [PATCH] update manual for texinfo 5.1 X-Attribution: Tom Date: Wed, 12 Feb 2014 13:42:31 -0700 Message-ID: <87wqh0rrk8.fsf@fleche.redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.68 on 10.5.11.25 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.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: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) 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 ------------=_1392307983-32422-1--