[5245] doc tweaks

[karl]

Revision: 5245
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5245
Author:   karl
Date:     2013-03-20 23:24:56 +0000 (Wed, 20 Mar 2013)
Log Message:
-----------
doc tweaks

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/NEWS
    trunk/README-hacking
    trunk/doc/texinfo.tex
    trunk/doc/texinfo.txi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2013-03-20 23:22:05 UTC (rev 5244)
+++ trunk/ChangeLog     2013-03-20 23:24:56 UTC (rev 5245)
@@ -1,3 +1,11 @@
+2013-03-20  Karl Berry  <address@hidden>
+
+       Minor doc tweaks.
+       * NEWS: more technalities about the macro-expansion incompatibility.
+       * README-hacking: call change_perl_modules_version.sh for release.
+       * doc/texinfo.txi: wording around PDF items.
+       * doc/texinfo.tex: typos in comment.
+
 2013-03-20  Eli Zaretskii  <address@hidden>
 
        * Makefile.am (SUBDIRS): If HOST_IS_WINDOWS, add 'info' to SUBDIRS

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS  2013-03-20 23:22:05 UTC (rev 5244)
+++ trunk/NEWS  2013-03-20 23:24:56 UTC (rev 5245)
@@ -106,10 +106,13 @@
     added.  (Both old and new implementations preserve blank lines that
     are present.)
     
-  . The old implementation did not consider ends of lines from expansion
-    of an @macro definition to end an @-command line-delimited argument
-    (@chapter, @center, etc.).  This is no longer the case.  (A detailed
-    example is in the manual, node Macro Details.)
+  . The old implementation processed macros in place, formatting the
+    replacement text with the output.  Now the replacement text is
+    textually substituted as Texinfo source.  A consequence of the old
+    behavior is that ends of lines from expansion of an @macro
+    definition did not end an @-command line-delimited argument
+    (@chapter, @center, etc.).  Now they do.  (A detailed example is in
+    the manual, node Macro Details.)
 
 * pod2texi is a new (Perl) program that uses the capabilities of
   texi2any to translate Perl pod documentation to Texinfo.

Modified: trunk/README-hacking
===================================================================
--- trunk/README-hacking        2013-03-20 23:22:05 UTC (rev 5244)
+++ trunk/README-hacking        2013-03-20 23:24:56 UTC (rev 5245)
@@ -95,6 +95,7 @@
 
 - Official releases only:
 version number in texi2dvi, texi2pdf, txirefcard.tex.
+(cd tp && ./maintain/change_perl_modules_version.sh auto)
 sync texi2html/test/ results with tp/.
 ensure building standalone modules for CPAN still works.
 make dvi and fix underfull/overfull boxes.

Modified: trunk/doc/texinfo.tex
===================================================================
--- trunk/doc/texinfo.tex       2013-03-20 23:22:05 UTC (rev 5244)
+++ trunk/doc/texinfo.tex       2013-03-20 23:24:56 UTC (rev 5245)
@@ -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{2013-03-14.08}
+\def\texinfoversion{2013-03-19.11}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -4211,9 +4211,10 @@
 
 % @ifset VAR ... @end ifset reads the `...' iff VAR has been defined
 % with @set.
+% 
+% To get the special treatment we need for address@hidden ifset,' we call
+% \makecond and then redefine.
 %
-% To get special treatment of address@hidden ifset,' call \makeond and the 
redefine.
-%
 \makecond{ifset}
 \def\ifset{\parsearg{\doifset{\let\next=\ifsetfail}}}
 \def\doifset#1#2{%

Modified: trunk/doc/texinfo.txi
===================================================================
--- trunk/doc/texinfo.txi       2013-03-20 23:22:05 UTC (rev 5244)
+++ trunk/doc/texinfo.txi       2013-03-20 23:24:56 UTC (rev 5245)
@@ -972,8 +972,8 @@
 platform-independent and easily viewable, among other design goals;
 @uref{http://en.wikipedia.org/wiki/Portable_Document_Format} and
 @uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} have some
-background.  By default, Texinfo uses the @command{pdftex} program, a
-variant of @TeX{}, to output PDF; see
+background.  By default, Texinfo uses the @command{pdftex} program, an
+extension of @TeX{}, to output PDF; see
 @uref{http://tug.org/applications/pdftex}.  @xref{PDF Output}.
 
 @item Docbook
@@ -6837,8 +6837,8 @@
 
 @anchor{url} @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.)
+(@address@hidden@@indicateurl}}), but in 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
@@ -13684,11 +13684,11 @@
 @code{@@documentlanguage} also changes @TeX{}'s current hyphenation
 patterns, if the @TeX{} program being run has the necessary support
 included.  This will generally not be the case for @command{tex}
-itself, but will often be the case for recent distributions of
-extended @TeX{} programs @command{etex} (DVI output) and
address@hidden (PDF output), such as @TeX{} Live 2008.
address@hidden will use the extended @TeX{}s if they are available
-(@pxref{Format with @t{texi2dvi}}).
+itself, but will usually be the case for up-to-date distributions of
+the extended @TeX{} programs @command{etex} (DVI output) and
address@hidden (PDF output).  @command{texi2dvi} will use the
+extended @TeX{}s if they are available (@pxref{Format with
address@hidden).
 
 In September 2006, the W3C Internationalization Activity released a
 new recommendation for specifying languages:
@@ -16721,8 +16721,9 @@
 reader}.  (It can also preview PostScript documents.)
 
 @item
-A freely available standalone @uref{http://www.foolabs.com/xpdf/,
-PDF reader} for the X window system.
address@hidden, a freely available standalone
address@hidden://www.foolabs.com/xpdf/, PDF reader} for the X window
+system.
 
 @item
 @uref{http://partners.adobe.com/asn/acrobat/sdk/public/docs/, PDF definition}.
@@ -16731,10 +16732,10 @@
 
 At present, Texinfo does not provide @samp{@@ifpdf} or @samp{@@pdf}
 commands as for the other output formats, since PDF documents contain
-many internal links that would be hard or impossible to get right at
-the Texinfo source level.
+many internal low-level offsets and references that would be hard or
+impossible to get right at the Texinfo source level.
 
-PDF files require special software to be displayed, unlike the plain
+PDF files require dedicated software to be displayed, unlike the plain
 ASCII formats (Info, HTML) that Texinfo supports.  They also tend to
 be much larger than the DVI files output by @TeX{} by default.
 Nevertheless, a PDF file does define an actual typeset document in a