latex-veryshortguide 1oct09 (2oct09)

git-svn-id: svn://tug.org/texlive/trunk@15598 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 83 insertions, 52 deletions

diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
index a71ba32cd53..7290085d089 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
@@ -1,39 +1,70 @@
-The Very Short Guide to LaTeX
 
-http://latex.silmaril.ie/veryshortguide/
+  The Very Short Guide to LaTeX
 
-This is the 24 July 2009 revision of the Guide. It is designed for
+This is the 1 October 2009 revision of the Guide. It is designed for
 printing on A4 paper, double-sided, and folding once to A5.
 
-If you have been maintaining a mirror or other copy of this document,
-please update it with this version delete the previous files.
+This revision corrects some minor typographical inconsistencies and
+rephrases some descriptions for greater clarity.
 
 
-LICENSE
+            From the source comments:
 
-This is free documentation, issued under the LaTeX Rroject Public
-License. For details see
-http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
+    This is the Very Short Guide to LaTeX, a 4pp folder designed as an
+    aide-mémoire for people who have just done a course in LaTeX and
+    need something by them on their desk the next day to refresh their
+    memories. It is /not/ intended as a substitute for full documentation.
 
-FILES
 
-Source code 
+    Production notes
 
-veryshortguide.tex 
+An earlier (Jan 2008) version was typeset on two A4 landscape pages
+ready to print, but this restricted the ways people wanted to print it,
+so this version is set as four normal A5 pages, leaving the imposition
+up to your printer driver.
 
-Output 
+Adobe Acrobat 9, for example, can print the PDF two-sided, two-up,
+landscape on A4 using the "Booklet Printing" option, and a ready-imposed
+PDF generated this way is included below. A similar effect can be
+achieved by preprocessing the PS output with the command
 
-veryshortguide.pdf 
-veryshortguide-imposed.pdf 
-veryshortguide.dvi
-veryshortguide.ps 
+pstops -pa4 -b "4:-3L(30cm,0)+0L(30cm,14.85cm),1L(30cm,0)+-2L(30cm,14.85cm)" \
+    veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+    
 
-Images
+The weird value of 30cm appears to be due to a bug in |pstops| (and in
+|psbook|: it ought to have been possible to use |psbook| and |psnup| for
+this, but that method does not allow for offsetting).
 
-menno-a.eps 
-menno-a.png 
+The page margins are set to 12mm, because many desktop inkjet printers
+cannot print the bottom 12mm of a sheet; it was felt best to equalise
+this all round, at the small expense of making the printable area
+slightly smaller.
 
-Peter Flynn
+Page 1 	Page 2 	Page 3 	Page 4
+
+If you have been maintaining a mirror or other copy of this document,
+please update it with this version and delete the previous files.
+
+
+    License
 
-2009-07-22 20:12:00
+This is free documentation, issued under the LaTeX Project Public
+License <http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html>.
+
+
+    Files
+
+Source code
+veryshortguide.tex	22K	LaTeX source
+Output
+veryshortguide.pdf	480K	PDF output
+veryshortguide-imposed.pdf	312K	PDF output
+veryshortguide.dvi	30K	DVI output
+veryshortguide.ps	1.2M	PS output
+Images
+menno-a.eps	444K	Map (EPS)
+menno-a.jpg	30K	Map (JPG)
+
+Peter Flynn
 
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
index d26aad7366f..36e59e1c7ef 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
index 5e541d00b70..3de55350ec3 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
index d8901a3efb6..5325a28a81a 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
index d238b7a88c0..6a29c0f6f6e 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
@@ -9,7 +9,7 @@
 % License. For details see
 % http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
 %
-% 2009-07-24
+% 2009-10-01
 %
 % Please do NOT complain that there is no math here. It won't fit.
 % Someone else can do a math leaflet. IANAM.
@@ -102,14 +102,10 @@
   February\or March\or April\or May\or June\or July\or August\or
   September\or October\or November\or December\fi\space\number\year}
 %
