[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
Karl Berry |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Tue, 08 Nov 2011 00:21:02 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: Karl Berry <karl> 11/11/08 00:21:02
Modified files:
. : ChangeLog
doc : texinfo.txi
Log message:
@xref instead of @inforef to Info manual
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1278&r2=1.1279
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.396&r2=1.397
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1278
retrieving revision 1.1279
diff -u -b -r1.1278 -r1.1279
--- ChangeLog 6 Nov 2011 17:15:38 -0000 1.1278
+++ ChangeLog 8 Nov 2011 00:21:01 -0000 1.1279
@@ -1,3 +1,9 @@
+2011-11-07 Karl Berry <address@hidden>
+
+ * doc/texinfo.txi: replace @inforef's to the Info manual
+ with regular @xref's, since the Info manual has not been
+ Info-only for many years.
+
2011-11-06 Karl Berry <address@hidden>
* doc/texinfo.tex (\putworderror): new word for translation.
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.396
retrieving revision 1.397
diff -u -b -r1.396 -r1.397
--- doc/texinfo.txi 6 Nov 2011 16:59:17 -0000 1.396
+++ doc/texinfo.txi 8 Nov 2011 00:21:01 -0000 1.397
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.396 2011/11/06 16:59:17 karl Exp $
address@hidden $Id: texinfo.txi,v 1.397 2011/11/08 00:21:01 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.
@@ -887,8 +887,8 @@
control characters to separate nodes and provide navigational
information for menus, cross references, indices, and so on. See the
next section (@pxref{Info Files}) for more details on this format.
-The Emacs Info subsystem (@pxref{Top,,Getting Started,info, Info}),
-and the standalone @command{info} program (@pxref{Top ,, Info
+The Emacs Info subsystem (@pxref{Top,, Getting Started, info, Info}),
+and the standalone @command{info} program (@pxref{Top,, Info
Standalone, info-stnd, GNU Info}), among others, can read these files.
@xref{Creating and Installing Info Files}.
@@ -1072,8 +1072,8 @@
If you want to read through an Info file in sequence, as if it were a
printed manual, you can hit @key{SPC} repeatedly, or you get the whole
-file with the advanced Info command @kbd{g *}. (@inforef{Advanced,
-Advanced Info commands, info}.)@refill
+file with the advanced Info command @kbd{g *}. (@xref{Advanced,,
+Advanced Info commands, info, Info}.)
@c !!! dir file may be located in one of many places:
@c /usr/local/emacs/info mentioned in info.c DEFAULT_INFOPATH
@@ -5048,7 +5048,8 @@
you wish; the spaces are ignored. You must write the name of the node
and (if present) the names of the `Next', `Previous', and `Up'
pointers all on the same line. Otherwise, the formatters fail.
-(@inforef{Top, info, info}, for more information about nodes in Info.)
+(@xref{Top,, Getting Started, info, Info}, for more information about
+nodes in Info.)
Usually, you write one of the chapter-structuring command lines
immediately after an @code{@@node} line---for example, an
@@ -5813,8 +5814,8 @@
reference names that address@hidden
In Info, a cross reference results in an entry that you can follow
-using the Info @samp{f} command. (@inforef{Help-Xref, Following
-cross-references, info}.)
+using the Info @samp{f} command. (@xref{Help-Xref,, Following
+cross-references, info, Info}.)
The various cross reference commands use nodes (or anchors,
@pxref{anchor,,@code{@@anchor}}) to define cross reference locations.
@@ -5843,16 +5844,16 @@
@item @@ref
Used within or, more often, at the end of a sentence; same as
@code{@@xref} for Info; produces just the reference in the printed
-manual without a preceding `See'address@hidden
+manual without a preceding `See'.
@item @@pxref
Used within parentheses to make a reference that suits both an Info
file and a printed book. Starts with a lower case `see' within the
-printed manual. (@samp{p} is for `parenthesis'.)@refill
+printed manual. (@samp{p} is for `parenthesis'.)
@item @@inforef
Used to make a reference to an Info file for which there is no printed
address@hidden
+manual.
@end table
@noindent
@@ -6630,7 +6631,7 @@
possibilities.
The command takes either two or three arguments, in the following
-order:@refill
+order:
@enumerate
@item
@@ -6646,7 +6647,7 @@
@noindent
Separate the arguments with commas, as with @code{@@xref}. Also, you
must terminate the reference with a comma or period after the
address@hidden@}}, as you do with @code{@@address@hidden
address@hidden@}}, as you do with @code{@@xref}.
@noindent
The template is:
@@ -6686,7 +6687,8 @@
@end quotation
(This particular example is not realistic, since the Info manual is
-written in Texinfo, so all formats are available.)
+written in Texinfo, so all formats are available. In fact, we don't
+know of any extant Info-only manuals.)
The converse of @code{@@inforef} is @code{@@cite}, which is used to
refer to printed works for which no Info form exists. @xref{cite, ,
@@ -17472,9 +17474,10 @@
@cindex Info file installation
@cindex @file{dir} directory for Info installation
-Info files are usually kept in the @file{info} directory. You can read
-Info files using the standalone Info program or the Info reader built
-into Emacs. (@inforef{Top, info, info}, for an introduction to Info.)
+Info files are usually kept in the @file{info} directory. You can
+read Info files using the standalone Info program or the Info reader
+built into Emacs. (@xref{Top,, Getting Started, info, Info}, for an
+introduction to Info.)
@menu
* Directory File:: The top level menu for all Info files.
@@ -19909,8 +19912,7 @@
@item @@address@hidden@var{node-name}, address@hidden, @address@hidden
Make a cross reference to an Info file for which there is no printed
-manual. @xref{inforef, , Cross references using
address@hidden@@inforef}}.
+manual. @xref{inforef,, Cross references using @code{@@inforef}}.
@item \input @var{macro-definitions-file}
Use the specified macro definitions file. This command is used only
@@ -21103,7 +21105,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.396 2011/11/06 16:59:17 karl Exp $
+$Id: texinfo.txi,v 1.397 2011/11/08 00:21:01 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}
@@ -21174,7 +21176,7 @@
@verbatim
\input texinfo @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.396 2011/11/06 16:59:17 karl Exp $
address@hidden $Id: texinfo.txi,v 1.397 2011/11/08 00:21:01 karl Exp $
@comment %**start of header
@setfilename sample.info
@include version.texi
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- texinfo ChangeLog doc/texinfo.txi,
Karl Berry <=