texinfo ChangeLog NEWS doc/texinfo.tex doc/texi...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/12/23 17:14:44

Modified files:
        .              : ChangeLog NEWS 
        doc            : texinfo.tex texinfo.txi 
        doc/refcard    : txirefcard-a4.pdf txirefcard.pdf txirefcard.tex 

Log message:
        document new command @errormsg{} and implement in texinfo.tex

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1286&r2=1.1287
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.205&r2=1.206
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.tex?cvsroot=texinfo&r1=1.354&r2=1.355
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.401&r2=1.402
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard-a4.pdf?cvsroot=texinfo&rev=1.12
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.pdf?cvsroot=texinfo&rev=1.12
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.tex?cvsroot=texinfo&r1=1.19&r2=1.20

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1286
retrieving revision 1.1287
diff -u -b -r1.1286 -r1.1287
--- ChangeLog   23 Dec 2011 16:40:12 -0000      1.1286
+++ ChangeLog   23 Dec 2011 17:14:43 -0000      1.1287
@@ -1,5 +1,11 @@
 2011-12-23  Karl Berry  <address@hidden>
 
+       * NEWS: new command @errormsg.
+       * doc/texinfo.tex (\errormsg): new command.
+       (\commondummiesnofonts): add \anchor for the heck of it.
+       * doc/texinfo.txi (@@-Command List): add it.  
+       * doc/refcard/txirefcard.txi (Ending): likewise.
+
        * doc/texinfo.txi (Generic Translator texi2any): rename node.
        (Invoking makeinfo): leave anchor behind.
        (Glyphs summary): remove spurious menu.

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.205
retrieving revision 1.206
diff -u -b -r1.205 -r1.206
--- NEWS        16 Oct 2011 23:14:08 -0000      1.205
+++ NEWS        23 Dec 2011 17:14:43 -0000      1.206
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.205 2011/10/16 23:14:08 karl Exp $
+$Id: NEWS,v 1.206 2011/12/23 17:14:43 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -35,6 +35,7 @@
       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 command @errormsg to report an error.
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
 
 * texi2any is a new generic converter that can produce all supported

Index: doc/texinfo.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.tex,v
retrieving revision 1.354
retrieving revision 1.355
diff -u -b -r1.354 -r1.355
--- doc/texinfo.tex     9 Nov 2011 23:03:56 -0000       1.354
+++ doc/texinfo.tex     23 Dec 2011 17:14:43 -0000      1.355
@@ -3,7 +3,7 @@
 % Load plain if necessary, i.e., if running under initex.
 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
 %
-\def\texinfoversion{2011-11-09.15}
+\def\texinfoversion{2011-12-23.09}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -230,6 +230,13 @@
   \errorcontextlines16
 }%
 
+% @errormsg{MSG}.  Do the index-like expansions on MSG, but if things
+% aren't perfect, it's not the end of the world, being an error message,
+% after all.
+% 
+\def\errormsg{\begingroup \indexdummies \doerrormsg}
+\def\doerrormsg#1{\errmessage{#1}}
+
 % add check for \lastpenalty to plain's definitions.  If the last thing
 % we did was a \nobreak, we don't want to insert more space.
 %
@@ -4486,6 +4493,7 @@
   %
   % Commands that take arguments.
   \definedummyword\acronym
+  \definedummyword\anchor
   \definedummyword\cite
   \definedummyword\code
   \definedummyword\command

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.401
retrieving revision 1.402
diff -u -b -r1.401 -r1.402
--- doc/texinfo.txi     23 Dec 2011 16:40:12 -0000      1.401
+++ doc/texinfo.txi     23 Dec 2011 17:14:44 -0000      1.402
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.401 2011/12/23 16:40:12 karl Exp $
address@hidden $Id: texinfo.txi,v 1.402 2011/12/23 17:14:44 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -19800,6 +19800,11 @@
 Indicate to the reader with a glyph that the following text is
 an error message: @address@hidden  @xref{Error Glyph}.
 
