[latexrefman-discuss] starting and ending

[Hefferon, James S.]

Nodes: Starting and ending
Msg: Added working minimal example

Is diff -u better, or diff -c ?  I don't care.

Jim

----------------------------------------------------
Distraction is a kind of obesity of the mind
  -- Matthew Crawford

*** latex2e.texi	2015-04-22 10:02:37.678659572 -0400
--- latex2e.texi.jim	2015-04-22 10:58:35.930720871 -0400
***************
*** 96,102 ****
  @menu
  * About this document::         Bug reporting, etc.
  * Overview::                    What is @LaTeX{}?
! * Starting & ending::		The standard beginning and end of a document.
  * Document classes::		Some of the various classes available.
  * Fonts::			Italic, bold, typewriter, etc.
  * Layout::			Controlling the page layout.
--- 96,102 ----
  @menu
  * About this document::         Bug reporting, etc.
  * Overview::                    What is @LaTeX{}?
! * Starting and ending::		The standard beginning and end of a document.
  * Document classes::		Some of the various classes available.
  * Fonts::			Italic, bold, typewriter, etc.
  * Layout::			Controlling the page layout.
***************
*** 220,254 ****
  @c are defined; most commands are lowercase.
  
  
! @node Starting & ending
! @chapter Starting & ending
  
! @cindex starting & ending
! @cindex ending & starting
  
! A minimal input file looks like the following:
  
  @example
! \documentclass at domain.hid}@}
  \begin at domain.hid@}
! @var{your text}
  \end at domain.hid@}
  @end example
  
  @noindent
! where the @var{class} is a valid document class for @LaTeX{}.
! @xref{Document classes}, for details of the various document classes
! available locally.
  
  @cindex preamble, defined
! You may include other @LaTeX{} commands between the @code{\documentclass}
! and the @code{\begin at domain.hid@}} commands (this area is called the
! @dfn{preamble}).
  
  @menu
  * Output files::   Files produced.
  * TeX engines::   Programs that run @LaTeX{}.
  @end menu
  
  
  @node Output files
--- 220,292 ----
  @c are defined; most commands are lowercase.
  
  
! @c xx TeX distribution
! @c xx packages
! @c other document classes
! @c xx CTAN
  
! @node Starting and ending
! @chapter Starting and ending
  
! @cindex starting and ending
! @cindex start of file
! @cindex end of file
! 
! @LaTeX{} files have a simple global structure, with a standard starting
! and ending.  This is a minimal working @LaTeX{} input file.
  
  @example
! \documentclass at domain.hid@}
  \begin at domain.hid@}
! Hello world!
  \end at domain.hid@}
  @end example
  
  @noindent
! To turn it into output you should follow the directions in the
! documentation for your @TeX{} distribution.  One simple way is that is
! likely to work is to use a text editor (not a word processor) to save
! the contents as a file named @file{minexam.tex}, open a terminal command
! line window and change to the directory containing that file, and then
! run the command @code{pdflatex minexam}.  This should produce as output
! the file @file{minexam.pdf}, which you can view with any PDF reader
! program.  (It also produces several other files (@pxref{Output files}),
! as well as some informational messages.)
!   
! More generally, a @LaTeX{} input file has this global form.
! 
! @example
! \documentclass at domain.hid}@}
! @var{preamble}
! \begin at domain.hid@}
! @var{document body}
! \end at domain.hid@}
! @end example
  
+ @noindent
+ The @var{class} in the first line must be a valid document class
+ (@pxref{Document classes}).
  @cindex preamble, defined
! The @dfn{preamble} contains a list of @LaTeX{} commands to apply to this
! document.  For instance you might put in there commands to change the
! document font.
! @cindex document body, defined
! @cindex body, defined
! The @dfn{document body} is where you enter the text of your document
! and the interspersed @LaTeX{} commands.
! 
! @cindex case sensitivity
! Note that @LaTeX{} is case sensitive so that @code{\begin at domain.hid@}}
! will work but @code{\begin at domain.hid@}} will not.  Most commands are
! lowercase but in any event you must enter all commands in the same case
! as they are defined.
  
  @menu
  * Output files::   Files produced.
  * TeX engines::   Programs that run @LaTeX{}.
  @end menu
+ @c xx ending a run with errors
+ 
  
  
  @node Output files
***************
*** 1501,1507 ****
  @findex document @r{environment}
  
  The @code{document} environment encloses the body of a document.
! It is required in every @LaTeX{} document.  @xref{Starting & ending}.
  
  
  @node enumerate
--- 1539,1545 ----
  @findex document @r{environment}
  
  The @code{document} environment encloses the body of a document.
! It is required in every @LaTeX{} document.  @xref{Starting and ending}.
  
  
  @node enumerate