latex-veryshortguide (23jan13)

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

11 files changed, 320 insertions, 183 deletions

diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
index a905be1f761..272ffbbc981 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
@@ -1,15 +1,17 @@
                          The Very Short Guide to LaTeX
 
-   This is the 12 January 2012 revision of the Guide. It is designed for
+   This is the 22 January 2013 revision of the Guide. It is designed for
    printing on A4 paper, double-sided, and folding once to A5.
 
    This revision corrects some minor typographical inconsistencies and
-   rephrases some descriptions for greater clarity.
+   rephrases some descriptions for greater clarity. The preformatted
+   version uses commercial typefaces: if you use CM or something else you
+   may have to rearrange the text a little, as space is very tight.
 
     From the source comments:
 
      This is the Very Short Guide to LaTeX, a 4pp folder designed as an
-     aide-memoire for people who have just done a course in LaTeX and
+     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.
 
@@ -20,14 +22,18 @@ Production notes
    so this version is set as four normal A5 pages, leaving the imposition
    up to your printer driver.
 
-   Adobe Acrobat, for example, can print the PDF two-sided, two-up,
+   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 better result
-   can be achieved by preprocessing the PS output with the command
-pstops -pa4 -b "4:-3L(21cm,0)+0L(21cm,14.85cm),1L(21cm,0)+-2L(21cm,14.85cm)" \
+   ready-imposed PDF generated this way is included below. A similar
+   effect can be achieved by preprocessing the PS output with the command
+pstops -pa4 -b "4:-3L(30cm,0)+0L(30cm,14.85cm),1L(30cm,0)+-2L(30cm,14.85cm)" \
     veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
 
 
+   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).
+
    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
@@ -46,15 +52,13 @@ License
 Files
 
    Source code
-   [2]veryshortguide.tex          22K LaTeX source
+   [2]veryshortguide.tex          23K LaTeX source
    Output
-   [3]veryshortguide.pdf         646K PDF output
-   [4]veryshortguide-imposed.pdf 154K PDF output
-   [5]veryshortguide.dvi          30K DVI output
-   [6]veryshortguide.ps          1.2M PS output
+   [3]veryshortguide.pdf         852K PDF output
+   [4]veryshortguide-imposed.pdf 178K PDF output
    Images
-   [7]menno-a.eps                444K Map (EPS)
-   [8]menno-a.jpg                 30K Map (JPG)
+   [5]menno-a.eps                444K Map (EPS)
+   [6]menno-a.jpg                 30K Map (JPG)
 
 
     Peter Flynn
@@ -62,10 +66,8 @@ Files
 References
 
    1. http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