address@hidden @@address@hidden@address@hidden
+Report @var{msg} as an error to standard error, and exit unsuccessfully.
+Texinfo commands within @var{msg} are expanded to plain text.
address@hidden xx need xref, when we have #line? xx
+
 @item @@address@hidden@}
 Generate the Euro currency sign.
 @xref{euro,,@code{@@address@hidden@}}}.
@@ -21203,7 +21208,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.401 2011/12/23 16:40:12 karl Exp $
+$Id: texinfo.txi,v 1.402 2011/12/23 17:14:44 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -21274,7 +21279,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.401 2011/12/23 16:40:12 karl Exp $
address@hidden $Id: texinfo.txi,v 1.402 2011/12/23 17:14:44 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi

Index: doc/refcard/txirefcard-a4.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard-a4.pdf,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
Binary files /tmp/cvsrsnbKi and /tmp/cvsKNtmch differ

Index: doc/refcard/txirefcard.pdf
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.pdf,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
Binary files /tmp/cvsAXetia and /tmp/cvsuCzdM8 differ

Index: doc/refcard/txirefcard.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.tex,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- doc/refcard/txirefcard.tex  5 Oct 2011 23:58:18 -0000       1.19
+++ doc/refcard/txirefcard.tex  23 Dec 2011 17:14:44 -0000      1.20
@@ -1,5 +1,5 @@
 % Texinfo reference card.
-% $Id: txirefcard.tex,v 1.19 2011/10/05 23:58:18 karl Exp $
+% $Id: txirefcard.tex,v 1.20 2011/12/23 17:14:44 karl Exp $
 %
 %**start of header
 % This file can be printed with 1, 2, or 3 columns per page (see below).
@@ -206,7 +206,7 @@
   \nobreak\noindent {\subheadingfont #1}%
   \nobreak\vskip 0pt plus.5ex\nobreak}
 %
-\outer\def\subsection#1{\glueabove{1ex plus.5ex minus.5ex}%
+\outer\def\subsection#1{\glueabove{.75ex plus.5ex minus.5ex}%
   \nobreak\noindent \centerline{\it #1}%
   \nobreak\vskip-.5ex % reduce parskip
   \nobreak
@@ -572,7 +572,7 @@
 address@hidden \var{line-of-text} without any indentation.}
 address@hidden an example or quotation by drawing a box with rounded corners 
around it. Pair with address@hidden cartouche}. No effect in Info.}
 
-\subsection{Displays in regular text fonts}
+\subsection{Displays using regular text fonts}
 
 address@hidden formatted text: do not fill text; retain normal
 margins and normal text font.  Pair with address@hidden format}.}
@@ -581,8 +581,8 @@
 address@hidden address@hidden, but select a smaller (text) font where 
possible.  Pair with address@hidden smalldisplay}.}
 address@hidden justify lines: do not fill text, retain normal margins and 
normal text font. Pair with address@hidden flushleft}.}
 address@hidden justify lines, leaving the left end ragged: do not fill text, 
retain normal margins and normal text font. Pair with address@hidden 
flushright}.}
address@hidden both margins to indicate text that is quoted from another work; 
do normal line breaking and retain normal font. Takes optional argument of 
prefix text. Pair with address@hidden quotation}.}
 address@hidden justify lines, leaving the right end ragged: fill text, retain 
normal text font. Pair with address@hidden raggedright}.}
address@hidden both margins to indicate text that is quoted from another work; 
do normal line breaking and retain normal font. Takes optional argument of 
prefix text. Pair with address@hidden quotation}.}
 address@hidden address@hidden, but select a smaller (text) font where 
possible.  Pair with address@hidden quotation}.}
 
 \subsection{Displays using fixed-width fonts}
@@ -902,6 +902,10 @@
 
 address@hidden reading the Texinfo source.  Any following text in the file is 
ignored.}
 
+\smallskip Finally, this meta-command doesn't fit anywhere else:
+
address@hidden \var{msg} as an error.}
+
 
 \chapter{Editing Texinfo sources in Emacs}