-% There's something odd about the hyphenation...
+% There's something odd about the hyphenation...these were broken:
 \hyphenation{mathe-mati-cal auto-mati-cal-ly docu-ment docu-ments
   statis-ti-cal}
 %
-% This one is silly: we really, really shouldn't have to do this.
-% For some reason the T1 encoding is broken at this point.
-\newcommand{\sect}{\char'247 }
-%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
 % Formatting changes
@@ -178,10 +174,12 @@ great accuracy and consistency. \LaTeX\ works on any computer and
 produces industry-standard PS or PDF documents. It is available both
 in free (open-source) and commercial implementations. \LaTeX\ can be
 used for any kind of document, but it is especially suited to those
-with complex structure, repetitive formatting,
+with a complex structure, repetitive formatting, or notations like
 mathematics\footnote{For reasons of space this guide does not cover
-  details of mathematics typesetting.}, technical stability, and
-dimensional accuracy.
+  details of mathematics typesetting.}; or where technical stability,
+dimensional accuracy, or a persistent and non-proprietary file format
+are needed.
+
 
 \subsection{Syntax (how to type \LaTeX\ commands --- these are the rules)}
 
@@ -245,8 +243,8 @@ Here's the skeleton of a \LaTeX\ document. These three lines are
 
 \begin{itemize*}
   \item The document class name must be one of \verb+book+,
-    \verb+article+, or \verb+report+, or one you have
-    installed yourself (eg \verb+thesis+, \verb+memoir+, etc).
+    \verb+article+, or \verb+report+, or an extra one you have
+    downloaded and installed (eg \verb+thesis+, \verb+memoir+, etc).
   \item There are paper size options \verb+a4paper+
     (210\thinspace mm$\times$297\thinspace mm) and \verb+letterpaper+
     (8½$''\times$11$''$) and others (eg \verb+a5paper+).
@@ -261,7 +259,7 @@ The \textbf{preamble} is where you specify any extra \textbf{packages}
 requirements, and where you put any changes to standard features.
 
 \begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
-\documentclass[a4paper,11pt]{report}
+\documentclass[a4paper,11pt]{book}
 \usepackage{charter,graphicx}
 \setlength{\parindent}{1em}
 \begin{document}
@@ -281,10 +279,11 @@ In a typical report or article, the title, author, date, abstract
 (summary), and table of contents (optional) all go at the start,
 followed by your text. 
 
-Leave a blank line between paragraphs. This does \emph{not} mean you
-get a blank line typeset, it just means `start a new paragraph here'.
-\LaTeX\ will format your text according to the document class and
-packages you are using.
+Leave a blank line between paragraphs as you type. This means `start a
+new paragraph', \emph{not} `leave a blank line'. You can control
+spacing and indentation by setting \verb+\parskip+ and
+\verb+\parindent+ (see examples), or with the \textsf{parskip}
+package.
 
 \subsubsection{Sections and cross-references}
 
@@ -303,7 +302,7 @@ the \textsf{babel} package for other languages.
 \subsubsection!comment{heading of a subsection!revert}
 !comment text for the subsection goes here
 \section!comment{heading of a new section!revert}
-\label{blah} !comment make up a name for the label
+\label{blah} !comment make up name for the label
 !comment text for the section goes here
 \end{document}
 \end{Verbatim}