-   2. veryshortguide.tex
-   3. veryshortguide.pdf
-   4. veryshortguide-imposed.pdf
-   5. veryshortguide.dvi
-   6. veryshortguide.ps
-   7. menno-a.eps
-   8. menno-a.jpg
+   2. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide.tex
+   3. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide.pdf
+   4. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide-imposed.pdf
+   5. file://localhost/home/peter/texmf/dev/veryshortguide/menno-a.eps
+   6. file://localhost/home/peter/texmf/dev/veryshortguide/menno-a.jpg
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
deleted file mode 100644
index 989b705cf7f..00000000000
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/build b/Master/texmf-dist/doc/latex/latex-veryshortguide/build
new file mode 100755
index 00000000000..c39842a8a4a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/build
@@ -0,0 +1,14 @@
+#! /bin/bash
+YYYYMMDD=`date +%Y%m%d`
+latex veryshortguide
+latex veryshortguide
+pdflatex veryshortguide
+dvips -o veryshortguide.ps veryshortguide.dvi
+pstops -pa4 -b \
+   "4:-3L(21cm,.5cm)+0L(21cm,14.7cm),1L(21cm,.5cm)+-2L(21cm,14.7cm)" \
+   veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+#convert veryshortguide.pdf vsg.jpg
+pdftoppm veryshortguide.pdf vsg;
+      for f in *.ppm;do pnmscale -width=512 $f|pnmtojpeg >${f/ppm/jpg};done
+lynx -dump index.html >README
+cat MANIFEST | zip latex-veryshortguide-$YYYYMMDD.zip -@
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html b/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html
new file mode 100755
index 00000000000..34bef4526ea
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html
@@ -0,0 +1,103 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
+<html>
+  <head>
+    <title>The Very Short Guide to LaTeX</title>
+    <style type="text/css">
+span.lang { font-style:italic; }
+    </style>
+  </head>
+  <body>
+    <h1>The Very Short Guide to LaTeX</h1>
+    <p>This is the 22 January 2013 revision of the Guide. It is designed
+      for printing on A4 paper, double-sided, and folding once to A5.</p>
+    <p>This revision corrects some minor typographical inconsistencies
+      and rephrases some descriptions for greater clarity. The
+      preformatted version uses commercial typefaces: if you use CM or
+    something else you may have to rearrange the text a little, as
+    space is very tight.</p>
+    <blockquote>
+      <h4>From the source comments:</h4>
+      <p>This is the Very Short Guide to LaTeX, a 4pp folder designed
+	as an <span class="lang">aide-m&eacute;moire</span> 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
+	<em>not</em> intended as a substitute for full documentation.</p>
+    </blockquote>
+    <h2>Production notes</h2>
+    <p>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.</p>
+    <p>Adobe Acrobat&nbsp;9, for example, can print the PDF two-sided,
+      two-up, landscape on A4 using the <q>Booklet Printing</q> 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</p>
+    <pre>
+pstops -pa4 -b "4:-3L(30cm,0)+0L(30cm,14.85cm),1L(30cm,0)+-2L(30cm,14.85cm)" \
+    veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+    </pre>
+    <p>The weird value of 30cm appears to be due to a bug in
+      <code>pstops</code> (and in <code>psbook</code>: it ought to
+      have been possible to use <code>psbook</code> and
+      <code>psnup</code> for this, but that method does not allow for
+      offsetting).</p>
+    <p>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.</p>
+    <div align="center">
+      <table border="1">
+	<tbody>
+	  <tr>
+	    <td width="25%" align="center"><img src="vsg-1.jpg"
+		width="100%" alt="Page 1"></td>
+	    <td width="25%" align="center"><img src="vsg-2.jpg"
+		width="100%" alt="Page 2"></td>
+	    <td width="25%" align="center"><img src="vsg-3.jpg"
+		width="100%" alt="Page 3"></td>
+	    <td width="25%" align="center"><img src="vsg-4.jpg"
+		width="100%" alt="Page 4"></td>
+	  </tr>
+	</tbody>
+      </table>
+      <!-- images produced with
+           pdftoppm veryshortguide.pdf vsg;
+           for f in *.ppm;do pnmscale -width=512 $f|pnmtojpeg >${f/ppm/jpg};done
+      -->
+    </div>
+    <p>If you have been maintaining a mirror or other copy of this
+      document, please update it with this version and delete the
+      previous files.</p>
+    <h2>License</h2>
+    <p>This is free documentation, issued under the <a
+	href="http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html">LaTeX 
+	Project Public License</a>.</p>
+    <h2>Files</h2>
+    <table>
+	<tr>
+	  <td colspan="3">Source code</td>
+	</tr>
+	<tr><td><tt><a
+	href="veryshortguide.tex">veryshortguide.tex</a></tt></td><td 
+	align="right">23K</td><td>LaTeX source</td></tr>
+	<tr>
+	  <td colspan="3">Output</td>
+	</tr>
+	<tr><td><tt><a
+	href="veryshortguide.pdf">veryshortguide.pdf</a></tt></td><td 
+	align="right">852K</td><td>PDF output</td></tr>
+	<tr><td><tt><a
+	href="veryshortguide-imposed.pdf">veryshortguide-imposed.pdf</a></tt></td><td 
+	align="right">178K</td><td>PDF output</td></tr>
+	<tr>
+	  <td colspan="3">Images</td>
+	</tr>
+	<tr><td><tt><a href="menno-a.eps">menno-a.eps</a></tt></td><td
+	align="right">444K</td><td>Map (EPS)</td></tr>
+	<tr><td><tt><a href="menno-a.jpg">menno-a.jpg</a></tt></td><td
+	align="right">30K</td><td>Map (JPG)</td></tr>
+    </table>
+    <address>Peter Flynn</address>
+  </body>
+</html>
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 9e74c5d1e4f..5d0b81fe7e8 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 f6d684575ac..a86a6a92bd7 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 591246ec5b5..51f06816e31 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
@@ -1,16 +1,16 @@
 % This is the Very Short Guide to LaTeX, a 4pp folder designed as an
-% aide-memoire for people who have just done a course in LaTeX and
+% 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.
 %
-% Copyright 2006-2009 by Silmaril Consultants <peter@silmaril.ie>
+% Copyright 2006-2013 by Silmaril Consultants <peter@silmaril.ie>
 %
-% This is free documentation, issued under the LaTeX Rroject Public
+% This is free documentation, issued under the LaTeX Project Public
 % License. For details see
 % http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
 %
