texinfo/doc texinfo.txi,1.33,1.34

[karl]

Update of /cvsroot/texinfo/texinfo/doc
In directory sheep:/tmp/cvs-serv12997

Modified Files:
        texinfo.txi 
Log Message:
(Refilling Paragraphs): @ignore this, just
describe better in the summary.
(Obtaining TeX): make a section of Hardcopy,
instead of its own appendix.


Index: texinfo.txi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.33
retrieving revision 1.34
diff -C2 -d -r1.33 -r1.34
*** texinfo.txi 27 Feb 2004 18:09:53 -0000      1.33
--- texinfo.txi 13 Mar 2004 16:06:16 -0000      1.34
***************
*** 164,170 ****
  * Headings::                    How to write page headings and footings.
  * Catching Mistakes::           How to find formatting mistakes.
- * Refilling Paragraphs::        All about paragraph refilling.
  * Command Syntax::              A description of @@-Command syntax.
- * Obtaining TeX::               How to Obtain @TeX{}.
  * Copying This Manual::         The GNU Free Documentation License.
  * Command and Variable Index::  A menu containing commands and variables.
--- 164,168 ----
***************
*** 573,576 ****
--- 571,575 ----
                                   of pages and how to print scaled up output.
  * PDF Output::                  Portable Document Format output.
+ * Obtaining TeX::               How to Obtain @TeX{}.
  
  Creating and Installing Info Files
***************
*** 3935,3939 ****
  @code{texinfo-format-region} commands is that they do not indent (nor
  fill) paragraphs that contain @code{@@w} or @code{@@*} commands.
- @xref{Refilling Paragraphs}, for further information.
  
  
--- 3934,3937 ----
***************
*** 9179,9183 ****
  The reason for mentioning this here is that older Info browsers (this
  feature was introduced in Texinfo version 4.6) will display the above
! literally, which, although not ideal, should not be harmful.
  
  
--- 9177,9181 ----
  The reason for mentioning this here is that older Info browsers (this
  feature was introduced in Texinfo version 4.6) will display the above
! literally, which, although not pretty, should not be harmful.
  
  
***************
*** 10920,10928 ****
  @end example
  
- Do not write an @code{@@refill} command at the end of a paragraph
- containing an @code{@@*} command; it will cause the paragraph to be
- refilled after the line break occurs, negating the effect of the line
- break.  @xref{Refilling Paragraphs}.
- 
  The @code{@@/} command can be useful within a url
  (@pxref{uref,,@code{@@uref}}), which tend to be long and are otherwise
--- 10918,10921 ----
***************
*** 13678,13681 ****
--- 13671,13675 ----
                                   of pages and how to print scaled up output.
  * PDF Output::                  Portable Document Format output.
+ * Obtaining TeX::               How to Obtain @TeX{}.
  @end menu
  
***************
*** 14543,14551 ****
  portable in practice as the plain ASCII formats (Info, HTML) that
  Texinfo supports (DVI portability is arguable).  They also tend to be
! much larger and do not support the bitmap fonts used by @TeX{} (by
! default) very well.  Nevertheless, a PDF file does preserve an actual
! printed document on a screen as faithfully as possible, so it has its place.
  
! PDF support in Texinfo is fairly rudimentary.
  
  
--- 14537,14583 ----
  portable in practice as the plain ASCII formats (Info, HTML) that
  Texinfo supports (DVI portability is arguable).  They also tend to be
! much larger.  Nevertheless, a PDF file does preserve an actual printed
! document on a screen as faithfully as possible, so it has its place.
  
