[latexrefman-discuss] Adjust About and Overview sections to separate functions
Hefferon, James S.
jhefferon at domain.hid
Tue Apr 14 21:57:21 CEST 2015
Nodes: About this document, Overview
Commit message: subject line
Jim
----------------------------------------------------
Distraction is a kind of obesity of the mind
-- Matthew Crawford
*** latex2e.texi 2015-04-14 05:58:58.768638685 -0400
--- latex2e.texi.jim 2015-04-14 15:48:26.629381836 -0400
***************
*** 130,160 ****
@node About this document
@chapter About this document
- @cindex Knuth, Donald E.
- @cindex Lamport, Leslie
@cindex @LaTeX{} Project team
- The @LaTeX{} document preparation system is implemented as a macro
- package for Donald at domain.hid. Knuth's @TeX{} typesetting program.
- @LaTeX{} was originally created by Leslie Lamport; it is now
- maintained by a group of volunteers (@url{http://latex-project.org}).
- The official documentation written by the @LaTeX{} project is
- available from their web site.
-
@cindex bug reporting
@cindex reporting bugs
@findex @email{latexrefman-discuss at domain.hid} @r{email address}
! The present document is completely unofficial and has not been
! reviewed by the @LaTeX{} maintainers. Do not send bug reports or
! anything else about this document to them. Instead, please send all
! comments to @email{latexrefman-discuss at domain.hid}.
The home page for this document is
@url{http://home.gna.org/latexrefman}. That page has links to the
current output in various formats, sources, mailing lists, and other
infrastructure.
! Of course, there are many, many other sources of information about
! @LaTeX{}. Here are a few:
@table @url
@item http://www.ctan.org/pkg/latex-doc-ptr
--- 130,158 ----
@node About this document
@chapter About this document
@cindex @LaTeX{} Project team
@cindex bug reporting
@cindex reporting bugs
@findex @email{latexrefman-discuss at domain.hid} @r{email address}
! This is an unofficial reference manual for the the @LaTeX{} document
! preparation system, which is a macro package for the @TeX{} typesetting
! program (@pxref{Overview}).
!
! @LaTeX{} is currently maintained by a group of volunteers
! (@url{http://latex-project.org}). The official documentation written by
! the @LaTeX{} project is available from their web site. This document is
! completely unofficial and has not been reviewed by the @LaTeX{}
! maintainers. Do not send bug reports or anything else about this
! document to them. Instead, please send all comments to
! @email{latexrefman-discuss at domain.hid}.
The home page for this document is
@url{http://home.gna.org/latexrefman}. That page has links to the
current output in various formats, sources, mailing lists, and other
infrastructure.
! Besides this document there are many, many other sources of information
! about @LaTeX{}. Here are a few for beginners.
@table @url
@item http://www.ctan.org/pkg/latex-doc-ptr
***************
*** 164,263 ****
Writing your first document, with a bit of both text and math.
@item http://www.ctan.org/pkg/usrguide
! The guide for document authors maintained as part of @LaTeX{}; there
! are several others.
@item http://tug.org/begin.html
Introduction to the @TeX{} system, including @LaTeX{}.
@end table
@node Overview
@chapter Overview of @LaTeX{}
- What is @LaTeX{}?
-
@cindex overview of @LaTeX{}
@cindex basics of @LaTeX{}
@cindex @LaTeX{} overview
- @LaTeX{} typesets a file of text using the @TeX{} program and the
- @LaTeX{} ``macro package'' for @TeX{}. That is, it processes an input
- file containing the text of a document with interspersed commands that
- describe how the text should be formatted. @LaTeX{} files are plain
- text that can be written in any reasonable editor. It produces at
- least three files as output:
-
- @enumerate
- @item
- The main output file, which is one of:
-
- @table @code
- @item .dvi
- @findex .dvi @r{file}
- @findex latex @r{command}
- If invoked as @command{latex}, a ``Device Independent'' (@file{.dvi})
- file is produced. This contains commands that can be translated into
- commands for virtually any output device. You can view such
- @file{.dvi} output of @LaTeX{} by using a program such as
- @command{xdvi} (display directly), @command{dvips} (convert to
- PostScript), or @command{dvipdfmx} (convert to PDF).
-
- @item .pdf
- @findex .pdf @r{file}
- @cindex pdf at domain.hid{}
- @findex pdflatex @r{command}
- If invoked as @command{pdflatex}, a ``Portable Document Format''
- (@file{.pdf}) file. Typically, this is a self-contained file, with
- all fonts and images embedded. This can be very useful, but it does
- make the output much larger than the @file{.dvi} produced from the
- same document.
-
- @findex lualatex @r{command}
- @cindex Lua at domain.hid{}
- If invoked as @command{lualatex}, a @file{.pdf} file is created using
- the Lua at domain.hid{} engine (@url{http://luatex.org}).
-
- @findex xelatex @r{command}
- @cindex Xe at domain.hid{}
- If invoked as @command{xelatex}, a @file{.pdf} file is created using
- the Xe at domain.hid{} engine (@url{http://tug.org/xetex}).
-
- @end table
-
- Many other less-common variants of @LaTeX{} (and @TeX{}) exist, which
- can produce HTML, XML, and other things.
! @item
! @cindex transcript file
! @cindex log file
! @findex .log @r{file}
! The ``transcript'' or @file{.log} file that contains summary
! information and diagnostic messages for any errors discovered in the
! input file.
!
! @item
! @cindex auxiliary file
! @findex .aux @r{file}
! An ``auxiliary'' or @file{.aux} file. This is used by @LaTeX{} itself,
! for things such as cross-references.
! @end enumerate
! An open-ended list of other files might be created. We won't try to
! list them all.
@c xx components?
! @findex \ @r{character starting commands}
! @findex [...] @r{for optional arguments}
! @findex @{...@} @r{for required arguments}
! In the @LaTeX{} input file, a command name starts with a @code{\},
! followed by either (a)@tie{}a string of letters or (b)@tie{}a single
! non-letter. Arguments contained in square brackets, @code{[]}, are
! optional while arguments contained in braces, @code{@{@}}, are
! required.
!
! @cindex case sensitivity of @LaTeX{}
! @LaTeX{} is case sensitive. Enter all commands in the same case as they
! are defined; most commands are lowercase.
@node Starting & ending
--- 162,284 ----
Writing your first document, with a bit of both text and math.
@item http://www.ctan.org/pkg/usrguide
! The guide for document authors maintained as part of @LaTeX{}; there are
! several others.
@item http://tug.org/begin.html
Introduction to the @TeX{} system, including @LaTeX{}.
@end table
+ @c xx https://www.ctan.org/tex-archive/info/lshort?
+
@node Overview
@chapter Overview of @LaTeX{}
@cindex overview of @LaTeX{}
@cindex basics of @LaTeX{}
+ @cindex Knuth, Donald E.
+ @cindex Lamport, Leslie
@cindex @LaTeX{} overview
! @LaTeX{} is a system for typesetting documents. It was originally
! created by Leslie Lamport and is now maintained by a group of volunteers
! (@url{http://latex-project.org}). It is widely used, particularly for
! complex and technical documents, such as those involving mathematics.
!
! A @LaTeX{} user writes an input file containing text along with
! interspersed commands, for instance commands describing how the text
! should be formatted. It is implemented as a set of interrelated
! commands that interface with Donald at domain.hid. Knuth's @TeX{} typesetting
! program (the technical term is that @LaTeX{} is a ``macro package'' for
! the @TeX{} engine). The user produces the output document by giving
! that file to the @TeX{} engine.
!
! The term @LaTeX{} is also sometimes used to mean the language in which
! the document is marked up, that is, to mean the set of commands
! available to a @LaTeX{} user.
!
! The name @LaTeX{} is short for Lamport TeX. It is pronounced LAH-teck
! or LAY-teck, or sometimes LAY-tecks. Inside a document, produce the
! logo with @code{\LaTeX}. Where use of the logo is not sensible, such as
! in plain text, write it as @code{LaTeX}.
!
!
! @c xx list of files output by (La)TeX; separate node?
! @c @LaTeX{} produces at
! @c least three files as output:
!
! @c @enumerate
! @c @item
! @c The main output file, which is one of:
!
! @c @table @code
! @c @item .dvi
! @c @findex .dvi @r{file}
! @c @findex latex @r{command}
! @c If invoked as @command{latex}, a ``Device Independent'' (@file{.dvi})
! @c file is produced. This contains commands that can be translated into
! @c commands for virtually any output device. You can view such
! @c @file{.dvi} output of @LaTeX{} by using a program such as
! @c @command{xdvi} (display directly), @command{dvips} (convert to
! @c PostScript), or @command{dvipdfmx} (convert to PDF).
!
! @c @item .pdf
! @c @findex .pdf @r{file}
! @c @cindex pdf at domain.hid{}
! @c @findex pdflatex @r{command}
! @c If invoked as @command{pdflatex}, a ``Portable Document Format''
! @c (@file{.pdf}) file. Typically, this is a self-contained file, with
! @c all fonts and images embedded. This can be very useful, but it does
! @c make the output much larger than the @file{.dvi} produced from the
! @c same document.
!
! @c @findex lualatex @r{command}
! @c @cindex Lua at domain.hid{}
! @c If invoked as @command{lualatex}, a @file{.pdf} file is created using
! @c the Lua at domain.hid{} engine (@url{http://luatex.org}).
!
! @c @findex xelatex @r{command}
! @c @cindex Xe at domain.hid{}
! @c If invoked as @command{xelatex}, a @file{.pdf} file is created using
! @c the Xe at domain.hid{} engine (@url{http://tug.org/xetex}).
!
! @c @end table
!
! @c Many other less-common variants of @LaTeX{} (and @TeX{}) exist, which
! @c can produce HTML, XML, and other things.
!
! @c @item
! @c @cindex transcript file
! @c @cindex log file
! @c @findex .log @r{file}
! @c The ``transcript'' or @file{.log} file that contains summary
! @c information and diagnostic messages for any errors discovered in the
! @c input file.
!
! @c @item
! @c @cindex auxiliary file
! @c @findex .aux @r{file}
! @c An ``auxiliary'' or @file{.aux} file. This is used by @LaTeX{} itself,
! @c for things such as cross-references.
! @c @end enumerate
! @c An open-ended list of other files might be created. We won't try to
! @c list them all.
@c xx components?
! @c @findex \ @r{character starting commands}
! @c @findex [...] @r{for optional arguments}
! @c @findex @{...@} @r{for required arguments}
! @c In the @LaTeX{} input file, a command name starts with a @code{\},
! @c followed by either (a)@tie{}a string of letters or (b)@tie{}a single
! @c non-letter. Arguments contained in square brackets, @code{[]}, are
! @c optional while arguments contained in braces, @code{@{@}}, are
! @c required.
!
! @c @cindex case sensitivity of @LaTeX{}
! @c @LaTeX{} is case sensitive. Enter all commands in the same case as they
! @c are defined; most commands are lowercase.
@node Starting & ending
More information about the latexrefman
mailing list