+% 2013-01-22
 % 2009-10-01
-% 2012-01-11
 %
 % Please do NOT complain that there is no math here. It won't fit.
 % Someone else can do a math leaflet. IANAM.
@@ -58,12 +58,13 @@
 %
 \usepackage[utf8x]{inputenc}
 \usepackage[T1]{fontenc}
-\usepackage{lmodern,utopia,graphicx,url,fancybox,mdwlist,fix-cm,multicol}
+\usepackage{graphicx,url,fancybox,enumitem,fix-cm,multicol,nicefrac}
 \usepackage{fancyvrb,bbding,parskip,ragged2e,calc,ifthen,textcomp,array}
 \usepackage[svgnames]{xcolor}
-\usepackage[scaled=.95]{helvet}
-% compensate for the fact that the Bitstream fonts redefine bx to b
-\DeclareFontShape{T1}{cmr}{b}{it}{<->ssub*cmr/bx/it}{}
+\usepackage[default]{aller}
+\usepackage[default]{warnock}
+%\usepackage[scaled=.95]{helvet}
+%\usepackage[scaled=.87]{luximono}
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
@@ -78,22 +79,21 @@
 \renewcommand{\labelitemi}{\raisebox{-.5ex}{\textcolor{Purple}{\PencilRight}}}
 %
 % Provide commands for distinguishing examples and their output
-\newcommand{\example}{%
-  \color{DarkGreen}\textsf{\fontseries{bc}\selectfont Example:} 
-  \color{DarkRed}}
+\newcommand{\example}{\color{DarkGreen}\textsf{\bfseries Example:} \color{Grey}}
 \def\endexample{\color{black}}
