summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-10-03 14:53:36 +0000
committerKarl Berry <karl@freefriends.org>2009-10-03 14:53:36 +0000
commit32d264525281c96ddbb4fa19859eeed042c9dbfd (patch)
tree3f6ce86a3ded2beaf29aab5f1fa1b98b92d98dd3
parent9a4d9e31df6704c65c9a87757996f5836ba881e7 (diff)
latex-veryshortguide 1oct09 (2oct09)
git-svn-id: svn://tug.org/texlive/trunk@15598 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/README75
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdfbin1264780 -> 1274098 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdfbin318815 -> 319370 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdfbin490540 -> 491433 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex60
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
Binary files differ
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
Binary files differ
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
Binary files differ
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}
-