texinfo ChangeLog NEWS doc/info-stnd.texi info/...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/12/27 19:34:18

Modified files:
        .              : ChangeLog NEWS 
        doc            : info-stnd.texi 
        info           : infodoc.c 
        doc/refcard    : txicmdcheck txirefcard-a4.pdf txirefcard.pdf 
                         txirefcard.tex 

Log message:
        Info virtual-index doc

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1289&r2=1.1290
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.207&r2=1.208
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/info-stnd.texi?cvsroot=texinfo&r1=1.34&r2=1.35
http://cvs.savannah.gnu.org/viewcvs/texinfo/info/infodoc.c?cvsroot=texinfo&r1=1.29&r2=1.30
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txicmdcheck?cvsroot=texinfo&r1=1.3&r2=1.4
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard-a4.pdf?cvsroot=texinfo&rev=1.13
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.pdf?cvsroot=texinfo&rev=1.13
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.tex?cvsroot=texinfo&r1=1.22&r2=1.23

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1289
retrieving revision 1.1290
diff -u -b -r1.1289 -r1.1290
--- ChangeLog   26 Dec 2011 22:14:06 -0000      1.1289
+++ ChangeLog   27 Dec 2011 19:34:16 -0000      1.1290
@@ -1,3 +1,10 @@
+2011-12-27  Karl Berry  <address@hidden>
+
+       * NEWS: mention Info's virtual-index.
+       * doc/refcard/txirefcard.tex: likewise.
+       * doc/info-stnd.texi (Searching Commands): tweak text.
+       * info/infodoc.c: add to initial command list in help text.
+
 2011-12-26  Karl Berry  <address@hidden>
 
        * NEWS: new commands @atchar{} @lbracechar{} @rbracechar{}

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.207
retrieving revision 1.208
diff -u -b -r1.207 -r1.208
--- NEWS        26 Dec 2011 01:19:14 -0000      1.207
+++ NEWS        27 Dec 2011 19:34:16 -0000      1.208
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.207 2011/12/26 01:19:14 karl Exp $
+$Id: NEWS,v 1.208 2011/12/27 19:34:16 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -36,6 +36,8 @@
       in cross references by default, instead of node names.
   . new diacritic command @ogonek.
   . new commands for Icelandic letters eth and thorn: @DH{} @dh{} @TH{} @th{}.
+  . new commands for Texinfo special characters:
+    @atchar{} @lbracechar{} @rbracechar{} @backslashchar{}.
   . new command @errormsg to report an error.
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
 
@@ -74,6 +76,7 @@
 * info:
   . INFOPATH is determined from PATH by default, or if an element "PATH"
     is specified.
+  . New command Info-virtual-index, bound to I by default, following Emacs.
   . Info keywords not included in searches.
   . There is a lower limit on the length of search patterns.  The default
     value is 1.  It can be changed by setting the variable min-search-length,

Index: doc/info-stnd.texi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/info-stnd.texi,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -b -r1.34 -r1.35
--- doc/info-stnd.texi  17 Nov 2011 10:04:59 -0000      1.34
+++ doc/info-stnd.texi  27 Dec 2011 19:34:17 -0000      1.35
@@ -1,5 +1,5 @@
-vb\input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: info-stnd.texi,v 1.34 2011/11/17 10:04:59 gray Exp $
+\input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: info-stnd.texi,v 1.35 2011/12/27 19:34:17 karl Exp $
 @c We must \input texinfo.tex instead of texinfo, otherwise make
 @c distcheck in the Texinfo distribution fails, because the texinfo Info
 @c file is made first, and texi2dvi must include . first in the path.
@@ -80,7 +80,7 @@
 * Xref Commands::               Commands for selecting cross references.
 * Window Commands::             Commands which manipulate multiple windows.
 * Printing Nodes::              How to print out the contents of a node.
-* Miscellaneous Commands::      A few commands that defy categories.
+* Miscellaneous Commands::      A few commands that defy categorization.
 * Variables::                   How to change the default behavior of Info.
 * Custom Key Bindings::         How to define your own key-to-command bindings.
 * Index::                       Global index with keystrokes, command names,
@@ -1053,17 +1053,15 @@
 Look up a string in the indices for this Info file, and select a node
 to which the found index entry points.
 
-Normally, the search string should not be shorter than some
-predefined limit.  By default, this limit is set to 1 character.
address@hidden, for more information on this.
+The search string should not be shorter than a predefined limit, set
+to 1 character by default (@pxref{min-search-length}).
 
 @item @kbd{I} (@code{virtual-index})
 @kindex I
 @findex virtual-index
 @cindex index, virtual
-Look up a string in the indices for this Info file, and show them in
-a single node.  It is similar to @code{virtual-index}, except that it
-constructs a special node to show all results.
+Look up a string in the indices for this Info file, and show all the
+matches in a new virtual node, synthesized on the fly.
 
 @item @kbd{,} (@code{next-index-match})
 @kindex ,