! 
! @node Obtaining TeX
! @section How to Obtain @TeX{}
! @cindex Obtaining @TeX{}
! @cindex @TeX{}, how to obtain
! 
! @c !!! Here is information about obtaining TeX.  Update it whenever.
! @c !!! Also consider updating TeX.README on ftp.gnu.org.
! @c     Updated by RJC on 1 March 1995, conversation with MacKay.
! @c     Updated by address@hidden on 29 July 1996.
! @c     Updated by address@hidden on 25 April 1997.
! @c     Updated by address@hidden on 27 February 1998.
! @TeX{} is freely redistributable.  You can obtain @TeX{} for Unix
! systems via anonymous ftp or on physical media.  The core material
! consists of the Web2c @TeX{} distribution (@uref{http://tug.org/web2c}).
! 
! Instructions for retrieval by anonymous ftp and information on other
! available distributions:
! @uref{http://tug.org/unixtex.ftp}.
! 
! The Free Software Foundation provides a core distribution on its Source
! Code CD-ROM suitable for printing Texinfo manuals.  To order it, contact:
! 
! @display
! @group
! Free Software Foundation, Inc.
! 59 Temple Place Suite 330
! Boston, MA @ @ 02111-1307
! USA
! Telephone: @w{+1-617-542-5942}
! Fax: (including Japan) @w{+1-617-542-2652}
! Free Dial Fax (in Japan):
! @w{ } @w{ } @w{ } 0031-13-2473 (KDD)
! @w{ } @w{ } @w{ } 0066-3382-0158 (IDC)
! Electronic mail: @code{gnu@@gnu.org}
! @end group
! @end display
! 
! Many other @TeX{} distributions are available; see
! @uref{http://tug.org/}.
  
  
***************
*** 15929,15934 ****
  
  @item @@*
! Force a line break. Do not end a paragraph that uses @code{@@*} with
! an @code{@@refill} command.  @xref{Line Breaks}.
  
  @item @@,@address@hidden@}
--- 15961,15965 ----
  
  @item @@*
! Force a line break.  @xref{Line Breaks}.
  
  @item @@,@address@hidden@}
***************
*** 16739,16746 ****
  
  @item @@refill
! In Info, refill and indent the paragraph after all the other processing
! has been done.  No effect on @TeX{}, which always refills.  This command
! is no longer needed, since all formatters now automatically refill.
! @xref{Refilling address@hidden
  
  @item @@address@hidden@}
--- 16770,16777 ----
  
  @item @@refill
! This command used to refill and indent the paragraph after all the
! other processing has been done.  It is no longer needed, since all
! formatters now automatically refill as needed, but you may still see
! it in the source to some manuals, as it does no harm.
  
  @item @@address@hidden@}
***************
*** 17065,17070 ****
  
  @item @@address@hidden@address@hidden
! Prevent @var{text} from being split across two lines.  Do not end a
! paragraph that uses @code{@@w} with an @code{@@refill} command.
  @xref{w, , @code{@@address@hidden
  
--- 17096,17100 ----
  
  @item @@address@hidden@address@hidden
! Prevent @var{text} from being split across two lines.
  @xref{w, , @code{@@address@hidden
  
***************
*** 19120,19123 ****
--- 19150,19157 ----
  
  
+ @ignore
+ The simple description in the command summary seems sufficient to me
+ these days, so ignore this appendix.  --karl, 13mar04.
+ 
  @node Refilling Paragraphs
  @appendix Refilling Paragraphs
***************
*** 19159,19162 ****
--- 19193,19198 ----
  and therefore do not refill or indent address@hidden
  
+ @end ignore
+ 
  
  @node Command Syntax
***************
*** 19222,19270 ****
  does @emph{not} require braces.  @code{@@refill} never confuses the
  Emacs paragraph commands because it cannot appear at the beginning of
! a address@hidden
! 
! 
! @node Obtaining TeX
! @appendix How to Obtain @TeX{}
! @cindex Obtaining @TeX{}
! @cindex @TeX{}, how to obtain
! 
! @c !!! Here is information about obtaining TeX.  Update it whenever.
! @c !!! Also consider updating TeX.README on ftp.gnu.org.
! @c     Updated by RJC on 1 March 1995, conversation with MacKay.
! @c     Updated by address@hidden on 29 July 1996.
! @c     Updated by address@hidden on 25 April 1997.
! @c     Updated by address@hidden on 27 February 1998.
! @TeX{} is freely redistributable.  You can obtain @TeX{} for Unix
! systems via anonymous ftp or on physical media.  The core material
! consists of the Web2c @TeX{} distribution (@uref{http://tug.org/web2c}).
! 
! Instructions for retrieval by anonymous ftp and information on other
! available distributions:
! @example
! @uref{ftp://tug.org/tex/unixtex.ftp}
! @uref{http://tug.org/unixtex.ftp}
! @end example
! 
! The Free Software Foundation provides a core distribution on its Source
! Code CD-ROM suitable for printing Texinfo manuals.  To order it, contact:
! 
! @display
! @group
! Free Software Foundation, Inc.
! 59 Temple Place Suite 330
! Boston, MA @ @ 02111-1307
! USA
! Telephone: @w{+1-617-542-5942}
! Fax: (including Japan) @w{+1-617-542-2652}
! Free Dial Fax (in Japan):
! @w{ } @w{ } @w{ } 0031-13-2473 (KDD)
! @w{ } @w{ } @w{ } 0066-3382-0158 (IDC)
! Electronic mail: @code{gnu@@gnu.org}
! @end group
! @end display
! 
! Many other @TeX{} distributions are available; see
! @uref{http://tug.org/}.
  
  
--- 19258,19263 ----
  does @emph{not} require braces.  @code{@@refill} never confuses the
  Emacs paragraph commands because it cannot appear at the beginning of
! a line.  It is also no longer needed, since all formatters now refill
! paragraphs automatically.