-\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.333ex}
+\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.7ex}
   {\ArrowBoldRightStrobe}~\color{DarkBlue}{\fontfamily{cmr}\selectfont
     #1}\color{black}}
-\newcommand{\nobox}{~\raisebox{-.25ex}{\footnotesize\Square\llap{\color{Red}\XSolidBrush}}}
-\newcommand{\yesbox}{~\raisebox{-.25ex}{\footnotesize\Square\llap{\color{Green}\CheckmarkBold}}}
-\def\ff#1{\fontfamily{#1}\selectfont}
+\newcommand{\nobox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\XSolidBrush}}
+\newcommand{\yesbox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\CheckmarkBold}}
 %
 % In fancyverb's Verbatim, allow rubric embedded as marked text in red
 \newcommand{\comment}[1]{\ifthenelse{\equal{#1}{ }}{}{#1}\normalfont
   \itshape\footnotesize\color{red}}
+% Allow notification of newly-added material
+\newcommand{\added}{\color{MediumBlue}}
 % This reverts rubric back to normal, to avoid embedded spaces
-\newcommand{\revert}{\ttfamily\upshape\normalsize\color{black}}
+\newcommand{\revert}{\ttfamily\upshape\color{black}}
 %
 % Provide keyboard or screen keys or buttons and their icons
 \newcommand{\button}[2][\relax]{\if#1\relax
@@ -128,7 +128,7 @@
   \par\bigskip\hrule\medskip
 }
 % notes
-\renewenvironment{note}{\small\textbf{Note.}\quad}{\par}
+\newenvironment{note}{\small\textbf{Note.}\quad}{\par}
 % pack headings together more tightly
 \renewcommand\section{\@startsection{subsection}{1}{\z@}%
   {-0pt\@plus -.2ex \@minus -.2ex}%
@@ -175,57 +175,63 @@
 \LaTeX\ is a document preparation system for the \TeX\ typesetting
 program. It enables you to produce publication-quality output with
 great accuracy and consistency. \LaTeX\ works on any computer and
-produces industry-standard PS or PDF documents. It is available both
+produces industry-standard PDF or PS 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 a complex structure, repetitive formatting, or notations like
 mathematics\footnote{For reasons of space this guide does not cover
   details of mathematics typesetting.}; or where technical stability,
 dimensional accuracy, or a persistent and non-proprietary file format
-are needed.
+are needed. Install the free software from
+\url{www.tug.org/texlive/} or buy a commercially-supported
+version from one of the vendors (see
+back page).
 
 \subsection{Creating and typesetting your document}
 
-\begin{enumerate*}\setlength{\fboxsep}{1pt}
+\begin{enumerate}[noitemsep]\setlength{\fboxsep}{1pt}
    \item Create your document using any suitable plain-text editor
      with \LaTeX\ controls, eg \textit{\TeX shop} (Mac), \textit{\TeX
-       maker} (all), \textit{Kile} (Linux), \textit{Emacs} (all);
+       nicCenter} (Win), \textit{Kile} (Linux), \textit{Emacs} (all),
+     even \textit{vi}\thinspace!
    \item Save the file with a name ending in \verb+.tex+
      (\emph{never} use spaces in filenames!);
    \item Use the toolbar buttons or menu items in your editor to typeset
-     and display the document;\label{typeset}
+     and display the document (you need \textit{Acrobat Reader} or
+     similar to display the PDF output);\label{typeset}
    \item Make any changes needed in your original document and repeat
      step \ref{typeset}. 
-\end{enumerate*}
+\end{enumerate}
 
 
 \subsection{Syntax (how to type \LaTeX\ commands --- these are the rules)}
 
-\begin{itemize*}
+\begin{itemize}[noitemsep]
   \item \textbf{All \LaTeX\ commands begin with a backslash}.\\
     \example \verb+\tableofcontents+\endexample
   \item \textbf{If a command needs text to work
-    with, it goes in curly braces}.\\
+    with (an `argument'), it goes in curly braces}.\\
     \example \verb+\title{Irisches Tagebuch}\author{Heinrich Böll}+\endexample
-  \item \textbf{If options are used, they go in square brackets first}.\\
+  \item \textbf{If options are used, they go in square brackets first,
+  before the curly braces}.\\
     \example \verb+\documentclass[a4paper,11pt]{book}+\endexample
-  \item \textbf{Space after commands \emph{without} braces gets suppressed}.\\
-    \example \verb+Copyright \copyright +\texttt{\number\year} 
-    \gives{Copyright \copyright \number\year}~\nobox\\
+  \item \textbf{Spaces after commands \emph{without} braces get suppressed}.\\
+    \example \verb+Copyright \copyright␣+\texttt{\number\year} 
+    \gives{Copyright \raisebox{1pt}\copyright \number\year}~\nobox\\
     To prevent this, put empty curly braces after the command.\\
-    \example \verb+Copyright \copyright{} +\texttt{\number\year} 
-    \gives{Copyright \copyright{} \number\year}~\yesbox
+    \example \verb+Copyright \copyright{}␣+\texttt{\number\year} 
+    \gives{Copyright \raisebox{1pt}\copyright{} \number\year}~\yesbox
   \item \textbf{Curly braces are also used to restrict the scope of
     effects inside them}.\\
     \example \verb+Some {\tiny little} word+ \gives{Some {\tiny little} word}
-\end{itemize*}
+\end{itemize}
 
 \vfill
 \begin{note}
-This guide shows only a tiny fraction of \LaTeX's power. For
+This guide shows only a tiny fraction of \LaTeX's power. For more
 information, visit the \TeX\ Users Group site (\url{www.tug.org}). For
-help, see the FAQ (\url{www.tex.ac.uk/faq}), the Usenet newsgroup
-\url{comp.text.tex}, and the site \url{tex.stackexchange.com}. For packages, use the Comprehensive \TeX\ Archive
+help, see the FAQ (\url{www.tex.ac.uk/faq}) and the Usenet newsgroup
+\url{comp.text.tex}. For packages, use the Comprehensive \TeX\ Archive
 Network (\url{www.ctan.org}). For documentation, use the sources in
 the \textit{References} [2].
 \end{note}
@@ -245,16 +251,19 @@ Here's the skeleton of a \LaTeX\ document. These three lines are
 \end{document}
 \end{Verbatim}
 
-\begin{itemize*}
-  \item The document class name must be one of \verb+book+,
-    \verb+article+, or \verb+report+, or an extra one you have
-    downloaded and installed (eg \verb+uccthesis+, \verb+memoir+, etc).
+\begin{itemize}[noitemsep]
+  \item The document class name must be one of the standard \verb+book+,
+    \verb+article+, or \verb+report+, or one of the many extras
+    preinstalled or downloadable (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+).
-  \item There are base type size options \verb+10pt+ (the default),
-    \verb+11pt+, and \verb+12pt+.\label{typesize}
-\end{itemize*}
+    (8\nicefrac12$''\times$11$''$) and others (eg \verb+a5paper+).
+  \item There are body type size options \verb+10pt+ (the default),
+    \verb+11pt+, and \verb+12pt+.
+\end{itemize}
+New material introduced in each example is shown below
+in {\ttfamily\added blue}; previous material in black.
 
 \subsubsection{Front matter}
 
@@ -264,50 +273,52 @@ requirements, and where you put any changes to standard features.
 
 \begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
 \documentclass[a4paper,11pt]{book}
-\usepackage{charter,graphicx}
-\setlength{\parindent}{1em}
+!added\usepackage{charter,graphicx}!revert
+!added\setlength{\parindent}{1em}!revert
 \begin{document}
-\title!comment{your document title!revert}
-\author!comment{your name!revert}
-\date!comment{date of publication!revert}
-\maketitle
-\begin{abstract}
-!comment the paragraphs of the abstract go here
-\end{abstract}
-\tableofcontents
-!comment rest of the document goes here
+!added\title!comment{your document title!revert}
+!added\author!comment{your name!revert}
+!added\date!comment{date of publication!revert}
+!added\maketitle
+!added\begin{abstract}
+!comment the paragraphs of your abstract go here
+!added\end{abstract}
+!added\tableofcontents
+!comment the text of your document goes here
 \end{document}
 \end{Verbatim}
 
-In a typical report or article, the title, author, date, abstract
+In a typical document, 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 as you type. This means `start a
-new paragraph', \emph{not} `leave a blank line'. You control
-spacing and indentation separately by setting \verb+\parskip+ and
-\verb+\parindent+ (see examples), or with the \textsf{parskip}
+Leave a blank line between paragraphs as you type. To \LaTeX, 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+ with the \verb+\setlength+ command as in the
+previous example, or with the \textsf{parskip}
 package.
 
 \subsubsection{Sections and cross-references}
 
 Sections get numbered automatically in bold type, and get included in
 the Table of Contents (if any). Numbering can be turned off
-selectively. Section heading layout can be modified with
+selectively. Section heading layout can be modified with the
 \textsf{sectsty}, \mbox{\textsf{titlesec}}, and other packages. Use
-the \textsf{babel} package for typesetting other languages.
+the \textsf{babel} package for other languages.
 
 \begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
-!comment (Preamble, titling, and abstract as before)
+!comment (Preamble, titling, and abstract as above)
+!added\setcounter{secnumdepth}{3}
 \tableofcontents
-\section!comment{heading of a section!revert}
-!comment text for the section goes here
-...as shown in section \ref{blah}.
-\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 name for the label
+!added\chapter!comment{heading of a chapter!revert}
+!comment text for the chapter goes here
+!added...as shown in section \ref{blah}.
+!added\section!comment{heading of a section!revert}
+!added\label{blah} !comment make up name for the label
 !comment text for the section goes here
+!added\chapter!comment{heading of a new chapter!revert}
+!comment text for the new chapter goes here
 \end{document}
 \end{Verbatim}
 
@@ -320,48 +331,46 @@ out the right numbers to print.\\
 
 \subsubsection{Typefaces}
 
-{\ff{cmr}\LaTeX's default typeface is Computer Modern, like this
-  paragraph. There are a dozen or so built-in typeface packages
-  including:}
+\LaTeX's default typeface is Computer Modern. There is a selection of
+other typeface packages (use them in your Preamble):
 
-{\footnotesize\tabcolsep3pt
-\begin{tabular}{@{}l>{\ttfamily}l|l>{\ttfamily}l@{}}
-\bfseries Face&\normalfont\bfseries Package&\bfseries
-Face&\normalfont\bfseries Package\\\hline\vrule height1.1em width0pt
+{\footnotesize\tabcolsep4pt
+\def\ff#1{\fontfamily{#1}\selectfont}
+\begin{tabular}{@{}l@{\hspace{6pt}}>{\ttfamily}l|l@{\hspace{6pt}}>{\ttfamily}l@{}}
 \ff{ptm}Times&mathptmx&\ff{pcr}Courier&courier\\
 \ff{ppl}Palatino&mathpazo&\ff{pag}\scriptsize Avant Garde&avant\\
 \ff{pbk}Bookman&bookman&\ff{phv}Helvetica&helvet\\
 \ff{bch}Charter&charter&\ff{pzc}Zapf Chancery&chancery\\
 \ff{put}Utopia&utopia&\fontencoding{OT1}\ff{pnr}Pandora&pandora\\
+\ff{pnc}Century&newcent&\fontencoding{U}\ff{yfrak}Fraktur&oldgerm\\
 \end{tabular}
 }
 
+See each package's documentation for details.
+
 \columnbreak\parskip5pt
 
-Many more can be downloaded, including mathematical, display, and
-decorative faces: see the \LaTeX\ Font Catalog
-(\url{www.tug.dk/FontCatalogue/}).  To switch type family, use
-\verb+\sffamily+ for sans-serif, or \verb+\ttfamily+ for monospace. To
-change font for a word or phrase, use these commands:
+Dozens of others are available, including mathematical and decorative
+fonts.  To switch to a sans-serif type family (eg Helvetica, Avant
+Garde), use \verb+\sffamily+ in your text. To change font for a word
+or phrase, use these commands (they can be nested---see below):
 
 {\small
-\begin{tabular}{@{}l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
+\begin{tabular}{l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
       Hello\char'175}@{}>{\ \gives\bgroup}l<{\ Hello\egroup}}
 Italics&it&\itshape\\
-Slanted&sl&\slshape\\
-Bold Face&bf&\bfseries\\
-Small Caps&sc&\scshape\\
+Boldface&bf&\bfseries\\
+Smallcaps&sc&\scshape\\
 Sans-serif&sf&\sffamily~~\\
 Monospace&tt&\ttfamily\\
 \end{tabular}}
 
-\example \verb+\textit{\textbf{\textsf+\verb+{bold+
-\verb+italic sans}}}+
+\example \verb+\textit{\textbf{\textsf+\linebreak
+\verb+{bold italic sans}}}+
 \gives{\textit{\textbf{\textsf{bold italic sans}}}}
 
 Font sizing is automatic for titles, headings, and footnotes. There
-are some named step-size commands (in points, relative to the base
-type size, see p.\pageref{typesize}):
+are some named step-size commands (in points, relative to the base size):
 
 {\small
 \begin{tabular}{>{\ttfamily\char'134}lrrr}
@@ -380,15 +389,18 @@ Huge&20\rlap*&24\rlap*&28\rlap*\\
 \rotatebox[origin=c]{90}{\scriptsize* sizes rounded here to save space}
 }
 
-You can also 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{with} its applicable text in curly braces
-to prevent it affecting the rest of the document. For wider line-spacing
+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}). Enclose the command \emph{and} its applicable text in curly braces
+to prevent it affecting the rest of the document. 
+
+For double or 1\nicefrac12 line-spacing
 (eg in theses) use the \textsf{setspace} package. You can also use
-\linebreak colour with the 
-\\\textsf{xcolor} package and\hfil \smash{\raisebox{0ex}{\Huge 
+RGB, CMYK, HTML, and many other
+\linebreak colourspaces with the 
+\\\textsf{xcolor} package and the\hfil 
+\smash{\raisebox{0ex}{\fontfamily{ppl}\selectfont\Huge\quad
 \textcolor[HTML]{2F50AD}{G}%
 \textcolor[HTML]{B32F17}{o}% 
 \textcolor[HTML]{F3C20B}{o}%
@@ -397,97 +409,106 @@ to prevent it affecting the rest of the document. For wider line-spacing
 \textcolor[HTML]{B32F17}{e}}}%
 % web colour for l was 567122
 % web colour for o2 was CAB340
-\\the \verb+\color{+\texttt{\textit{name}}\verb+}+ command.
+\\\verb+\color{+\texttt{\textit{name}}\verb+}+ command.
+
+For verbatim text, use the \textsf{listings} or
+\textsf{fancyvrb} packages, or the \verb+\verb+ command.
 
 \subsubsection{Lists}
 
-There are three basic types: \textbf{itemized} (bulleted);
-\textbf{enumerated} (numbered or lettered); and
-\textbf{descriptive} (topic-and-explanation). Others can
-be defined, or packages downloaded from CTAN [5].
+There are three basic kinds: \textbf{itemized} lists (bulleted);
+\textbf{enumerated} lists (numbered or lettered); and
+\textbf{descriptive} lists (topic-and-explanation format). Others are
+avaiable on CTAN[5].
 
 \begingroup\tiny
 \renewcommand{\labelitemi}{\textbullet}
 \leftmargini=2em
-\setlength{\tabcolsep}{4pt}
+\setlength{\tabcolsep}{3pt}
 \begin{tabular}{%@{}%
-    p{.22\columnwidth}|%
-    p{.28\columnwidth}|%
+    p{.24\columnwidth}|%
+    p{.30\columnwidth}|%
     p{.33\columnwidth}}
-\begin{Verbatim}
+\begin{verbatim}
 \begin{itemize}
 \item 1lb Sugar
 \item ½pt Cream
 \item Chocolate
+\item 2oz Butter
 \end{itemize}
-\end{Verbatim}
+\end{verbatim}
 &
-\begin{Verbatim}[commandchars=!()]
+\begin{verbatim}
 \begin{enumerate}
 \item Mix together
-\item Boil to 112!textdegree()C
+\item Boil to 112°C
 \item Stir and cool
+\item Pour into dish
 \end{enumerate}
-\end{Verbatim}
+\end{verbatim}
 &
-\begin{Verbatim}
+\begin{verbatim}
 \begin{description}
 \item[Fudge] is fun...
 \item[Broccoli] sucks...
 \item[Exercise] is good
 \end{description}
-\end{Verbatim}
+\end{verbatim}
 \\\hline
-\begin{itemize}
+\begin{itemize}[noitemsep]
 \item 1lb Sugar
 \item ½pt Cream
 \item Chocolate
+\item 2oz Butter
 \end{itemize}
 &
-\begin{enumerate}
+\begin{enumerate}[noitemsep]
 \item Mix together
 \item Boil to 112\textdegree C
 \item Stir and cool
+\item Pour into dish
 \end{enumerate}
 &\tiny
-\begin{description}
-\item[Fudge] is fun but not if made too often.
+\begin{description}[noitemsep]
+\item[Fudge] is fun but fattening if made too often.
 \item[Broccoli] sucks, period.
 \item[Exercise] is good for you if taken daily and not to extremes.
 \end{description}
 \end{tabular}
 \endgroup
-You can nest lists inside each other. See packages like
-\textsf{paralist} and \textsf{mdwlist} to control list formatting.
+You can nest lists inside each other. Use the \textsf{enumitem}
+package to control list formatting.
 
 \subsubsection{Tables and figures}
 
-Formal tables and figures \emph{float} (change position to fill
-available space) so they may not be printed where you typed them. 
+Formal tables and figures will \emph{float} (change position to fit
+available space). Use \verb+\caption+ and \verb+\label+ to caption
+and label tables and figures.
 
 \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-\begin{table}[hbtp] !comment positional specifiers
-\caption{Mean growth rate and intakes 
-of supplement, milk, and water for 4 
-diets.}\label{dietgrowth}\centering
-\begin{tabular}{|l|r|r|r|r|}\hline
-&Growth&Supplement&Milk&Water\\
-Supplement&rate&intake&intake&intake\\
-&(g/day)&(g/day)&(ml/kg$^{0.75}$)&
-(ml/kg$^{0.75}$)\\\hline 
-Lucerne &145&450&10.5&144\\\hline 
-Sesbania&132&476& 9.2&128\\\hline 
-Leucaena&128&364& 8.9&121\\\hline 
-None    & 89&  0& 9.8&108\\\hline 
-\end{tabular}
-\end{table}
+!added\begin{table}
+!added\caption{Mean growth rate and intakes 
+!added of supplement, milk, and water for 4 
+!added diets.}
+\label{dietgrowth}\centering
+!added\begin{tabular}{|l|r|r|r|r|}\hline
+!added&Growth&Supplement&Milk&Water\\
+!added Supplement&rate&intake&intake&intake\\
+!added&(g/day)&(g/day)&(ml/kg$^{0.75}$)&
+!added (ml/kg$^{0.75}$)\\\hline 
+!added Lucerne &145&450&10.5&144\\\hline 
+!added Sesbania&132&476& 9.2&128\\\hline 
+!added Leucaena&128&364& 8.9&121\\\hline 
+!added None    & 89&  0& 9.8&108\\\hline 
+!added\end{tabular}
+!added\end{table}
 \end{Verbatim}
 
 % fake it
 \begin{center}\fontfamily{cmss}\fontsize56\selectfont
 \setlength{\tabcolsep}{2pt}
 \setlength{\arrayrulewidth}{.2pt}
-\begin{tabular}{@{}|l|r|r|r|r|@{}}
+\begin{tabular}{@{}|>{\vrule height1em width0pt}l|r|r|r|r|@{}}
 \multicolumn5l{\textbf{Table 2}: \textit{Mean growth rate and intakes 
 of supplement,}}\\
 \multicolumn5l{\textit{milk, and water for four diets} (after
@@ -518,12 +539,12 @@ comprehensive list at
 \textbf{Tables and Figures}, \textit{continued}
 
 \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-\begin{figure}[ht] !comment ht specifies `here' or `top' if there is space
+!added\begin{figure}
 \caption{Swiss and Dutch Mennonite migrations of the 1700s and 1800s}\label{lmig}
-\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}
+!added\centering !comment (graphics must be EPS files for standard !LaTeX; but JPG, PNG, or PDF for pdf!LaTeX)
+!added\includegraphics[width=.8\columnwidth]{menno-a}\\ !comment (double backslash for forced linebreak)
+!added\scriptsize Courtesy of Paul C. Adams, Department of Geography and the 
+!added Environment, University of Texas at Austin. \cite{adams}\end{figure}
 \end{Verbatim}
 
 \begin{center}\fontfamily{cmss}\selectfont
@@ -536,29 +557,29 @@ and the Environment, University of Texas at Austin.~[1]
 
 \subsubsection{Footnotes, citations, references, and indexes (back matter)}
 \setcounter{footnote}{1} 
-Footnotes are easy:\footnote{Like this.} see below.  Citations using
-BIB\TeX{} (Patashnik, 1988) are also easy (see [2], \S7.4.2) and there
-are formatting packages for journals and publishers. You can add
-indexes with the package \textsf{makeidx}, the \verb+\index+ command
-and the \textsf{makeindex} program.
+You do footnotes with a simple command,\footnote{Like this.} see
+below.  Citations using BIB\TeX{} (Patashnik, 1988) are easy (see
+[2], \char'247 7.4.2), and there are packages for more complex formats for
+journals and publishers. You can add indexes with the \verb+\index+
+and \verb+\printindex+ commands and the \textsf{makeindex} program.
 
 \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-Footnotes are easy:\footnote{Like this.} see below.  Citations using BIB\TeX{} 
-(Patashnik, 1988) are also easy (see [2], \S7.4.2) and there are formatting 
-packages for journals and publishers. You can add indexes with the package
-\textsf{makeidx}, the \verb+\index+ command and the \textsf{makeindex} program.
-!comment add the following at the end of your document and create!ttfamily myrefs.bib!rmfamily (see BIB!TeX manual [3])
-\bibliography{myrefs}\bibliographystyle{apacite}
+You do footnotes with a simple command,!added\footnote{Like this.}!revert see below. Citations 
+using BIB!added\TeX{} \citeauthoryear{oren}!revert are easy (see !added\cite[§7.4.2]{flynn}!revert), and 
+there are packages for more complex formats for journals and publishers. You can 
+add  indexes with the !added\verb`\index`!revert and !added\verb`\printindex`!revert commands and the 
+!added\textsf{makeindex}!revert program. 
+!added\bibliography{myrefs} \bibliographystyle{apalike} !comment (see BIB!TeX manual [3] for details)
 \end{Verbatim}
 
 \vspace*{-3pt}
 \subsubsection{References}
 
-\begin{enumerate*}\footnotesize\RaggedRight
+\begin{enumerate}[noitemsep]\footnotesize\RaggedRight
 \item Adams, Paul C. \textit{Linguistic Chaos in Montreal},
   \url{www.utexas.edu/depts/grg/adams/chaos.ppt}, 2/59, Oct 2006.
 \item {\bfseries Flynn, P. \textit{Formatting Information}, 
-  2011, at \url{latex.silmaril.ie/formattinginformation/}}
+  2005, at \url{latex.silmaril.ie/formattinginformation/}}
 \item Patashnik, O. \textit{BIB\TeX ing}, \TeX\ Users Group, 1988
   (distributed with all copies of \LaTeX).
 \item Sherington, J. example table in `Informative Presentation of
@@ -568,16 +589,13 @@ packages for journals and publishers. You can add indexes with the package
 \item \bfseries\TeX\ Users Group, for \TeX\ Live 
   (\url{www.tug.org/texlive/}) and CTAN
   (Comprehensive \TeX\ Archive Network) for downloads (\url{www.ctan.org}).
-\end{enumerate*}
+\end{enumerate}
 
 \begin{note}
-Commercial implementations of \TeX\ with business-level
-support are available from 
-\textbf{Personal \TeX, Inc} (\textit{PC\TeX}); 
-\textbf{Blue Sky Research} (\textit{Textures}); 
-\textbf{MacKichan Software, Inc} (\textit{Scientific Word});
-\textbf{Micropress, Inc} (\textit{V\TeX}); and
-\textbf{True\TeX\ Software} (\textit{True\TeX}).
+Commercial implementations of \TeX\ with business
+support are available from Personal \TeX, Inc (PC\TeX); Blue Sky
+Research (Textures~[Mac]); MacKichan Software, Inc (Scientific Word);
+Micropress, Inc (V\TeX), True\TeX\ Software (True\TeX), and others.
 \end{note}
 
 \end{document}
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg
new file mode 100755
index 00000000000..f80eeff8ae4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg
new file mode 100755
index 00000000000..fb7b746b3e1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg
new file mode 100755
index 00000000000..706e8a43fde
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg
new file mode 100755
index 00000000000..49e349cfa9e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg