texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[no subject]


From: Gavin D. Smith
Date: Wed, 2 Aug 2023 13:41:42 -0400 (EDT)

branch: master
commit 5f71a955a19a87ce10e17bc0f7745b93d041793e
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Wed Aug 2 18:41:15 2023 +0100

    * doc/texinfo.texi (Hardcopy with TeX): Edit and condense.  Reference
    another node for details of changing the paper size.
    (@smallbook): Say that 8.5x11" paper is called letter size.
---
 ChangeLog        |  6 ++++++
 doc/texinfo.texi | 54 +++++++++++++++++-------------------------------------
 2 files changed, 23 insertions(+), 37 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 611a5a6808..b95ecd243b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2023-08-02  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Hardcopy with TeX): Edit and condense.  Reference
+       another node for details of changing the paper size.
+       (@smallbook): Say that 8.5x11" paper is called letter size.
+
 2023-08-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        * doc/texinfo.texi (Printing): Remove node, as it is duplicative
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index d0d920c9f5..1e4cad5c98 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -14507,21 +14507,13 @@ Running the @command{texi2dvi} or @command{texi2pdf} 
command is the
 simplest way to create printable output.  These commands are installed
 as part of the Texinfo package.
 
-Typesetting and printing a Texinfo file is a multi-step process in
-which you first create a file for printing (called a DVI file), and
-then print the file.  Optionally, you may also create indices.  To do
-this, you must run the @command{texindex} command after first running the
-@command{tex} typesetting command; and then you must run the
-@command{tex} command again.  Or else run the @command{texi2dvi}
-command which automatically creates indices as needed (@pxref{Format
-with @command{texi2dvi}}).
-
-In more detail, three major shell commands are used to print formatted
-output from a Texinfo manual: one converts the Texinfo source into
-something printable, a second sorts indices, and a third actually
-prints the formatted document.  When you use the shell commands, you
-can either work directly in the operating system shell or work within
-a shell inside GNU Emacs (or some other computing environment).
+In more detail, typesetting and printing a Texinfo file is a multi-step
+process in which you use the @TeX{} program to create a file for printing
+(called a DVI or PDF file), and then print the file.  Optionally,
+you may also create indices using the @command{texindex} command
+after first running @TeX{}; and then you must run @TeX{} again.
+@command{texi2dvi} takes care of all of this, running @TeX{} and
+@command{texindex} as needed (@pxref{Format with @command{texi2dvi}}).
 
 @anchor{Within Emacs} @c old node name
 @anchor{Emacs Shell Printing} @c old node name
@@ -14530,30 +14522,17 @@ a shell inside GNU Emacs (or some other computing 
environment).
 @cindex Shell, format, print from
 @cindex Emacs shell, format, print from
 @cindex GNU Emacs shell, format, print from
+When you use the shell commands, you
+can either work directly in the operating system shell or work within
+a shell inside GNU Emacs (or some other computing environment).
 You can give formatting and printing commands from a shell within GNU
 Emacs, just like any other shell command.  To create a shell within
-Emacs, type @kbd{M-x shell} (@pxref{Shell,,, emacs, The GNU Emacs
-Manual}).
-You can switch to and from the shell buffer while @command{tex} is
-running and do other editing.  If you are formatting a long document
-on a slow machine, this can be very convenient.
-
-If you are using GNU Emacs, you can use commands provided by Texinfo
-mode instead of shell commands.  In addition to the three commands to
-format a file, sort the indices, and print the result, Texinfo mode
-offers key bindings for commands to recenter the output buffer, show the
-print queue, and delete a job from the print queue.  @xref{Printing with
-Emacs}.
-
-In the United States, documents are most often printed on 8.5 inch by
-11 inch pages (216@dmn{mm} by 280@dmn{mm}); this is the default size.
-But you can also print for 7 inch by 9.25 inch pages (178@dmn{mm} by
-235@dmn{mm}, the @code{@@smallbook} size; or on A4 or A5 size paper
-(@code{@@afourpaper}, @code{@@afivepaper}).
-@xref{@code{@@smallbook}}, and @ref{A4 Paper}.
-
+Emacs, type @kbd{M-x shell} (@pxref{Shell,,, emacs, The GNU Emacs Manual}).
+If you are using GNU Emacs, you can also use commands provided by Texinfo
+mode instead of shell commands.  @xref{Printing with Emacs}.
 
-Details are in the following sections.
+For specifing details of the printed output such as paper size, see
+@ref{Global Document Commands}.
 
 
 @node Use @TeX{}
@@ -23609,7 +23588,8 @@ Header}.
 @cindex Size of printed book
 
 By default, @TeX{} typesets pages for printing in an 8.5 by 11 inch
-format.  However, you can direct @TeX{} or @LaTeX{} to typeset a document in a
+format, which is the ``letter'' commonly used in the United States.
+However, you can direct @TeX{} or @LaTeX{} to typeset a document in a
 7 by 9.25 inch format that is suitable for bound books by inserting the
 following command on a line by itself at the beginning of the Texinfo file,
 before the title page:



reply via email to

[Prev in Thread] Current Thread [Next in Thread]