Index: info/infodoc.c
===================================================================
RCS file: /sources/texinfo/texinfo/info/infodoc.c,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -b -r1.29 -r1.30
--- info/infodoc.c      18 Oct 2011 18:47:20 -0000      1.29
+++ info/infodoc.c      27 Dec 2011 19:34:17 -0000      1.30
@@ -1,5 +1,5 @@
 /* infodoc.c -- functions which build documentation nodes.
-   $Id: infodoc.c,v 1.29 2011/10/18 18:47:20 karl Exp $
+   $Id: infodoc.c,v 1.30 2011/12/27 19:34:17 karl Exp $
 
    Copyright (C) 1993, 1997, 1998, 1999, 2001, 2002, 2003, 2004, 2006,
    2007, 2008, 2011
@@ -79,6 +79,8 @@
   N_("\\%-10[search-next]  Search for next occurrence.\n"),
   N_("\\%-10[index-search]  Search for a specified string in the index, and\n\
               select the node referenced by the first entry found.\n"),
+  N_("\\%-10[virtual-index]  Synthesize menu of matching index entries.\n"),
+  "\n",
   N_("\\%-10[abort-key]  Cancel the current operation.\n"),
   "\n",
   NULL

Index: doc/refcard/txicmdcheck
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txicmdcheck,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- doc/refcard/txicmdcheck     20 Feb 2011 18:39:40 -0000      1.3
+++ doc/refcard/txicmdcheck     27 Dec 2011 19:34:17 -0000      1.4
@@ -1,5 +1,5 @@
 #!/usr/bin/env perl
-# $Id: txicmdcheck,v 1.3 2011/02/20 18:39:40 karl Exp $
+# $Id: txicmdcheck,v 1.4 2011/12/27 19:34:17 karl Exp $
 # Copyright 2008, 2011 Free Software Foundation, Inc.
 # 
 # This program is free software; you can redistribute it and/or modify
@@ -104,8 +104,9 @@
       push (@ret, "${c}x") if $xcmd;
     }
   }
-  push (@ret, '@,');  # our non-parsing above lost the comma
   push (@ret, '@end', '@uref', '@appendixsection');  # described in text
+  push (@ret, '@,');  # our non-parsing above lost these
+  push (@ret, qw(@atchar @lbracechar @rbracechar @backslashchar));
   close (FILE) || warn "close($FILE) failed: $!";
   return @ret;
 }

Index: doc/refcard/txirefcard-a4.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard-a4.pdf,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
Binary files /tmp/cvsfIQQeX and /tmp/cvsACGm6B differ

Index: doc/refcard/txirefcard.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.pdf,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -b -r1.12 -r1.13
Binary files /tmp/cvsgDR7mY and /tmp/cvsgG33fD differ

Index: doc/refcard/txirefcard.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.tex,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -b -r1.22 -r1.23
--- doc/refcard/txirefcard.tex  26 Dec 2011 22:14:06 -0000      1.22
+++ doc/refcard/txirefcard.tex  27 Dec 2011 19:34:17 -0000      1.23
@@ -1,5 +1,5 @@
 % Texinfo reference card.
-% $Id: txirefcard.tex,v 1.22 2011/12/26 22:14:06 karl Exp $
+% $Id: txirefcard.tex,v 1.23 2011/12/27 19:34:17 karl Exp $
 %
 %**start of header
 % This file can be printed with 1, 2, or 3 columns per page (see below).
@@ -972,7 +972,7 @@
 
 There are two main Info readers: \code{M-x info} (\code{C-h i}) in GNU
 Emacs, and the standalone \code{info} program.  These basic keystrokes
-are for standalone Info, but most work in Emacs Info as well.
+are from standalone Info, but most work in Emacs Info as well.
 
 \begininfokeys %
 \infokey q           Quit Info altogether.\cr
@@ -982,7 +982,7 @@
 \infokey Down        Move down one line.\cr
 \infokey DEL         Scroll backward one screenful.\cr
 \infokey SPC         Scroll forward one screenful.\cr
-\infokey Home        Go to the beginning of this node.\cr
+\infokey Home, b     Go to the beginning of this node.\cr
 \infokey End         Go to the end of this node.\cr
 
 \infokey TAB         Skip to the next hypertext link.\cr
@@ -1000,7 +1000,7 @@
 \infokey 1...9       Pick the first...ninth item in this node's menu.\cr
 \infokey 0           Pick the last item in this node's menu.\cr
 \infokey m           Pick a menu item specified by name.\cr
-\infokey r           Follow a cross reference specified by name.\cr
+\infokey f           Follow a cross reference specified by name.\cr
 \infokey g           Go to a node specified by name.\cr
 
 \infokey s           Search forward for a specified string.\cr
@@ -1008,6 +1008,7 @@
 \infokey \rbracechar{}           Search for next occurrence.\cr
 \infokey i           Search for a specified string in the index, and\cr
 \infokey {}              select the node referenced by the first entry 
found.\cr
+\infokey I           Synthesize menu of matching index entries.\cr
 
 \infokey C-g         Cancel the current operation.\cr
 \endinfokeys