@@ -341,7 +340,7 @@ or phrase, use these commands (they can be nested---see below):
 
 {\small
 \begin{tabular}{l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
-      Hello\char'175}@{}>{\gives\bgroup}l<{\thinspace Hello\egroup}}
+      Hello\char'175}@{}>{\ \gives\bgroup}l<{\ Hello\egroup}}
 Italics&it&\itshape\\
 Boldface&bf&\bfseries\\
 Smallcaps&sc&\scshape\\
@@ -354,7 +353,7 @@ Monospace&tt&\ttfamily\\
 \gives{\textit{\textbf{\textsf{bold ital sans}}}}
 
 Font sizing is automatic for titles, headings, and footnotes. There
-are named step-size commands (in points, relative to the base size):
+are some named step-size commands (in points, relative to the base size):
 
 {\small
 \begin{tabular}{>{\ttfamily\char'134}lrrr}
@@ -364,18 +363,20 @@ scriptsize&6&7&8\\
 footnotesize&7&8&9\\
 small&9&10&11\\
 large&11&12&14\\
-Large&12&14&17\\
-LARGE&14&17&20\\
-huge&17&20&24\\
-Huge&20&24&28\\
+Large&12&14&17\rlap*\\
+LARGE&14&17\rlap*&20\rlap*\\
+huge&17\rlap*&20\rlap*&24\rlap*\\
+Huge&20\rlap*&24\rlap*&28\rlap*\\
 \end{tabular}
+\quad
+\rotatebox[origin=c]{90}{\scriptsize* sizes rounded here to save space}
 }
 
 but you can specify an exact size with the \textsf{fix-cm} package and
 the command
 \verb+\fontsize{+\texttt{\textit{pp}}\verb+}{+\texttt{\textit{bb}}\verb+}\selectfont+
 for any point-size (\textit{pp}) on any baseline (\textit{bb}). Group
-(enclose) the command \emph{and} its applicable text in curly braces
+(enclose) the command \emph{with} its applicable text in curly braces
 to prevent it affecting the rest of the document. For wider line-spacing
 (eg in theses) use the \textsf{setspace} package. You can also use
 \linebreak colour with the 
@@ -395,7 +396,7 @@ to prevent it affecting the rest of the document. For wider line-spacing
 There are three basic kinds: \textbf{itemized} lists (bulleted);
 \textbf{enumerated} lists (numbered or lettered); and
 \textbf{descriptive} lists (topic-and-explanation format). Others can
-be defined or downloaded from CTAN [5].
+be defined, or downloaded from CTAN [5].
 
 \begingroup\tiny
 \renewcommand{\labelitemi}{\textbullet}
@@ -512,7 +513,7 @@ comprehensive list at
 \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
 \begin{figure}
 \caption{Swiss and Dutch Mennonite migrations of the 1700s and 1800s}\label{lmig}
-\centering !comment (graphics must be in EPS format for standard !LaTeX; JPG, PNG, or PDF for pdf!LaTeX)
+\centering !comment (graphics must be EPS files for standard !LaTeX; but JPG, PNG, or PDF for pdf!LaTeX)
 \includegraphics[width=.8\columnwidth]{menno-a}
 \\\scriptsize Courtesy of Paul C. Adams, Department of Geography and the 
 Environment, University of Texas at Austin. \cite{adams}\end{figure}
@@ -528,14 +529,14 @@ and the Environment, University of Texas at Austin.~[1]
 
 \subsubsection{Footnotes, citations, references, and indexes (back matter)}
 \setcounter{footnote}{1} 
-Footnotes are done with a simple command,\footnote{Like this.} see
+You do footnotes with a simple command,\footnote{Like this.} see
 below.  Citations using BIB\TeX{} (Patashnik, 1988) are also easy (see
-[2], \sect7.4.2) and there are packages for more complex formats for
+[2], \S7.4.2) and there are packages for more complex formats for
 journals and publishers. You can add indexes with the \verb+\index+
 command and the \textsf{makeindex} program.
 
 \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-Footnotes are done with a simple command,\footnote{Like this.} see below. Citations 
+You do footnotes with a simple command,\footnote{Like this.} see below. Citations 
 using BIB\TeX{} \citeauthoryear{oren} are also easy (see \cite[§7.4.2]{flynn} and 
 there are packages for more complex formats for journals and publishers. You can 
 add  indexes with the \verb`\index` command and the \textsf{makeindex} program.
@@ -570,4 +571,3 @@ Micropress, Inc (V\TeX), True\TeX\ Software (True\TeX), and others.
 \end{note}
 
 \end{document}
-