[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo doc/texinfo.txi ChangeLog
|
From: |
karl |
|
Subject: |
texinfo doc/texinfo.txi ChangeLog |
|
Date: |
Wed, 16 Jan 2013 18:20:50 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 13/01/16 18:20:50
Modified files:
doc : texinfo.txi
. : ChangeLog
Log message:
@t for remaining node names
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.527&r2=1.528
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1519&r2=1.1520
Patches:
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.527
retrieving revision 1.528
diff -u -b -r1.527 -r1.528
--- doc/texinfo.txi 15 Jan 2013 23:12:57 -0000 1.527
+++ doc/texinfo.txi 16 Jan 2013 18:20:47 -0000 1.528
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.527 2013/01/15 23:12:57 karl Exp $
address@hidden $Id: texinfo.txi,v 1.528 2013/01/16 18:20:47 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.
@@ -322,7 +322,7 @@
* @t{@@url}:: How to refer to a uniform resource
locator.
* @t{@@cite}:: How to refer to books not in the Info
system.
address@hidden@@xref}
address@hidden@@xref}
* Reference Syntax:: What a reference looks like and requires.
* One Argument:: @code{@@xref} with one argument.
@@ -338,25 +338,25 @@
Indicating Definitions, Commands, etc.
* Useful Highlighting:: Highlighting provides useful information.
-* code:: Indicating program code.
-* kbd:: Showing keyboard input.
-* key:: Specifying keys.
-* samp:: Indicating a literal sequence of characters.
-* verb:: Indicating a verbatim sequence of characters.
-* var:: Indicating metasyntactic variables.
-* env:: Indicating environment variables.
-* file:: Indicating file names.
-* command:: Indicating command names.
-* option:: Indicating option names.
-* dfn:: Specifying definitions.
-* abbr:: Indicating abbreviations.
-* acronym:: Indicating acronyms.
-* indicateurl:: Indicating an example url.
-* email:: Indicating an electronic mail address.
+* @t{@@code}:: Indicating program code.
+* @t{@@kbd}:: Showing keyboard input.
+* @t{@@key}:: Specifying keys.
+* @t{@@samp}:: Indicating a literal sequence of
characters.
+* @t{@@verb}:: Indicating a verbatim sequence of
characters.
+* @t{@@var}:: Indicating metasyntactic variables.
+* @t{@@env}:: Indicating environment variables.
+* @t{@@file}:: Indicating file names.
+* @t{@@command}:: Indicating command names.
+* @t{@@option}:: Indicating option names.
+* @t{@@dfn}:: Specifying definitions.
+* @t{@@abbr}:: Indicating abbreviations.
+* @t{@@acronym}:: Indicating acronyms.
+* @t{@@indicateurl}:: Indicating an example url.
+* @t{@@email}:: Indicating an electronic mail address.
Emphasizing Text
-* emph & strong:: How to emphasize text in Texinfo.
+* @t{@@emph @@strong}:: How to emphasize text in Texinfo.
* Smallcaps:: How to use the small caps font.
* Fonts:: Various font commands for printed output.
@@ -555,9 +555,9 @@
External Macro Processors: Line Directives
-* #line Directive::
-* TeX: #line and @TeX{}.
-* Syntax: #line Syntax Details.
+* @t{#line} Directive::
+* TeX: @t{#line} and @TeX{}.
+* Syntax: @t{#line} Syntax Details.
Include Files
@@ -2989,7 +2989,7 @@
@node @t{@@setfilename}
@subsection @code{@@setfilename}: Set the Output File Name
address@hidden@c old name
address@hidden@c old name
@findex setfilename
@cindex Texinfo requires @code{@@setfilename}
@cindex Output file name, required
@@ -3066,7 +3066,7 @@
@node @t{@@settitle}
@subsection @code{@@settitle}: Set the Document Title
address@hidden@c old name
address@hidden@c old name
@findex settitle
@cindex Document title, specifying
@@ -3144,7 +3144,7 @@
@node @t{@@copying}
@subsection @code{@@copying}: Declare Copying Permissions
address@hidden@c old name
address@hidden@c old name
@findex copying
The @code{@@copying} command should be given very early in the document;
@@ -3222,7 +3222,7 @@
@node @t{@@insertcopying}
@subsection @code{@@insertcopying}: Include Permissions Text
address@hidden@c old name
address@hidden@c old name
@findex insertcopying
@cindex Copying text, including
@cindex Permissions text, including
@@ -3285,7 +3285,7 @@
@node @t{@@titlepage}
@subsection @code{@@titlepage}
address@hidden@c old name
address@hidden@c old name
@cindex Title page
@findex titlepage
@@ -3348,7 +3348,7 @@
@node @t{@@titlefont @@center @@sp}
@subsection @code{@@titlefont}, @code{@@center}, and @code{@@sp}
address@hidden center address@hidden old name
address@hidden center address@hidden old name
@findex titlefont
@findex center
@findex sp @r{(titlepage line spacing)}
@@ -3420,7 +3420,7 @@
@node @t{@@title @@subtitle @@author}
@subsection @code{@@title}, @code{@@subtitle}, and @code{@@author}
address@hidden subtitle address@hidden old name
address@hidden subtitle address@hidden old name
@findex title
@findex subtitle
@findex author
@@ -3573,7 +3573,7 @@
@node Heading Generation
@subsection Heading Generation
address@hidden address@hidden old name
address@hidden address@hidden old name
@cindex Headings, page, begin to appear
@cindex Titlepage end starts headings
@cindex End titlepage starts headings
@@ -3865,7 +3865,7 @@
@node @t{@@documentdescription}
@subsection @code{@@documentdescription}: Summary Text
address@hidden@c old name
address@hidden@c old name
@cindex Document description
@cindex Description of document
@@ -3901,7 +3901,7 @@
@node @t{@@setchapternewpage}
@subsection @code{@@setchapternewpage}: Blank Pages Before Chapters
address@hidden@c old name
address@hidden@c old name
@findex setchapternewpage
@cindex Starting chapters
@cindex Pages, starting odd
@@ -3976,7 +3976,7 @@
@node @t{@@headings}
@subsection The @code{@@headings} Command
address@hidden on address@hidden old name
address@hidden on address@hidden old name
@findex headings
The @code{@@headings} command is rarely used. It specifies what kind of
@@ -4036,7 +4036,7 @@
@node @t{@@paragraphindent}
@subsection @code{@@paragraphindent}: Controlling Paragraph Indentation
address@hidden@c old name
address@hidden@c old name
@findex paragraphindent
@cindex Indenting paragraphs, control of
@cindex Paragraph indentation control
@@ -4083,7 +4083,7 @@
@node @t{@@firstparagraphindent}
@subsection @code{@@firstparagraphindent}: Indenting After Headings
address@hidden@c old name
address@hidden@c old name
@findex firstparagraphindent
@cindex First paragraph, suppressing indentation of
@cindex Suppressing first paragraph indentation
@@ -4127,7 +4127,7 @@
@node @t{@@exampleindent}
@subsection @code{@@exampleindent}: Environment Indenting
address@hidden@c old name
address@hidden@c old name
@findex exampleindent
@cindex Indenting environments
@cindex Environment indentation
@@ -4304,7 +4304,7 @@
@node Chapter Structuring
@chapter Chapter Structuring
address@hidden@c old name
address@hidden@c old name
@cindex Chapter structuring
@cindex Structuring of chapters
@cindex Sectioning
@@ -4462,7 +4462,7 @@
@node @t{@@chapter}
@section @code{@@chapter}: Chapter Structuring
address@hidden@c old name
address@hidden@c old name
@findex chapter
@code{@@chapter} identifies a chapter in the document--the highest
@@ -4504,7 +4504,7 @@
@node @t{@@unnumbered @@appendix}
@section @code{@@unnumbered}, @code{@@appendix}: Chapters with Other Labeling
address@hidden & address@hidden old name
address@hidden & address@hidden old name
@findex unnumbered
@findex appendix
@@ -4529,7 +4529,7 @@
@node @t{@@majorheading @@chapheading}
@section @code{@@majorheading}, @code{@@chapheading}: Chapter-level Headings
address@hidden & address@hidden old name
address@hidden & address@hidden old name
@findex majorheading
@findex chapheading
@@ -4555,7 +4555,7 @@
@node @t{@@section}
@section @code{@@section}: Sections Below Chapters
address@hidden@c old name
address@hidden@c old name
@findex section
An @code{@@section} command identifies a section within a chapter
@@ -4594,7 +4594,7 @@
@node @t{@@unnumberedsec @@appendixsec @@heading}
@section @code{@@unnumberedsec}, @code{@@appendixsec}, @code{@@heading}
address@hidden appendixsec address@hidden old name
address@hidden appendixsec address@hidden old name
@findex unnumberedsec
@findex appendixsec
@findex heading
@@ -4634,7 +4634,7 @@
@node @t{@@subsection}
@section @code{@@subsection}: Subsections Below Sections
address@hidden@c old name
address@hidden@c old name
@findex subsection
Subsections are to sections as sections are to chapters;
@@ -4665,7 +4665,7 @@
@node @t{@@unnumberedsubsec @@appendixsubsec @@subheading}
@section The @code{@@subsection}-like Commands
address@hidden appendixsubsec address@hidden old name
address@hidden appendixsubsec address@hidden old name
@findex unnumberedsubsec
@findex appendixsubsec
@findex subheading
@@ -4695,7 +4695,7 @@
@node @t{@@subsubsection}
@section @code{@@subsection} and Other Subsub Commands
address@hidden@c old name
address@hidden@c old name
@findex subsubsection
@findex unnumberedsubsubsec
@findex appendixsubsubsec
@@ -5239,7 +5239,7 @@
@node @t{@@top} Command
@subsection The @code{@@top} Sectioning Command
address@hidden address@hidden old name
address@hidden address@hidden old name
@anchor{makeinfo address@hidden another old name
@anchor{makeinfo top address@hidden yet another name
@findex top
@@ -5329,7 +5329,7 @@
@node @t{@@anchor}
@section @code{@@anchor}: Defining Arbitrary Cross Reference Targets
address@hidden@c old name
address@hidden@c old name
@findex anchor
@cindex Anchors
@cindex Cross reference targets, arbitrary
@@ -6024,7 +6024,7 @@
@node @t{@@xref}
@section @code{@@xref}
address@hidden@c old name
address@hidden@c old name
@findex xref
@cindex Cross references using @code{@@xref}
@cindex References using @code{@@xref}
@@ -6553,7 +6553,7 @@
@node @t{@@ref}
@section @code{@@ref}
address@hidden@c old name
address@hidden@c old name
@findex ref
@cindex Cross references using @code{@@ref}
@cindex References using @code{@@ref}
@@ -6622,7 +6622,7 @@
@node @t{@@pxref}
@section @code{@@pxref}
address@hidden@c old name
address@hidden@c old name
@findex pxref
@cindex Cross references using @code{@@pxref}
@cindex References using @code{@@pxref}
@@ -6737,7 +6737,7 @@
@node @t{@@inforef}
@section @code{@@inforef}: Cross References to Info-only Material
address@hidden@c old name
address@hidden@c old name
@findex inforef
@cindex Cross references using @code{@@inforef}
@cindex References using @code{@@inforef}
@@ -6817,7 +6817,7 @@
@node @t{@@url}
@section @code{@@url}, @code{@@address@hidden@var{url}[, @var{text}][,
@address@hidden
address@hidden@c old name
address@hidden@c old name
@findex uref
@cindex Uniform resource locator, referring to
@cindex URL, referring to
@@ -6828,11 +6828,10 @@
which control the text that is displayed. In HTML output, @code{@@uref}
produces a link you can follow.
address@hidden
address@hidden@@url} is a synonym for @code{@@uref}. (Originally, @code{@@url}
-had the meaning of @code{@@indicateurl}
-(@pxref{indicateurl,,@code{@@indicateurl}}), but in actual practice it
-was almost always misused. So we've changed the meaning.)
address@hidden @code{@@url} is a synonym for @code{@@uref}.
+(Originally, @code{@@url} had the meaning of @code{@@indicateurl}
+(@address@hidden@@indicateurl}}), but in actual practice it was almost
+always misused. So we've changed the meaning.)
The second argument, if specified, is the text to display (the default
is the url itself); in Info and DVI output, but not in HTML output, the
@@ -6944,14 +6943,14 @@
since any software that tries to detect urls in text already has to
detect them without the @samp{<URL:} to be useful.
-To merely indicate a url without creating a link people can follow, use
address@hidden@@indicateurl} (@pxref{indicateurl, @code{@@indicateurl}}).
+To merely indicate a url without creating a link people can follow,
+use @code{@@indicateurl} (@address@hidden@@indicateurl}}).
@node @t{@@cite}
@section @code{@@address@hidden@address@hidden
address@hidden@c old name
address@hidden@c old name
@findex cite
Use the @code{@@cite} command for the name of a book that lacks a
@@ -6986,6 +6985,7 @@
@node Indicating
@section Indicating Definitions, Commands, etc.
+
@cindex Highlighting text
@cindex Indicating commands, definitions, etc.
@@ -7009,21 +7009,21 @@
@menu
* Useful Highlighting:: Highlighting provides useful information.
-* code:: Indicating program code.
-* kbd:: Showing keyboard input.
-* key:: Specifying keys.
-* samp:: Indicating a literal sequence of characters.
-* verb:: Indicating a verbatim sequence of characters.
-* var:: Indicating metasyntactic variables.
-* env:: Indicating environment variables.
-* file:: Indicating file names.
-* command:: Indicating command names.
-* option:: Indicating option names.
-* dfn:: Specifying definitions.
-* abbr:: Indicating abbreviations.
-* acronym:: Indicating acronyms.
-* indicateurl:: Indicating an example url.
-* email:: Indicating an electronic mail address.
+* @t{@@code}:: Indicating program code.
+* @t{@@kbd}:: Showing keyboard input.
+* @t{@@key}:: Specifying keys.
+* @t{@@samp}:: Indicating a literal sequence of
characters.
+* @t{@@verb}:: Indicating a verbatim sequence of
characters.
+* @t{@@var}:: Indicating metasyntactic variables.
+* @t{@@env}:: Indicating environment variables.
+* @t{@@file}:: Indicating file names.
+* @t{@@command}:: Indicating command names.
+* @t{@@option}:: Indicating option names.
+* @t{@@dfn}:: Specifying definitions.
+* @t{@@abbr}:: Indicating abbreviations.
+* @t{@@acronym}:: Indicating acronyms.
+* @t{@@indicateurl}:: Indicating an example url.
+* @t{@@email}:: Indicating an electronic mail address.
@end menu
@@ -7035,47 +7035,43 @@
@table @code
@item @@address@hidden@address@hidden
Indicate text that is a literal example of a piece of a program.
address@hidden,,@code{@@code}}.
address@hidden@t{@@code}}.
@item @@address@hidden@address@hidden
-Indicate keyboard input.
address@hidden,,@code{@@kbd}}.
+Indicate keyboard input. @address@hidden@@kbd}}.
@item @@address@hidden@address@hidden
Indicate the conventional name for a key on a keyboard.
address@hidden,,@code{@@key}}.
address@hidden@t{@@key}}.
@item @@address@hidden@address@hidden
Indicate text that is a literal example of a sequence of characters.
address@hidden,,@code{@@samp}}.
address@hidden@t{@@samp}}.
@item @@address@hidden@address@hidden
Write a verbatim sequence of characters.
address@hidden,,@code{@@verb}}.
address@hidden@t{@@verb}}.
@item @@address@hidden@address@hidden
-Indicate a metasyntactic variable.
address@hidden,,@code{@@var}}.
+Indicate a metasyntactic variable. @address@hidden@@var}}.
@item @@address@hidden@address@hidden
-Indicate an environment variable.
address@hidden,,@code{@@env}}.
+Indicate an environment variable. @address@hidden@@env}}.
@item @@address@hidden@address@hidden
-Indicate the name of a file.
address@hidden,,@code{@@file}}.
+Indicate the name of a file. @address@hidden@@file}}.
@item @@address@hidden@address@hidden
Indicate the name of a command.
address@hidden,,@code{@@command}}.
address@hidden@t{@@command}}.
@item @@address@hidden@address@hidden
Indicate a command-line option.
address@hidden,,@code{@@option}}.
address@hidden@t{@@option}}.
@item @@address@hidden@address@hidden
Indicate the introductory or defining use of a term.
address@hidden,,@code{@@dfn}}.
address@hidden@t{@@dfn}}.
@item @@address@hidden@address@hidden
Indicate the name of a book. @address@hidden@@cite}}.
@@ -7084,23 +7080,23 @@
Indicate an abbreviation, such as `Comput.'.
@item @@address@hidden@address@hidden
-Indicate an acronym.
address@hidden,,@code{@@acronym}}.
+Indicate an acronym. @address@hidden@@acronym}}.
@item @@address@hidden@address@hidden
Indicate an example (that is, nonfunctional) uniform resource locator.
address@hidden,,@code{@@indicateurl}}. (Use @code{@@url}
-(@address@hidden@@url}}) for live urls.)
address@hidden@t{@@indicateurl}}. (Use @code{@@url} (@address@hidden@@url}})
for
+live urls.)
@item @@address@hidden@var{email-address}[, @address@hidden
-Indicate an electronic mail address.
address@hidden,,@code{@@email}}.
+Indicate an electronic mail address. @address@hidden@@email}}.
@end table
address@hidden code
address@hidden @t{@@code}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex code
@cindex Syntactic tokens, indicating
@@ -7196,8 +7192,10 @@
(@address@hidden@@example}}) and @code{@@code} itself, etc.
address@hidden kbd
address@hidden @t{@@kbd}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex kbd
@cindex Keyboard input
@@ -7276,8 +7274,10 @@
input, write @kbd{@@address@hidden@}} for it.)
address@hidden key
address@hidden @t{@@key}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex key
Use the @code{@@key} command for the conventional name for a key on a
@@ -7344,8 +7344,10 @@
index entries.
address@hidden samp
address@hidden @t{@@samp}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex samp
Use the @code{@@samp} command to indicate text that is a literal example
@@ -7399,8 +7401,10 @@
@end quotation
address@hidden verb
address@hidden @t{@@verb}
@subsection @code{@@address@hidden@address@hidden@address@hidden
+
address@hidden@c old name
@findex verb
@cindex Verbatim in-line text
@@ -7441,8 +7445,10 @@
figure captions.
address@hidden var
address@hidden @t{@@var}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex var
Use the @code{@@var} command to indicate metasyntactic variables. A
@@ -7453,7 +7459,7 @@
Do not use @code{@@var} for the names of normal variables in computer
programs. These are specific names, so @code{@@code} is correct for
-them (@pxref{code}). For example, the Emacs Lisp variable
+them (@t{@@code}). For example, the Emacs Lisp variable
@code{texinfo-tex-command} is not a metasyntactic variable; it is
properly formatted using @code{@@code}.
@@ -7524,8 +7530,10 @@
@c to output the @code{<@dots{}>} format if you wish.)
address@hidden env
address@hidden @t{@@env}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex env
Use the @code{@@env} command to indicate environment variables, as
@@ -7545,8 +7553,10 @@
@end quotation
address@hidden file
address@hidden @t{@@file}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex file
Use the @code{@@file} command to indicate text that is the name of a
@@ -7571,8 +7581,10 @@
@end quotation
address@hidden command
address@hidden @t{@@command}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex command
@cindex Command names, indicating
@cindex Program names, indicating
@@ -7599,8 +7611,10 @@
you should use either @code{@@samp} or @code{@@code} at your discretion.
address@hidden option
address@hidden @t{@@option}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex option
Use the @code{@@option} command to indicate a command-line option; for
@@ -7619,8 +7633,10 @@
@end quotation
address@hidden dfn
address@hidden @t{@@dfn}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex dfn
Use the @code{@@dfn} command to identify the introductory or defining
@@ -7648,8 +7664,10 @@
information of a definition---it should make the meaning clear.
address@hidden abbr
address@hidden @t{@@abbr}
@subsection @code{@@address@hidden@var{abbreviation}[, @address@hidden
+
address@hidden@c old name
@findex abbr
@cindex Abbreviations, tagging
@@ -7690,8 +7708,10 @@
more on the usage of these two commands.
address@hidden acronym
address@hidden @t{@@acronym}
@subsection @code{@@address@hidden@var{acronym}[, @address@hidden
+
address@hidden@c old name
@findex acronym
@cindex NASA, as acronym
@@ -7775,8 +7795,10 @@
@end itemize
address@hidden indicateurl
address@hidden @t{@@indicateurl}
@subsection @code{@@address@hidden@address@hidden
+
address@hidden@c old name
@findex indicateurl
@cindex Uniform resource locator, indicating
@cindex URL, indicating
@@ -7799,10 +7821,13 @@
@end display
The output from @code{@@indicateurl} is more or less like that of
address@hidden@@samp} (@pxref{samp,,@code{@@samp}}).
address@hidden@@samp} (@address@hidden@@samp}}).
address@hidden email
+
address@hidden @t{@@email}
@subsection @code{@@address@hidden@var{email-address}[, @address@hidden
+
address@hidden@c old name
@findex email
Use the @code{@@email} command to indicate an electronic mail address.
@@ -7819,7 +7844,9 @@
Send bug reports to @@address@hidden@@@@address@hidden,
suggestions to the @@address@hidden@@@@gnu.org, same address@hidden
@end example
+
@noindent produces
+
@display
Send bug reports to @email{bug-texinfo@@gnu.org},
suggestions to the @email{bug-texinfo@@gnu.org, same place}.
@@ -7840,17 +7867,19 @@
@code{@@r} command, has any regular use.
@menu
-* emph & strong:: How to emphasize text in Texinfo.
+* @t{@@emph @@strong}:: How to emphasize text in Texinfo.
* Smallcaps:: How to use the small caps font.
* Fonts:: Various font commands for printed output.
@end menu
address@hidden emph & strong
address@hidden @t{@@emph @@strong}
@subsection @code{@@address@hidden@address@hidden and
@code{@@address@hidden@address@hidden
address@hidden Emphasizing text, font for
+
address@hidden & address@hidden oldname
@findex emph
@findex strong
address@hidden Emphasizing text, font for
The @code{@@emph} and @code{@@strong} commands are for emphasis;
@code{@@strong} is stronger. In printed output, @code{@@emph} produces
@@ -8148,7 +8177,7 @@
@node @t{@@quotation}
@section @code{@@quotation}: Block Quotations
address@hidden@c old name
address@hidden@c old name
@cindex Quotations
@findex quotation
@@ -8280,7 +8309,7 @@
@node @t{@@example}
@section @code{@@example}: Example Text
address@hidden@c old name
address@hidden@c old name
@findex example
@cindex Examples, formatting them
@cindex Formatting examples
@@ -8343,7 +8372,7 @@
If you want to embed code fragments within sentences, instead of
displaying them, use the @code{@@code} command or its relatives
-(@pxref{code,,@code{@@code}}).
+(@address@hidden@@code}}).
If you wish to write a ``comment'' on a line of an example in the
normal roman font, you can use the @code{@@r} command (@pxref{Fonts}).
@@ -8352,7 +8381,7 @@
@node @t{@@verbatim}
@section @code{@@verbatim}: Literal Text
address@hidden@c old name
address@hidden@c old name
@findex verbatim
@cindex Verbatim environment
@@ -8422,7 +8451,7 @@
@node @t{@@verbatiminclude}
@section @code{@@verbatiminclude} @var{file}: Include a File Verbatim
address@hidden@c old name
address@hidden@c old name
@findex verbatiminclude
@cindex Verbatim, include file
@cindex Including a file verbatim
@@ -8460,7 +8489,7 @@
@node @t{@@lisp}
@section @code{@@lisp}: Marking a Lisp Example
address@hidden@c old name
address@hidden@c old name
@findex lisp
@cindex Lisp example
@@ -8486,7 +8515,7 @@
@node @t{@@address@hidden
@section @code{@@address@hidden Block Commands
address@hidden@c old name
address@hidden@c old name
@findex smallexample
@findex smallformat
@findex smalllisp
@@ -8543,7 +8572,7 @@
@node @t{@@display}
@section @code{@@display}: Examples Using the Text Font
address@hidden@c old name
address@hidden@c old name
@findex display
@cindex Display formatting
@@ -8573,7 +8602,7 @@
@node @t{@@format}
@section @code{@@format}: Examples Using the Full Line Width
address@hidden@c old name
address@hidden@c old name
@findex format
The @code{@@format} command is similar to @code{@@display}, except it
@@ -8596,7 +8625,7 @@
@node @t{@@exdent}
@section @code{@@exdent}: Undoing a Line's Indentation
address@hidden@c old name
address@hidden@c old name
@findex exdent
@cindex Indentation undoing
@@ -8641,7 +8670,7 @@
@node @t{@@flushleft @@flushright}
@section @code{@@flushleft} and @code{@@flushright}
address@hidden & address@hidden old name
address@hidden & address@hidden old name
@findex flushleft
@findex flushright
@cindex Ragged right, without filling
@@ -8705,7 +8734,7 @@
@node @t{@@raggedright}
@section @code{@@raggedright}: Ragged Right Text
address@hidden@c old name
address@hidden@c old name
@findex raggedright
@cindex Ragged right, with filling
@@ -8748,7 +8777,7 @@
@node @t{@@noindent}
@section @code{@@noindent}: Omitting Indentation
address@hidden@c old name
address@hidden@c old name
@findex noindent
@cindex Omitting indentation
@cindex Suppressing indentation
@@ -8814,7 +8843,7 @@
@node @t{@@indent}
@section @code{@@indent}: Forcing Indentation
address@hidden@c old name
address@hidden@c old name
@findex indent
@cindex Forcing indentation
@cindex Inserting indentation
@@ -8844,7 +8873,7 @@
@node @t{@@cartouche}
@section @code{@@cartouche}: Rounded Rectangles
address@hidden@c old name
address@hidden@c old name
@findex cartouche
@cindex Box with rounded corners
@cindex Rounded rectangles, around text
@@ -8978,7 +9007,7 @@
@node @t{@@itemize}
@section @code{@@itemize}: Making an Itemized List
address@hidden@c old name
address@hidden@c old name
@findex itemize
@cindex Itemization
@@ -9091,7 +9120,7 @@
@node @t{@@enumerate}
@section @code{@@enumerate}: Making a Numbered or Lettered List
address@hidden@c old name
address@hidden@c old name
@findex enumerate
@cindex Enumeration
@@ -9228,7 +9257,7 @@
@node @t{@@table}
@subsection Using the @code{@@table} Command
address@hidden@c old name
address@hidden@c old name
@cindex Definition lists, typesetting
Use the @code{@@table} command to produce two-column tables. It is
@@ -9313,7 +9342,7 @@
@node @t{@@ftable @@vtable}
@subsection @code{@@ftable} and @code{@@vtable}
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex ftable
@findex vtable
@cindex Tables with indexing
@@ -9342,7 +9371,7 @@
@node @t{@@itemx}
@subsection @code{@@itemx}: Second and Subsequent Items
address@hidden@c old name
address@hidden@c old name
@cindex Two named items for @code{@@table}
@findex itemx
@@ -9578,7 +9607,7 @@
@node @t{@@float}
@subsection @code{@@float} address@hidden,@var{label}]: Floating Material
address@hidden@c old name
address@hidden@c old name
@findex float
@cindex Float environment
@@ -9644,7 +9673,7 @@
@node @t{@@caption @@shortcaption}
@subsection @code{@@caption} & @code{@@shortcaption}
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex caption
@findex shortcaption
@cindex Captions, for floats
@@ -9701,7 +9730,7 @@
@node @t{@@listoffloats}
@subsection @code{@@listoffloats}: Tables of Contents for Floats
address@hidden@c old name
address@hidden@c old name
@findex listoffloats
@cindex List of floats
@cindex Floats, list of
@@ -10639,9 +10668,9 @@
However, Texinfo uses the comma as a special character only in one
context: to separate arguments to those Texinfo commands, such as
address@hidden@@acronym} (@pxref{acronym}) and @code{@@xref} (@pxref{Cross
-References}), as well as user-defined macros (@pxref{Defining
-Macros}), which take more than one argument.
address@hidden@@acronym} (@address@hidden@@acronym}}) and @code{@@xref}
+(@pxref{Cross References}), as well as user-defined macros
+(@pxref{Defining Macros}), which take more than one argument.
Since a comma character would confuse Texinfo's parsing for these
commands, you must use the command @samp{@@address@hidden@}} instead if you
want
@@ -10964,7 +10993,7 @@
@node @t{@@frenchspacing}
@subsection @code{@@frenchspacing} @var{val}: Control Sentence Spacing
address@hidden@c old name
address@hidden@c old name
@findex frenchspacing
@cindex French spacing
@cindex Sentences, spacing after
@@ -11009,7 +11038,7 @@
@node @t{@@dmn}
@subsection @code{@@address@hidden@address@hidden: Format a Dimension
address@hidden@c old name
address@hidden@c old name
@cindex Thin space between number, dimension
@cindex Dimension formatting
@cindex Format a dimension
@@ -11353,7 +11382,7 @@
@node Inserting Math
@section @code{@@math}: Inserting Mathematical Expressions
address@hidden@c old name
address@hidden@c old name
@findex math
@cindex Mathematical expressions, inserting
@cindex Formulas, mathematical
@@ -11466,7 +11495,7 @@
@node @t{@@TeX @@LaTeX}
@subsection @code{@@address@hidden@} (@TeX{}) and @code{@@address@hidden@}
(@LaTeX{})
address@hidden@c old name
address@hidden@c old name
@findex TeX
@findex LaTeX
@cindex Logos, @TeX{}
@@ -11491,7 +11520,7 @@
@node @t{@@copyright}
@subsection @code{@@address@hidden@}} (@copyright{})
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex copyright
@cindex Copyright symbol
@@ -11506,7 +11535,7 @@
@node @t{@@registeredsymbol}
@subsection @code{@@address@hidden@}} (@registeredsymbol{})
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex registeredsymbol
@cindex Registered symbol
@@ -11518,7 +11547,7 @@
@node @t{@@dots}
@subsection @code{@@dots} (@dots{}) and @code{@@enddots} (@enddots{})
address@hidden@c old name
address@hidden@c old name
@findex dots
@findex enddots
@cindex Inserting dots
@@ -11526,7 +11555,7 @@
@cindex Dots, inserting
@cindex Ellipsis, inserting
address@hidden address@hidden old name
address@hidden address@hidden old name
An @dfn{ellipsis} (a sequence of dots) would be spaced wrong when
typeset as a string of periods, so a special command is used in
@@ -11550,7 +11579,7 @@
@node @t{@@bullet}
@subsection @code{@@bullet} (@bullet{})
address@hidden@c old name
address@hidden@c old name
@findex bullet
Use the @code{@@address@hidden@}} command to generate a large round dot, or
@@ -11565,7 +11594,7 @@
@node @t{@@euro}
@subsection @code{@@euro} (@euro{}): Euro Currency Symbol
address@hidden@c old name
address@hidden@c old name
@findex euro
@cindex Euro symbol
@@ -11600,7 +11629,7 @@
@node @t{@@pounds}
@subsection @code{@@pounds} (@pounds{}): Pounds Sterling
address@hidden@c old name
address@hidden@c old name
@findex pounds
@cindex Pounds symbol
@@ -11612,7 +11641,7 @@
@node @t{@@textdegree}
@subsection @code{@@textdegree} (@textdegree{}): Degrees Symbol
address@hidden@c old name
address@hidden@c old name
@findex textdegree
@cindex Degree symbol
@@ -11624,7 +11653,7 @@
@node @t{@@minus}
@subsection @code{@@minus} (@minus{}): Inserting a Minus Sign
address@hidden@c old name
address@hidden@c old name
@findex minus
@cindex Minus sign
@@ -11664,7 +11693,7 @@
@node @t{@@geq @@leq}
@subsection @code{@@geq} (@geq{}) and @code{@@leq} (@leq{}): Inserting
Relations
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex geq
@findex leq
@@ -11739,7 +11768,7 @@
@node @t{@@result}
@subsection @code{@@address@hidden@}} (@result{}): Result of an Expression
address@hidden@c old name
address@hidden@c old name
@findex result
@cindex Result of an expression
@cindex Indicating evaluation
@@ -11767,7 +11796,7 @@
@node @t{@@expansion}
@subsection @code{@@address@hidden@}} (@expansion{}): Indicating an Expansion
address@hidden@c old name
address@hidden@c old name
@cindex Expansion, indicating
@cindex Macro expansion, indicating
@findex expansion
@@ -11820,7 +11849,7 @@
@node @t{@@print}
@subsection @code{@@address@hidden@}} (@print{}): Indicating Generated Output
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex print
@cindex Printed output, indicating
@@ -11863,7 +11892,7 @@
@node @t{@@error}
@subsection @code{@@address@hidden@}} (@error{}): Indicating an Error Message
address@hidden address@hidden old name
address@hidden address@hidden old name
@cindex Error message, indicating
@findex error
@@ -11941,7 +11970,7 @@
@node @t{@@point}
@subsection @code{@@address@hidden@}} (@point{}): Indicating Point in a Buffer
address@hidden address@hidden old name
address@hidden address@hidden old name
@cindex Point, indicating in a buffer
@findex point
@@ -12182,7 +12211,7 @@
@node @t{@@- @@hyphenation}
@section @code{@@-} and @code{@@hyphenation}: Helping @TeX{} Hyphenate
address@hidden and address@hidden old name
address@hidden and address@hidden old name
@findex - @r{(discretionary hyphen)}
@findex hyphenation
@cindex Hyphenation, helping @TeX{} do
@@ -12219,7 +12248,7 @@
@node @t{@@allowcodebreaks}
@section @code{@@allowcodebreaks}: Control Line Breaks in @code{@@code}
address@hidden@c old name
address@hidden@c old name
@findex allowcodebreaks
@cindex Breaks, within @code{@@code}
@cindex -, breakpoint within @code{@@code}
@@ -12230,7 +12259,7 @@
Ordinarily, @TeX{} considers breaking lines at @samp{-} and @samp{_}
characters within @code{@@code} and related commands
-(@pxref{code,,@code{@@code}}), more or less as if they were ``empty''
+(@address@hidden@@code}}), more or less as if they were ``empty''
hyphenation points.
This is necessary since many manuals, especially for Lisp-family
@@ -12260,7 +12289,7 @@
@node @t{@@w}
@section @code{@@address@hidden@address@hidden: Prevent Line Breaks
address@hidden@c old name
address@hidden@c old name
@findex w @r{(prevent line break)}
@cindex Line breaks, preventing
@@ -12306,7 +12335,7 @@
@node @t{@@tie}
@section @code{@@address@hidden@}}: Inserting an Unbreakable Space
address@hidden@c old name
address@hidden@c old name
@findex tie @r{(unbreakable interword space)}
@cindex Tied space
@cindex Non-breakable space, variable
@@ -12347,7 +12376,7 @@
@node @t{@@sp}
@section @code{@@sp} @var{n}: Insert Blank Lines
address@hidden@c old name
address@hidden@c old name
@findex sp @r{(line spacing)}
@cindex Space, inserting vertical
@cindex Blank lines
@@ -12371,7 +12400,7 @@
@node @t{@@page}
@section @code{@@page}: Start a New Page
address@hidden@c old name
address@hidden@c old name
@findex page
@cindex Page breaks, forcing
@@ -12385,7 +12414,7 @@
@node @t{@@group}
@section @code{@@group}: Prevent Page Breaks
address@hidden@c old name
address@hidden@c old name
@findex group
@cindex Group (hold text together vertically)
@cindex Holding text together vertically
@@ -12444,7 +12473,7 @@
@node @t{@@need}
@section @code{@@need @var{mils}}: Prevent Page Breaks
address@hidden@c old name
address@hidden@c old name
@findex need
@cindex Need space at page bottom
@cindex Mils, argument to @code{@@need}
@@ -13655,7 +13684,7 @@
@node @t{@@documentencoding}
@section @code{@@documentencoding @var{enc}}: Set Input Encoding
address@hidden@c old name
address@hidden@c old name
@findex documentencoding
@cindex Encoding, declaring
@cindex Input encoding, declaring
@@ -14120,7 +14149,7 @@
@node @t{@@set @@clear @@value}
@section @code{@@set}, @code{@@clear}, and @code{@@value}
address@hidden clear address@hidden old name
address@hidden clear address@hidden old name
You can direct the Texinfo formatting commands to format or ignore parts
of a Texinfo file with the @code{@@set}, @code{@@clear}, @code{@@ifset},
and @code{@@ifclear} commands.
@@ -14156,7 +14185,7 @@
@node @t{@@set @@value}
@subsection @code{@@set} and @code{@@value}
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex set
@findex value
@findex clear
@@ -14254,7 +14283,7 @@
@node @t{@@ifset @@ifclear}
@subsection @code{@@ifset} and @code{@@ifclear}
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex ifset
When a @var{flag} is set, the Texinfo formatting commands format text
@@ -14327,7 +14356,7 @@
@node @t{@@value} Example
@subsection @code{@@value} Example
address@hidden address@hidden old name
address@hidden address@hidden old name
You can use the @code{@@value} command to minimize the number of
places you need to change when you record an update to a manual.
@@ -15046,7 +15075,7 @@
@node @t{@@alias}
@section @samp{@@alias @address@hidden
address@hidden@c old name
address@hidden@c old name
@cindex Aliases, command
@cindex Command aliases
@findex alias
@@ -15097,7 +15126,7 @@
@node @t{@@definfoenclose}
@section @code{@@definfoenclose}: Customized Highlighting
address@hidden@c old name
address@hidden@c old name
@cindex Highlighting, customized
@cindex Customized highlighting
@findex definfoenclose
@@ -15209,13 +15238,13 @@
@samp{#line} directive. Texinfo supports this.
@menu
-* #line Directive::
-* TeX: #line and @TeX{}.
-* Syntax: #line Syntax Details.
+* @t{#line} Directive::
+* TeX: @t{#line} and @TeX{}.
+* Syntax: @t{#line} Syntax Details.
@end menu
address@hidden #line Directive
address@hidden @t{#line} Directive
@subsection @samp{#line} Directive
@cindex @samp{#line} directive
@@ -15264,7 +15293,7 @@
disabled inside verbatim blocks.
address@hidden #line and @TeX{}
address@hidden @t{#line} and @TeX{}
@subsection @samp{#line} and @TeX{}
@cindex @TeX{} and @samp{#line} directives
@@ -15307,8 +15336,9 @@
Advantages}).
address@hidden #line Syntax Details
address@hidden @t{#line} Syntax Details
@subsection @samp{#line} Syntax Details
+
@cindex @samp{#line} syntax details
@cindex Syntax details, @samp{#line}
@cindex Regular expression, for @samp{#line}
@@ -15344,8 +15374,7 @@
@hashchar{} 1
@end example
-The possible solutions are described above (@pxref{#line Directive,,
address@hidden Directive}).
+The possible solutions are described above (@address@hidden Directive}).
@node Include Files
@@ -16422,7 +16451,7 @@
@node @t{@@smallbook}
@section @code{@@smallbook}: Printing ``Small'' Books
address@hidden@c old name
address@hidden@c old name
@findex smallbook
@cindex Small book size
@cindex Book, printing small
@@ -18396,7 +18425,7 @@
@node @t{makeinfo} Advantages
@subsection @code{makeinfo} Advantages
address@hidden address@hidden old name
address@hidden address@hidden old name
The @code{makeinfo} utility creates an Info file from a Texinfo source
providing better error messages than either of the Emacs formatting
@@ -19735,7 +19764,7 @@
Any @code{@@acronym}, @code{@@abbr}, @code{@@email}, and
@code{@@image} commands are replaced by their first argument. (For
these commands, all subsequent arguments are optional, and ignored
-here.) @xref{acronym}, and @ref{email}, and @ref{Images}.
+here.) @address@hidden@@acronym}}, and @address@hidden@@email}}, and
@ref{Images}.
Any other command is an error, and the result is unspecified.
@@ -20110,12 +20139,12 @@
respectively: @AA{}, @aa{}. @xref{Inserting Accents}.
@item @@address@hidden@address@hidden
-Indicate a general abbreviation, such as `Comput.'. @xref{abbr,,
address@hidden
+Indicate a general abbreviation, such as `Comput.'.
address@hidden@t{@@abbr}}.
@item @@address@hidden@address@hidden
Indicate an acronym in all capital letters, such as `NASA'.
address@hidden,, @code{acronym}}.
address@hidden@t{@@acronym}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20249,8 +20278,7 @@
@item @@address@hidden@address@hidden
Indicate an expression, a syntactically complete token of a program,
-or a program name. Unquoted in Info output. @xref{code, ,
address@hidden@@code}}.
+or a program name. Unquoted in Info output. @address@hidden@@code}}.
@item @@codequotebacktick @var{on-off}
@itemx @@codequoteundirected @var{on-off}
@@ -20262,8 +20290,7 @@
be taken as an argument separator. @xref{Inserting a Comma}.
@item @@address@hidden@address@hidden
-Indicate a command name, such as @command{ls}.
address@hidden,, @code{@@command}}.
+Indicate a command name, such as @command{ls}. @address@hidden@@command}}.
@item @@comment @var{comment}
Begin a comment in Texinfo. The rest of the line does not appear in
@@ -20424,8 +20451,7 @@
@xref{Master Menu Parts}.
@item @@address@hidden@address@hidden
-Indicate the introductory or defining use of a term. @xref{dfn, ,
address@hidden@@dfn}}.
+Indicate the introductory or defining use of a term. @address@hidden@@dfn}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20479,8 +20505,7 @@
@address@hidden@@dots}}.
@item @@address@hidden@var{address}[, @address@hidden
-Indicate an electronic mail address.
address@hidden, , @code{@@email}}.
+Indicate an electronic mail address. @address@hidden@@email}}.
@item @@address@hidden@address@hidden
Emphasize @var{text}, by using @emph{italics} where possible, and
@@ -20501,7 +20526,7 @@
@item @@address@hidden@address@hidden
Indicate an environment variable name, such as @env{PATH}.
address@hidden,, @code{@@env}}.
address@hidden@t{@@env}}.
@item @@address@hidden@}
Indicate to the reader the exact equivalence of two forms with a
@@ -20549,8 +20574,8 @@
glyph: @address@hidden @address@hidden@@expansion}}.
@item @@address@hidden@address@hidden
-Highlight the name of a file, buffer, node, directory, etc. @xref{file, ,
address@hidden@@file}}.
+Highlight the name of a file, buffer, node, directory, etc.
address@hidden@t{@@file}}.
@item @@finalout
Prevent @TeX{} from printing large black warning rectangles beside
@@ -20729,7 +20754,7 @@
@item @@address@hidden@address@hidden
Indicate text that is a uniform resource locator for the World Wide
-Web. @xref{indicateurl, , @code{@@indicateurl}}.
+Web. @address@hidden@@indicateurl}}.
@item @@address@hidden@var{node-name}, address@hidden, @address@hidden
Make a cross reference to an Info file for which there is no printed
@@ -20770,15 +20795,15 @@
@address@hidden@@itemx}}.
@item @@address@hidden@address@hidden
-Indicate characters of input to be typed by users. @xref{kbd,, @code{@@kbd}}.
+Indicate characters of input to be typed by users. @address@hidden@@kbd}}.
@item @@kbdinputstyle @var{style}
Specify when @code{@@kbd} should use a font distinct from
address@hidden@@code}: @code{code}, @code{distinct}, @code{example}.
address@hidden,, @code{@@kbd}}.
address@hidden@@code} according to @var{style}: @code{code}, @code{distinct},
address@hidden @address@hidden@@kbd}}.
@item @@address@hidden@address@hidden
-Indicate the name of a key on a keyboard. @xref{key, , @code{@@key}}.
+Indicate the name of a key on a keyboard. @address@hidden@@key}}.
@item @@kindex @var{entry}
Add @var{entry} to the index of keys.
@@ -20871,8 +20896,8 @@
@ogonek{a}. @xref{Inserting Accents}.
@item @@address@hidden@address@hidden
-Indicate a command-line option, such as @option{-l} or @option{--help}.
address@hidden,, @code{@@option}}.
+Indicate a command-line option, such as @option{-l} or
address@hidden @address@hidden@@option}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20978,7 +21003,7 @@
@item @@address@hidden@address@hidden
Indicate a literal example of a sequence of characters, in general.
-Quoted in Info output. @xref{samp, , @code{@@samp}}.
+Quoted in Info output. @address@hidden@@samp}}.
@item @@address@hidden@address@hidden
Set @var{text} in a @sansserif{sans serif} font if possible. No
@@ -21260,13 +21285,12 @@
@item @@address@hidden@address@hidden
Highlight a metasyntactic variable, which is something that stands for
-another piece of text. @xref{var, , Indicating Metasyntactic
-Variables}.
+another piece of text. @address@hidden@@var}}.
@item @@address@hidden@var{delim} @var{literal} @address@hidden
Output @var{literal}, delimited by the single character @var{delim},
exactly as is (in the fixed-width font), including any whitespace or
-Texinfo special characters. @xref{verb,,@code{verb}}.
+Texinfo special characters. @address@hidden@@verb}}.
@item @@verbatim
Output the text of the environment exactly as is (in the fixed-width
@@ -21977,7 +22001,7 @@
as:
@example
-$Id: texinfo.txi,v 1.527 2013/01/15 23:12:57 karl Exp $
+$Id: texinfo.txi,v 1.528 2013/01/16 18:20:47 karl Exp $
@end example
(This is potentially useful in all sources that use version control,
@@ -22944,7 +22968,7 @@
@node Running @t{Info-validate}
@section Finding Badly Referenced Nodes
address@hidden address@hidden old name
address@hidden address@hidden old name
@findex Info-validate
@cindex Nodes, checking for badly referenced
@cindex Checking for badly referenced nodes
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1519
retrieving revision 1.1520
diff -u -b -r1.1519 -r1.1520
--- ChangeLog 15 Jan 2013 23:07:54 -0000 1.1519
+++ ChangeLog 16 Jan 2013 18:20:49 -0000 1.1520
@@ -1,3 +1,7 @@
+2013-01-16 Karl Berry <address@hidden>
+
+ * doc/texinfo.txi (Marking Text): remaining node names needing @t.
+
2013-01-15 Karl Berry <address@hidden>
* po_document/LINGUAS: es.us-ascii is back, paperwork executed
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- texinfo doc/texinfo.txi ChangeLog,
karl <=