[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
karl |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Fri, 04 Jan 2013 18:09:23 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 13/01/04 18:09:23
Modified files:
. : ChangeLog
doc : texinfo.txi
Log message:
use @ in more node names
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1495&r2=1.1496
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.509&r2=1.510
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1495
retrieving revision 1.1496
diff -u -b -r1.1495 -r1.1496
--- ChangeLog 4 Jan 2013 01:29:58 -0000 1.1495
+++ ChangeLog 4 Jan 2013 18:09:22 -0000 1.1496
@@ -1,3 +1,9 @@
+2013-01-04 Karl Berry <address@hidden>
+
+ * doc/texinfo.txi (end titlepage, setchapternewpage,
+ headings on off, paragraphindent, exampleindent): continue
+ conversion to node names with @.
+
2013-01-02 Thien-Thi Nguyen <address@hidden> (tiny change)
* doc/texinfo.txi (Combining Indices):
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.509
retrieving revision 1.510
diff -u -b -r1.509 -r1.510
--- doc/texinfo.txi 4 Jan 2013 01:29:58 -0000 1.509
+++ doc/texinfo.txi 4 Jan 2013 18:09:23 -0000 1.510
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.509 2013/01/04 01:29:58 karl Exp $
address@hidden $Id: texinfo.txi,v 1.510 2013/01/04 18:09:23 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.
@@ -246,7 +246,7 @@
and @code{@@author} commands.
* Copyright:: How to write the copyright notice and
include copying permissions.
-* end titlepage:: Turn on page headings after the title and
+* Heading Generation:: Turn on page headings after the title and
copyright pages.
The `Top' Node and Master Menu
@@ -257,12 +257,12 @@
Global Document Commands
* @code{@@documentdescription}:: Document summary for the HTML output.
-* setchapternewpage:: Start chapters on right-hand pages.
-* headings on off:: An option for turning headings on and off
+* @code{@@setchapternewpage}:: Start chapters on right-hand pages.
+* @code{@@headings}:: An option for turning headings on and off
and double or single sided printing.
-* paragraphindent:: Specify paragraph indentation.
-* firstparagraphindent:: Suppress indentation of the first paragraph.
-* exampleindent:: Specify environment indentation.
+* @code{@@paragraphindent}:: Specify paragraph indentation.
+* @code{@@firstparagraphindent}:: Suppressing first paragraph indentation.
+* @code{@@exampleindent}:: Specify environment indentation.
Ending a Texinfo File
@@ -3104,7 +3104,7 @@
This command tells @TeX{} the title to use in a header or footer
for double-sided output, in case such headings are output. For
-more on headings for @TeX{}, see @ref{end titlepage}.
+more on headings for @TeX{}, see @ref{Heading Generation}.
@cindex @code{<title>} HTML tag
In the HTML file produced by @command{makeinfo}, @var{title} serves as
@@ -3297,7 +3297,7 @@
and @code{@@author} commands.
* Copyright:: How to write the copyright notice and
include copying permissions.
-* end titlepage:: Turn on page headings after the title and
+* Heading Generation:: Turn on page headings after the title and
copyright pages.
@end menu
@@ -3314,7 +3314,7 @@
@code{@@end titlepage} on a line by itself.
The @code{@@end titlepage} command starts a new page and turns on page
-numbering (@pxref{end titlepage, , Heading Generation}). All the
+numbering (@pxref{Heading Generation}). All the
material that you want to appear on unnumbered pages should be put
between the @code{@@titlepage} and @code{@@end titlepage} commands.
You can force the table of contents to appear there with the
@@ -3590,12 +3590,14 @@
address@hidden end titlepage
address@hidden Heading Generation
@subsection Heading Generation
address@hidden end titlepage
+
address@hidden address@hidden old name
@cindex Headings, page, begin to appear
@cindex Titlepage end starts headings
@cindex End titlepage starts headings
address@hidden Generating page headings
Like all @code{@@end} commands (@pxref{Quotations and Examples}), the
@code{@@end titlepage} command must be written at the beginning of a
@@ -3609,7 +3611,7 @@
and the other for documents printed on both sides of each sheet
(double-sided printing).
-In all generality, you can control the headings in different ways:
+In full generality, you can control the headings in different ways:
@itemize @bullet
@item
@@ -3622,19 +3624,18 @@
double-sided headings, (sometimes) using @code{@@setchapternewpage
odd} for double-sided printing and (almost always) no
@code{@@setchapternewpage} command for single-sided printing
-(@pxref{setchapternewpage,, @code{@@setchapternewpage}}).
+(@address@hidden@@setchapternewpage}}).
@item
Alternatively, you can use the @code{@@headings} command to prevent
page headings from being generated or to start them for either single
or double-sided printing. Write an @code{@@headings} command
immediately after the @code{@@end titlepage} command. To turn off
-headings, write @code{@@headings off}. @xref{headings on off,, The
address@hidden@@headings} Command}.
+headings, write @code{@@headings off}. @address@hidden@@headings}}.
@item
Or, you may specify your own page heading and footing format.
address@hidden, , Page Headings}.
address@hidden
@end itemize
@@ -3874,12 +3875,12 @@
@menu
* @code{@@documentdescription}:: Document summary for the HTML output.
-* setchapternewpage:: Start chapters on right-hand pages.
-* headings on off:: An option for turning headings on and off
+* @code{@@setchapternewpage}:: Start chapters on right-hand pages.
+* @code{@@headings}:: An option for turning headings on and off
and double or single sided printing.
-* paragraphindent:: Specify paragraph indentation.
-* firstparagraphindent:: Suppress indentation of the first paragraph.
-* exampleindent:: Specify environment indentation.
+* @code{@@paragraphindent}:: Specify paragraph indentation.
+* @code{@@firstparagraphindent}:: Suppressing first paragraph indentation.
+* @code{@@exampleindent}:: Specify environment indentation.
@end menu
@@ -3918,11 +3919,13 @@
the document.
address@hidden setchapternewpage
address@hidden @code{@@setchapternewpage}:
address@hidden @code{@@setchapternewpage}
address@hidden @code{@@setchapternewpage}: Blank Pages Before Chapters
+
address@hidden@c old name
address@hidden setchapternewpage
@cindex Starting chapters
@cindex Pages, starting odd
address@hidden setchapternewpage
In an officially bound book, text is usually printed on both sides of
the paper, chapters start on right-hand pages, and right-hand pages have
@@ -3973,7 +3976,7 @@
If you don't like the default headers that @code{@@setchapternewpage}
sets, you can explicit control them with the @code{@@headings} command.
address@hidden on off, , The @code{@@headings} Command}.
address@hidden@code{@@headings}}.
At the beginning of a manual or book, pages are not numbered---for
example, the title and copyright pages of a book are not numbered. By
@@ -3991,8 +3994,10 @@
specify the output you want.
address@hidden headings on off
address@hidden @code{@@headings}
@subsection The @code{@@headings} Command
+
address@hidden on address@hidden old name
@findex headings
The @code{@@headings} command is rarely used. It specifies what kind of
@@ -4049,11 +4054,13 @@
@xref{Headings, , Page Headings}, for more information.
address@hidden paragraphindent
address@hidden @code{@@paragraphindent}: Paragraph Indenting
address@hidden @code{@@paragraphindent}
address@hidden @code{@@paragraphindent}: Controlling Paragraph Indentation
+
address@hidden@c old name
address@hidden paragraphindent
@cindex Indenting paragraphs, control of
@cindex Paragraph indentation control
address@hidden paragraphindent
The Texinfo processors may insert whitespace at the beginning of the
first line of each paragraph, thereby indenting that paragraph. You can
@@ -4094,14 +4101,16 @@
fill) paragraphs that contain @code{@@w} or @code{@@*} commands.
address@hidden firstparagraphindent
address@hidden @code{@@firstparagraphindent}
@subsection @code{@@firstparagraphindent}: Indenting After Headings
+
address@hidden@c old name
address@hidden firstparagraphindent
@cindex First paragraph, suppressing indentation of
@cindex Suppressing first paragraph indentation
@cindex Preventing first paragraph indentation
@cindex Indenting, suppressing of first paragraph
@cindex Headings, indentation after
address@hidden firstparagraphindent
As you can see in the present manual, the first paragraph in any
section is not indented by default. Typographically, indentation is a
@@ -4125,7 +4134,7 @@
@item @code{insert}
Include normal paragraph indentation. This respects the paragraph
indentation set by an @code{@@paragraphindent} command
-(@pxref{paragraphindent}).
+(@address@hidden@@paragraphindent}}).
@end table
@code{@@firstparagraphindent} is ignored for HTML and Docbook output.
@@ -4136,12 +4145,14 @@
Header}.
address@hidden exampleindent
address@hidden @code{@@exampleindent}
@subsection @code{@@exampleindent}: Environment Indenting
+
address@hidden@c old name
address@hidden exampleindent
@cindex Indenting environments
@cindex Environment indentation
@cindex Example indentation
address@hidden exampleindent
The Texinfo processors indent each line of @code{@@example} and similar
environments. You can use the @code{@@exampleindent} command to specify
@@ -4447,7 +4458,7 @@
When an @code{@@setchapternewpage} command says to do so, the
@code{@@chapter}, @code{@@unnumbered}, and @code{@@appendix} commands
start new pages in the printed manual; the @code{@@heading} commands
-do not. @xref{setchapternewpage,, @code{@@setchapternewpage}}.
+do not. @address@hidden@@setchapternewpage}}.
Here is a summary:
@@ -4786,7 +4797,7 @@
line break on the part page (but is replaced with a space in the
tables of contents). This part page is always forced to be on an odd
(right-hand) page, regardless of the chapter pagination
-(@pxref{setchapternewpage,, @code{@@setchapternewpage}}).
+(@address@hidden@@setchapternewpage}}).
In the HTML output, the @code{@@part} text is similarly included in
the tables of contents, and a heading is included in the main document
@@ -8705,7 +8716,7 @@
paragraph. You can prevent this on a case-by-case basis by writing
@code{@@noindent} at the beginning of a line, preceding the continuation
text. You can also disable indentation for all paragraphs globally with
address@hidden@@paragraphindent} (@pxref{paragraphindent, Paragraph Indenting}).
address@hidden@@paragraphindent} (@address@hidden@@paragraphindent}}).
It is best to write @code{@@noindent} on a line by itself, since in most
environments, spaces following the command will not be ignored. It's ok
@@ -8770,7 +8781,7 @@
paragraph to be indented. This paragraph, for instance, is indented
using an @code{@@indent} command. The first paragraph of a section is
the most likely place to use @code{@@indent}, to override the normal
-behavior of no indentation there (@pxref{paragraphindent}).
+behavior of no indentation there (@address@hidden@@paragraphindent}}).
It is best to write @code{@@indent} on a line by itself, since in most
environments, spaces following the command will not be ignored. The
@@ -14858,8 +14869,8 @@
@noindent
This looks equivalent to @code{@@headings off}, but for @TeX{}nical
-reasons, it fails with a mysterious error message (@code{Paragraph
-ended before @@headings was complete}).
+reasons, it fails with a mysterious error message (namely,
address@hidden ended before @@headings was complete}).
@item
Macros cannot define macros in the natural way. To do this, you must
@@ -16054,7 +16065,7 @@
@itemize @bullet
@item @address@hidden@@settitle}}.
address@hidden @ref{setchapternewpage, , @code{@@setchapternewpage}}.
address@hidden @address@hidden@@setchapternewpage}}.
@item @ref{Headings}.
@item @ref{Titlepage & Copyright Page}.
@item @ref{Printing Indices & Menus}.
@@ -16971,9 +16982,8 @@
@opindex -p @var{indent}
Set the paragraph indentation style to @var{indent}. The value set by
this option overrides the value set in a Texinfo file by an
address@hidden@@paragraphindent} command (@pxref{paragraphindent,,
address@hidden@@paragraphindent}}). The value of @var{indent} is interpreted
-as follows:
address@hidden@@paragraphindent} command (@address@hidden@@paragraphindent}}).
+The value of @var{indent} is interpreted as follows:
@table @asis
@item @samp{asis}
@@ -20277,7 +20287,7 @@
@item @@exampleindent @var{indent}
Indent example-like environments by @var{indent} number of spaces
-(perhaps 0). @xref{exampleindent,, Paragraph Indenting}.
+(perhaps 0). @address@hidden@@exampleindent}}.
@item @@address@hidden@}
Generate an upside-down exclamation point. @xref{Inserting Accents}.
@@ -20306,7 +20316,7 @@
@item @@firstparagraphindent @var{word}
Control indentation of the first paragraph after section headers
according to @var{word}, one of `none' or `insert'.
address@hidden, @code{@@firstparagraphindent}}.
address@hidden@code{@@firstparagraphindent}}.
@item @@float
Environment to define floating material. Pair with @code{@@end float}.
@@ -20639,7 +20649,7 @@
@item @@paragraphindent @var{indent}
Indent paragraphs by @var{indent} number of spaces (perhaps 0); preserve
source file indentation if @var{indent} is @code{asis}.
address@hidden,, Paragraph Indenting}.
address@hidden@code{@@paragraphindent}}.
@item @@part @var{title}
Begin a group of chapters or appendixes; included in the tables of
@@ -20756,8 +20766,7 @@
@item @@setchapternewpage @var{on-off-odd}
Specify whether chapters start on new pages, and if so, whether on
-odd-numbered (right-hand) new pages. @xref{setchapternewpage, ,
address@hidden@@setchapternewpage}}.
+odd-numbered (right-hand) new pages. @address@hidden@@setchapternewpage}}.
@item @@setcontentsaftertitlepage
Put the table of contents after the @samp{@@end titlepage} even if the
@@ -21740,7 +21749,7 @@
as:
@example
-$Id: texinfo.txi,v 1.509 2013/01/04 01:29:58 karl Exp $
+$Id: texinfo.txi,v 1.510 2013/01/04 18:09:23 karl Exp $
@end example
(This is potentially useful in all sources that use version control,
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/03
- texinfo ChangeLog doc/texinfo.txi,
karl <=
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/05
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/08
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/12
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/13
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/13
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/14
- texinfo ChangeLog doc/texinfo.txi, karl, 2013/01/14