summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-08-11 02:09:46 +0000
committerKarl Berry <karl@freefriends.org>2016-08-11 02:09:46 +0000
commitcbf866cb27098913d37293178005d01dcc91dc03 (patch)
treeed3094b35534a96c130a5aea512790b34b1e1829 /Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx
parentb179788289f81a24df072db0eeb8ea1655ba4e5e (diff)
latex-veryshortguide (10aug16)
git-svn-id: svn://tug.org/texlive/trunk@41836 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx')
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx2091
1 files changed, 2091 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx
new file mode 100644
index 00000000000..8659f82c125
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg.dtx
@@ -0,0 +1,2091 @@
+% \iffalse meta-comment
+%
+% Transformed from vsg.xml by ClassPack db2dtx.xsl
+% version 16.00 (Makefile with XeLaTeX) on Tuesday 9 August 2016 at 21:52:09
+% vsg.dtx is copyright © 2009-2016 by Peter Flynn <peter@silmaril.ie>
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3 of this license or (at your option) any later
+% version. The latest version of this license is in:
+%
+% http://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The current maintainer of this work is Peter Flynn <peter@silmaril.ie>
+%
+% This work consists of the files vsg.dtx and vsg.ins,
+% the derived file vsg.cls, and any ancillary files listed
+% in the MANIFEST.
+%
+% \fi
+% \iffalse
+%<*driver>
+\ProvidesFile{vsg.dtx}
+%</driver>
+%<class>\NeedsTeXFormat{LaTeX2e}[2015/01/01]
+%<class>\ProvidesClass{vsg}[2016/06/14 v0.4
+%<class> The Very Short Guide to LaTeX]
+%<*driver>
+\RequirePackage{fix-cm}% included by default.
+\PassOptionsToPackage{svgnames}{xcolor}% xcolor or hyperref in use
+\PassOptionsToPackage{hyphens}{url}% url, hyperref, biblatex, or metadata detected
+\documentclass[12pt]{ltxdoc}
+%%
+%% Packages added for documentation
+%%
+\usepackage{dox}% included by default. (0)
+ \makeatletter
+ \doxitem[idxtype=attribute]{Attribute}{CPK@attribute}{attributes}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=attributevalue]{AttributeValue}{CPK@attributevalue}{attribute values}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=class]{Class}{CPK@class}{classes}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=colour]{Colour}{CPK@colour}{colours}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=counter]{Counter}{CPK@counter}{counters}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=DTD]{DTD}{CPK@dtd}{DTDs/Schemas}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=element]{Element}{CPK@element}{element types}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=entity]{Entity}{CPK@entity}{entities}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=error]{Error}{CPK@error}{errors}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=function]{Function}{CPK@function}{functions}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=language]{Language}{CPK@language}{languages}
+ \makeatother
+ \makeatletter
+ \doxitem[macrolike,idxtype=length]{Length}{CPK@length}{lengths}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=mode]{Mode}{CPK@mode}{modes}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=option]{Option}{CPK@option}{options}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=package]{Package}{CPK@package}{packages}
+ \makeatother
+ \makeatletter
+ \doxitem[macrolike,idxtype=switch]{Switch}{CPK@switch}{switches}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=template]{Template}{CPK@template}{templates}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=typeface]{Typeface}{CPK@typeface}{typefaces}
+ \makeatother
+ \makeatletter
+ \doxitem[idxtype=font]{Font}{CPK@font}{fonts}
+ \makeatother
+ \newcommand{\LabelFont}[2][\relax]{\strut
+ {\fontencoding\encodingdefault
+ \fontfamily{lmtt}\fontseries{lc}#1\selectfont#2}\space}
+ \makeatletter
+ \let\CPK@macro\macro\let\CPK@endmacro\endmacro
+ \makeatother
+ \makeatletter
+ \let\CPK@environment\environment\let\CPK@endenvironment\endenvironment
+ \makeatother
+ \makeatletter
+ \def\PrintAttributeName#1{\LabelFont{@#1}}
+ \makeatother
+ \def\PrintAttributeValueName#1{\LabelFont{"#1"}}
+ \def\PrintClassName#1{\LabelFont[\fontfamily{lmss}]{#1}}
+ \def\PrintColourName#1{\LabelFont[\color{#1}]{#1}}
+ \def\PrintCounterName#1{\LabelFont{#1}}
+ \def\PrintDTDName#1{\LabelFont{#1}}
+ \def\PrintElementName#1{\LabelFont{<#1>}}
+ \def\PrintEntityName#1{\LabelFont{\&#1;}}
+ \def\PrintEnvironmentName#1{\LabelFont[\fontfamily{lmss}]{#1}}
+ \def\PrintErrorName#1{\LabelFont[\color{Red}!]{#1}}
+ \def\PrintFunctionName#1{\LabelFont[\bfseries\itshape]{#1}}
+ \def\PrintLanguageName#1{\LabelFont{#1}}
+ \def\PrintLengthName#1{\LabelFont{#1}}
+ \def\PrintMacroName#1{\LabelFont{#1}}
+ \def\PrintModeName#1{\LabelFont[\sffamily]{\textlangle#1\textrangle}}
+ \def\PrintOptionName#1{\LabelFont[\bfseries]{#1}}
+ \def\PrintPackageName#1{\LabelFont[\fontfamily{lmss}]{#1}}
+ \def\PrintSwitchName#1{\LabelFont{#1}}
+ \def\PrintTemplateName#1{\LabelFont[\bfseries]{#1}}
+%% inputenc omitted: conflicts with fontspec (3)
+%% fontenc omitted: conflicts with fontspec (5)
+\usepackage{fontspec}% a part/@conformance='xelatex' was detected. (6)
+\usepackage{mflogo}% included by default. (28)
+\usepackage[british]{babel}% included by default. (33)
+\usepackage{array}% use of 'tgroup' was detected (37)
+\usepackage{calc}% included by default. (39)
+\usepackage{ccaption}% included by default. (41)
+ \captionnamefont{\bfseries}
+ \captionstyle{\raggedright}
+\usepackage[inline]{enumitem}% use of 'variablelist' was detected (45)
+ \setlist[description]{style=unboxed}
+\usepackage{fancybox}% use of 'note' was detected (46)
+\usepackage{fancyvrb}% use of 'bibliography' was detected (49)
+\usepackage{textcase}% included by default. (55)
+\usepackage[a4paper,left=30mm,top=25mm,
+ textwidth=150mm,textheight=225mm]{geometry}% included by default. (58)
+\usepackage{listings}% use of 'programlisting' was detected (67)
+ \lstdefinelanguage{dummy}
+ {morekeywords={dummy}}
+
+ \lstdefinelanguage{Makefile}
+ {otherkeywords={.PHONY,.DEFAULT},%
+ morekeywords={PHONY,DEFAULT,shell,ifeq,else,endif},%
+ keywordsprefix={.},%
+ moredelim=[l][\color{Green}]{:},%
+ morecomment=[l]{\#},%
+ moredelim=[s][\color{Blue}]{\$(}{)}%
+ }
+ \lstdefinelanguage{DocBook}[]{XML}
+ {morekeywords={abstract,address,affiliation,annotation,arg,
+ author,book,chapter,classname,cmdsynopsis,command,
+ constraintdef,contrib,copyright,cover,date,email,emphasis,
+ envar,filename,firstname,footnote,guibutton,guilabel,
+ guimenu,guimenuitem,guisubmenu,holder,info,itemizedlist,
+ listitem,literal,member,option,orderedlist,orgdiv,orgname,
+ package,para,parameter,part,personname,phrase,procedure,
+ productname,programlisting,quote,refsection,remark,
+ constructorsynopsis,methodparan,modifier,funcparams,olink,
+ bibliography,biblioentry,biblioset,subtitle,artpagenums,
+ volumenum,issuenum,DOCTYPE,SYSTEM,xml:id,releaseinfo,
+ replaceable,revdescription,revhistory,revision,sect1,sect2,
+ sect3,sect4,seg,seglistitem,segmentedlist,segtitle,
+ simplelist,step,surname,systemitem,tag,term,title,uri,
+ userinput,variablelist,varlistentry,wordasword,xref,year,
+ xlink:href}}
+
+ \makeatletter
+ \lstdefinelanguage{bash}
+ {morestring=[s]{[]},morekeywords={exit,logout,yes,no,@,
+ password,ssh,URL,cd,dvips,latex,ls,makeindex,man,mkdir,
+ pdflatex,sudo,texconfig,texdoc,updmap,xelatex}}
+
+ \makeatother
+ \lstdefinelanguage{APA}[]{XML}
+ {morekeywords={TTL}}
+
+ \lstdefinelanguage{OOXML}[]{XML}
+ {morekeywords={w:p,w:pPr,w:pStyle,w:rPr,w:rFonts,
+ w:r,w:t,w:lang}}
+
+ \lstdefinelanguage{SGML}[]{XML}
+ {morekeywords={sec,ttl}}
+
+ \lstdefinelanguage{DTD}[]{XML}
+ {morekeywords={ELEMENT,ENTITY,ATTLIST,CDATA,ID,REQUIRED,
+ IMPLIED,PCDATA}}
+
+ \lstdefinelanguage{Runoff}
+ {morekeywords={h1}}
+
+ \lstdefinelanguage{GML}
+ {morekeywords={h1}}
+
+ \lstdefinelanguage{Scribe}
+ {morekeywords={Heading},morestring=[s]{[]}}
+
+ \lstdefinelanguage{RTF}[]{TeX}
+ {moretexcs={rtf,ansi,deff,adeflang,fonttbl,f,froman,fprq,
+ fcharset,f1,fswiss,falt,fnil,colortbl,red,green,blue,
+ stylesheet,s,snext,nowidctlpar,hyphen,hyphlead,hyphtrail,
+ hyphmax,cf,kerning,dbch,af,langfe,afs,alang,loch,fs,
+ pgndec,pard,plain,qc,sb,sa,keepn,b,ab,rtlch,ltrch,par}}
+
+ \lstdefinelanguage{TEI}[]{XML}
+ {morekeywords={TEI,TEI.2,teiHeader,fileDesc,sourceDesc,
+ titleStmt,title,author,editor,respStmt,resp,name,
+ editionStmt,edition,text,body,publicationStmt,publisher,
+ div,div1,placeName,lg,l,s,cl,phr,w,list,distinct,p,pb,
+ mls,div2,head,num,val,app,lem,rdg,q,sup,uncl,note,
+ DOCTYPE,SYSTEM,xml:id}}[keywords,comments,strings]
+
+ \lstdefinelanguage{XSLT2}[]{XML}
+ {morekeywords={xsl:stylesheet,xsl:transform,
+ xsl:apply-imports,xsl:attribute-set,xsl:decimal-format,
+ xsl:import,xsl:include,xsl:key,xsl:namespace-alias,
+ xsl:output,xsl:param,
+ xsl:preserve-space,xsl:strip-space,xsl:template,
+ xsl:variable,xsl:character-map,xsl:function,
+ xsl:import-schema,xsl:param,xsl:variable,
+ xsl:apply-imports,xsl:apply-templates,xsl:attribute,
+ xsl:call-template,xsl:choose,xsl:comment,xsl:copy,
+ xsl:copy-of,xsl:element,xsl:fallback,xsl:for-each,
+ xsl:if,xsl:message,xsl:number,xsl:otherwise,
+ xsl:processing-instruction,xsl:text,xsl:value-of,
+ xsl:variable,xsl:when,xsl:with-param,xsl:sort,
+ xsl:for-each-group,xsl:next-match,xsl:analyze-string,
+ xsl:namespace,xsl:result-document,xsl:copy,
+ xsl:fallback,xsl:document,xsl:sequence,
+ xsl:matching-substring,xsl:non-matching-substring,
+ xsl:perform-sort,xsl:output-character},
+ alsodigit={-}}
+
+ \lstdefinelanguage{LaTeXe}[LaTeX]{TeX}
+ {morekeywords = {selectlanguage,foreignlanguage,
+ textbrokenbar,textlangle,textrangle,subsection,url,
+ chapter,tableofcontents,part,subsubsection,paragraph,
+ subparagraph,maketitle,setlength,listoffigures,
+ listoftables,color,arraybackslash,includegraphics,
+ textcite,parencite,graphicspath,lstinline,
+ DeclareLanguageMapping,textcolor,definecolor,colorbox,
+ fcolorbox,RequirePackage,PassOptionsToPackage}}
+
+ \lstdefinelanguage{BIBTeX}{
+ morekeywords = {title,author,edition,publisher,year,
+ address},
+ morestring=[b]",
+ }
+
+ \lstdefinelanguage{Email}{
+ morekeywords={From,Subject,To,Date},
+ }
+
+ \lstset{defaultdialect=LaTeXe,frame=single,
+ framesep=.5em,backgroundcolor=\color{AliceBlue},
+ rulecolor=\color{LightSteelBlue},framerule=1pt}
+
+ \lstloadlanguages{LaTeXe,DocBook,XML,XSLT2,bash}
+ \lstnewenvironment{listingsdoc}
+ {\lstset{language={[LaTeX]TeX}}}
+ {}
+ \newcommand\basicdefault[1]{\footnotesize
+ \color{Black}\ttfamily#1}
+
+ \lstset{basicstyle=\basicdefault{\spaceskip.5em}}
+ \lstset{literate=
+ {§}{{\S}}1
+ {©}{{\raisebox{.125ex}{\copyright}\enspace}}1
+ {«}{{\guillemotleft}}1
+ {»}{{\guillemotright}}1
+ {Á}{{\'A}}1
+ {Ä}{{\"A}}1
+ {É}{{\'E}}1
+ {Í}{{\'I}}1
+ {Ó}{{\'O}}1
+ {Ö}{{\"O}}1
+ {Ú}{{\'U}}1
+ {Ü}{{\"U}}1
+ {ß}{{\ss}}2
+ {à}{{\`a}}1
+ {á}{{\'a}}1
+ {ä}{{\"a}}1
+ {é}{{\'e}}1
+ {í}{{\'i}}1
+ {ó}{{\'o}}1
+ {ö}{{\"o}}1
+ {ú}{{\'u}}1
+ {ü}{{\"u}}1
+ {ı}{{\i}}1
+ {—}{{---}}1
+ {’}{{'}}1
+ {…}{{\dots}}1
+ {␣}{{\textvisiblespace}}1,
+ keywordstyle=\color{DarkGreen}\bfseries,
+ identifierstyle=\color{DarkRed},
+ commentstyle=\color{Gray}\upshape,
+ stringstyle=\color{DarkBlue}\upshape,
+ emphstyle=\color{Chocolate}\upshape,
+ showstringspaces=false,
+ columns=fullflexible,
+ keepspaces=true}
+\usepackage{makeidx}% included by default. (68)
+ \makeindex
+\usepackage{nicefrac}% included by default. (73)
+ \def\textonehalf{\ensuremath{\nicefrac12}}
+\usepackage{parskip}% requested by author (75)
+\usepackage{pdfpages}% a imagedata/@format='pdf' was detected. (76)
+\usepackage{sectsty}% included by default. (78)
+ \allsectionsfont{\sffamily}
+ \renewcommand*{\descriptionlabel}[1]{\hspace\labelsep
+ \sffamily\bfseries #1}
+\usepackage[normalem]{ulem}% use of 'link' was detected (84)
+\usepackage{url}% use of 'ulink' was detected (85)
+ \AtBeginDocument{\urlstyle{tt}}
+\usepackage{varioref}% use of 'xref' was detected (88)
+ \vrefwarning
+ \labelformat{appendix}{Appendix~#1}
+ \makeatletter
+ \labelformat{chapter}{\@chapapp~#1}
+ \makeatother
+ \labelformat{section}{section~#1}
+ \labelformat{subsection}{section~#1}
+ \labelformat{subsubsection}{section~#1}
+ \labelformat{paragraph}{section~#1}
+ \labelformat{figure}{Figure~#1}
+ \labelformat{table}{Table~#1}
+ \labelformat{item}{item~#1}
+ \renewcommand{\reftextcurrent}{elsewhere on this
+ page}
+ \def\reftextafter{on the
+ \reftextvario{next}{following} page}
+\usepackage{xcolor}% included by default. (90)
+ \makeatletter
+ \@ifundefined{T}{%
+ \newcommand{\T}[2]{{\fontencoding{T1}\selectfont#2}}}{}
+ \makeatother
+\usepackage{menukeys}% use of 'guimenu' was detected (92)
+ \renewmenumacro{\menu}[>]{roundedmenus}
+ \renewmenumacro{\directory}[/]{hyphenatepathswithfolder}
+ \renewmenumacro{\keys}{shadowedroundedkeys}
+\usepackage{classpack}% included by default. (93)
+\newcommand{\classorpackage}{class}
+%
+%%
+%% Settings for docstrip and latexdoc
+%%
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+ \DocInput{vsg.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{1031}
+%
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \changes{v0.4}{2016/06/14}{Moved into ClassPack: Added parameterisation for A4 and Legal.}
+% \changes{v0.3}{2016/06/04}{Updated to \XeLaTeX{}: Changed fonts again, switched to biber.}
+% \changes{v0.2}{2013/01/22}{Reissue: Fixed typos and changed font.}
+% \changes{v0.1}{2009/10/01}{Reworked from 2006 original: Changed to 4pp A4.}
+%
+% \GetFileInfo{vsg.dtx}
+%
+% \DoNotIndex{\@,\@@par,\@beginparpenalty,\@empty}
+% \DoNotIndex{\@flushglue,\@gobble,\@input}
+% \DoNotIndex{\@makefnmark,\@makeother,\@maketitle}
+% \DoNotIndex{\@namedef,\@ne,\@spaces,\@tempa}
+% \DoNotIndex{\@tempb,\@tempswafalse,\@tempswatrue}
+% \DoNotIndex{\@thanks,\@thefnmark,\@topnum}
+% \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa,\@totalleftmargin}
+% \DoNotIndex{\",\/,\@ifundefined,\@nil,\@verbatim,\@vobeyspaces}
+% \DoNotIndex{\|,\~,\ ,\active,\advance,\aftergroup,\begingroup,\bgroup}
+% \DoNotIndex{\mathcal,\csname,\def,\documentstyle,\dospecials,\edef}
+% \DoNotIndex{\egroup}
+% \DoNotIndex{\else,\endcsname,\endgroup,\endinput,\endtrivlist}
+% \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef,\global}
+% \DoNotIndex{\hbox,\hss,\if,\if@inlabel,\if@tempswa,\if@twocolumn}
+% \DoNotIndex{\ifcase}
+% \DoNotIndex{\ifcat,\iffalse,\ifx,\ignorespaces,\index,\input,\item}
+% \DoNotIndex{\jobname,\kern,\leavevmode,\leftskip,\let,\llap,\lower}
+% \DoNotIndex{\m@ne,\next,\newpage,\nobreak,\noexpand,\nonfrenchspacing}
+% \DoNotIndex{\obeylines,\or,\protect,\raggedleft,\rightskip,\rm,\sc}
+% \DoNotIndex{\setbox,\setcounter,\small,\space,\string,\strut}
+% \DoNotIndex{\strutbox}
+% \DoNotIndex{\thefootnote,\thispagestyle,\topmargin,\trivlist,\tt}
+% \DoNotIndex{\twocolumn,\typeout,\vss,\vtop,\xdef,\z@}
+% \DoNotIndex{\,,\@bsphack,\@esphack,\@noligs,\@vobeyspaces,\@xverbatim}
+% \DoNotIndex{\`,\catcode,\end,\escapechar,\frenchspacing,\glossary}
+% \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht,\it,\langle}
+% \DoNotIndex{\leaders,\long,\makelabel,\marginpar,\markboth,\mathcode}
+% \DoNotIndex{\mathsurround,\mbox,\newcount,\newdimen,\newskip}
+% \DoNotIndex{\nopagebreak}
+% \DoNotIndex{\parfillskip,\parindent,\parskip,\penalty,\raise,\rangle}
+% \DoNotIndex{\section,\setlength,\TeX,\topsep,\underline,\unskip,\verb}
+% \DoNotIndex{\vskip,\vspace,\widetilde,\\,\%,\@date,\@defpar}
+% \DoNotIndex{\[,\{,\},\]}
+% \DoNotIndex{\count@,\ifnum,\loop,\today,\uppercase,\uccode}
+% \DoNotIndex{\baselineskip,\begin,\tw@}
+% \DoNotIndex{\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k,\l,\m,\n,\o,\p,\q}
+% \DoNotIndex{\r,\s,\t,\u,\v,\w,\x,\y,\z,\A,\B,\C,\D,\E,\F,\G,\H}
+% \DoNotIndex{\I,\J,\K,\L,\M,\N,\O,\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z}
+% \DoNotIndex{\1,\2,\3,\4,\5,\6,\7,\8,\9,\0}
+% \DoNotIndex{\!,\#,\$,\&,\',\(,\),\+,\.,\:,\;,\<,\=,\>,\?,\_}
+% \DoNotIndex{\discretionary,\immediate,\makeatletter,\makeatother}
+% \DoNotIndex{\meaning,\newenvironment,\par,\relax,\renewenvironment}
+% \DoNotIndex{\repeat,\scriptsize,\selectfont,\the,\undefined}
+% \DoNotIndex{\arabic,\do,\makeindex,\null,\number,\show,\write,\@ehc}
+% \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title,\everypar}
+% \DoNotIndex{\if@minipage,\if@restonecol,\ifeof,\ifmmode}
+% \DoNotIndex{\lccode,\newtoks,\onecolumn,\openin,\p@,\SelfDocumenting}
+% \DoNotIndex{\settowidth,\@resetonecoltrue,\@resetonecolfalse,\bf}
+% \DoNotIndex{\clearpage,\closein,\lowercase,\@inlabelfalse}
+% \DoNotIndex{\selectfont,\mathcode,\newmathalphabet,\rmdefault}
+% \DoNotIndex{\bfdefault,\DeclareRobustCommand}
+% \DoNotIndex{\classorpackage}
+% \DoNotIndex{\centering}
+% \DoNotIndex{\descriptionlabel}
+%
+% \def\fileversion{0.4}
+% \def\filedate{2016/06/14}
+% \title{The \textsf{vsg} \LaTeXe\ document class\thanks{%
+% This document corresponds to \textsf{vsg}
+% \textit{v.}\ \fileversion $\beta$, dated \filedate.}
+% \\[1em]\Large
+% The Very Short Guide to \LaTeX{}}
+% \author{Peter Flynn\\\normalsize Silmaril Consultants\\[-.25ex]\normalsize \\\normalsize(\url{peter@silmaril.ie})}
+% \maketitle
+% \renewcommand{\abstractname}{Summary}\thispagestyle{empty}
+% \begin{abstract}
+% \parskip=0.5\baselineskip
+% \advance\parskip by 0pt plus 2pt
+% \parindent=0pt% \noindent
+% This is a document class derived from the original
+% \emph{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
+% \emph{not} intended as a substitute for full
+% documentation.\par
+% This class is designed for this document only, but adds
+% parameterisation to allow reformatting tweaks for different
+% paper sizes (A4 and Legal) to allow it to be printed two-sided
+% as a 4pp folder.\par
+% Please do not complain that there is no math here. It
+% won't fit. Someone else can do a math leaflet. IANAM.\par
+% \end{abstract}
+% \clearpage
+% \tableofcontents
+% \clearpage
+% \section*{Latest changes}
+% \subsection*{v.0.4 (2016-06-14)}
+% \paragraph*{Moved into ClassPack}
+% \begin{itemize}
+% \item Added parameterisation for A4 and Legal
+% \end{itemize}
+% \subsection*{v.0.3 (2016-06-04)}
+% \paragraph*{Updated to \XeLaTeX{}}
+% \begin{itemize}
+% \item Changed fonts again, switched to
+% \emph{biber}
+% \end{itemize}
+% \subsection*{v.0.2 (2013-01-22)}
+% \paragraph*{Reissue}
+% \begin{itemize}
+% \item Fixed typos and changed font
+% \end{itemize}
+% \subsection*{v.0.1 (2009-10-01)}
+% \paragraph*{Reworked from 2006 original}
+% \begin{itemize}
+% \item Changed to 4pp A4
+% \end{itemize}
+% See p.\thinspace\pageref{changehistory} for details of earlier changes.
+% \clearpage
+% \section{Acknowledgements}
+% Thanks to all those on c.t.t whose suggestions made this
+% version more useful.\par
+% Alan Munn for the distinction between base font and font
+% package and for suggesting ``expected functionality'' packages
+% on sectioning, long tables, headers, and double spacing, and
+% links to FAQ and CTAN.\par
+% Lars Madsen, Will Robertson, Robin Fairbairns and others
+% for asking for the center environment in tables and figures to
+% be replaced with the {\ttfamily{}\textbackslash{}centering} command (I
+% still disagree, but WTF :-)\par
+% Tsy for spotting a typo in the table code sample.\par
+% Rob Felty and Domink Wass for pointing me at Winston
+% Chang's excellent \emph{LaTeX Cheat Sheet}
+% summary.\par
+% \clearpage
+% \section{Usage}
+% The document class is designed solely for the Very Short
+% Guide, and it is not envisaged that it would be of any use for
+% other types of document except similar short guides.\par
+% \subsection{Options}
+% The only available options are:\par
+% \begin{description}[style=unboxed]
+% \item[\textbf{\texttt{a5paper}}\thinspace:](the default) formats it as four pages of A5, suitable
+% for imposition two-up on A4 for double-sided printing.
+% \item[\textbf{\texttt{legalpaper}}\thinspace:]format it as four pages each half the size of a
+% sheet of US Legal (8.5x14in) so that the
+% same imposition can be used to print on Legal paper.
+% \end{description}
+% \par\begingroup\fboxsep1em\centering
+% \fbox{\begin{minipage}{0.8\columnwidth}\sffamily
+% \raggedright\parindent0pt\parskip=.5\baselineskip
+% \subsubsection*{\sffamily Warning}
+% A lot of stuff is faked up in the document, because
+% we're combining incompatible things for the sake of showing
+% examples which would not normally occur in a normal
+% document, let alone one as small as this. The demands of
+% space mean that there is far more manual adjustment needed
+% than would be seen in a standard continuous-text document.
+% Live with it.\par
+% \end{minipage}}\par\endgroup
+% \subsection{Printing}
+% To impose for printing, use the
+% \emph{pdf2ps} utility to convert the
+% \textsc{pdf} output to \textsc{ps}. Pass
+% it through the \emph{pstops} utility to
+% perform imposition, and then use
+% \emph{ps2pdf} to convert the output back
+% to \textsc{pdf}. For the A5/A4 format, this means:\par
+% \iffalse
+%<*ignore>
+% \fi
+\begin{lstlisting}[language=bash]
+pdf2ps veryshortguide.pdf - |\
+ pstops -pa4 -b \
+ "4:-3L(21cm,5mm)+0L(21cm,14.35cm),1L(21cm,5mm)+-2L(21cm,14.35cm)" |\
+ ps2pdf - veryshortguide-imposed.pdf
+\end{lstlisting}
+% \iffalse
+%</ignore>
+% \fi
+% Pages are references from zero (the first page). This
+% outputs page 3 (p.4) and page 0 (p.1) on the first side of
+% A4. The 21cm places the reference point (top left corner) at
+% that distance \emph{up} (\(y\)-axis, the short side of a piece of A4
+% landscape), and 5mm to the \emph{right}
+% (\(x\)-axis, the long side) for p.4, and 14.35cm to
+% the right for p.1.\par
+% The verso is produced by the second expression, outputting
+% page 1 (p.2) and page 2 (p.3) in exactly the same way.\par
+% \clearpage
+% \begin{figure}[p]\small\sffamily\centering
+% \caption{Effect of imposition (A4 version) above: front and
+% back; below: inside.}\medskip
+% \includepdf[pages=1,scale=0.7,angle=270,offset=0 7.2cm,frame]{veryshortguide-A4-imposed.pdf}
+% \par
+% \includepdf[pages=2,scale=0.7,angle=270,offset=0 -4.2cm,frame]{veryshortguide-A4-imposed.pdf}
+% \end{figure}
+% \clearpage
+% Normally, there would be no horizontal adjustment, but
+% because my printer cannot print the bottom 12mm of a sheet
+% (the last edge to emerge from the printer), if I print 2–up A5
+% pages on an A4 sheet like this, I need to allow for the fact
+% that one edge of two of the pages must have a 12mm margin, so
+% this amount of adjustment (5mm) was needed to make it
+% symmetrical. If your printer can bleed off the trailing edge,
+% then you can adjust the horizontal dimensions accordingly.\par
+% When printing from Acrobat Reader, it generates the
+% \emph{lpr}\thinspace(1) command that it
+% will use. The example below is from my own system:\par
+% \iffalse
+%<*ignore>
+% \fi
+\begin{lstlisting}[language={[LaTeX]TeX}]
+lpr -P \
+ Officejet-Pro-K8600 -o PageSize=A6.SM -o PageRegion=A4 \
+ -o Duplex=DuplexTumble -o InputSlot=Auto -o ColorModel=RGB \
+ -o MediaType=Automatic -o OutputMode=Normal -o OptionDuplex=True
+\end{lstlisting}
+% \iffalse
+%</ignore>
+% \fi
+% \StopEventually{\label{endcode}
+% \clearpage
+% \newgeometry{left=3cm}
+% \addcontentsline{toc}{section}{Change History}
+% \label{changehistory}
+% \PrintChanges
+% \clearpage
+% \label{codeindex}
+% \addcontentsline{toc}{section}{Index}
+% \PrintIndex}
+% \addtolength{\revmarg}{\widthof{\LabelFont{descriptionlabel}}}
+% \newgeometry{left=\revmarg}
+% \iffalse
+%<*class>
+% \fi
+% \section{Auto-initialisation}
+% This section is added automatically by \textit{ClassPack}
+% as a preamble to all classes. The \textsf{fixltx2e}
+% package is no longer preloaded, as all its
+% features are now a part of the latest \LaTeX\ kernel.\par
+% \begin{CPK@package}{fix-cm}
+% Preloaded functions to override the default \LaTeX\ step-size font
+% sizes (which can still be used, but are no longer restrictions).\par
+% \begin{macrocode}
+\RequirePackage{fix-cm}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@option}{svgnames}
+% Pass the \textbf{\texttt{svgnames}} option to the \textsf{xcolor}
+% package if that gets loaded later. This avoids a conflict with
+% whatever other packages (eg \textsf{hyperref}) use as their own
+% default is when they load \textsf{xcolor}.\par
+% \begin{macrocode}
+\PassOptionsToPackage{svgnames}{xcolor}
+\PassOptionsToPackage{hyphens}{url}
+% \end{macrocode}
+% \end{CPK@option}
+% \clearpage
+% \section{Implementation}\label{imp}
+% \subsection{Define the paper-size options:}
+% \begin{CPK@switch}{\iflegal}
+% To make the selection persist so we can us it later,
+% we define two \TeX{} conditionals, one for Legal paper;\par
+% \begin{macrocode}
+\newif\iflegal
+% \end{macrocode}
+% \end{CPK@switch}
+% \begin{CPK@switch}{\ifafive}
+% and
+% one for A5:\par
+% \begin{macrocode}
+\newif\ifafive
+% \end{macrocode}
+% \end{CPK@switch}
+% \begin{CPK@macro}{\afivetrue}
+% and set the A5 one as the default\par
+% \begin{macrocode}
+\afivetrue
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\VSG@papersize}
+% Now parameterise the options with macros to hold the
+% paper size:\par
+% \begin{macrocode}
+\gdef\VSG@papersize{a5paper}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\VSG@margins}
+% and the appropriate margins for the
+% \textsf{geometry} package (later):\par
+% \begin{macrocode}
+\gdef\VSG@margins{margin=12mm,bottom=10mm}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@option}{a5paper}
+% Then define the A5 option to set the paper size and
+% margins and set its switch to true (and the other to false):\par
+% \begin{macrocode}
+\DeclareOption{a5paper}{%
+ \gdef\VSG@papersize{a5paper}%
+ \gdef\VSG@margins{margin=12mm,bottom=10mm}
+ \afivetrue\legalfalse}
+% \end{macrocode}
+% \end{CPK@option}
+% \begin{CPK@option}{legalpaper}
+% And repeat for the Legal option:\par
+% \begin{macrocode}
+\DeclareOption{legalpaper}{%
+ \gdef\VSG@papersize{papersize={7in,8.5in}}%
+ \gdef\VSG@margins{margin=15mm,bottom=15mm}
+ \legaltrue\afivefalse}
+% \end{macrocode}
+% \end{CPK@option}
+% \subsection{Load the base document class}\label{classload}
+% This class is based on the standard \LaTeX{}
+% \textsf{article} class, with no special
+% options.\par
+% \begin{macrocode}
+\DeclareOption*{%
+ \PassOptionsToClass{%
+ \CurrentOption}{article}}
+\ProcessOptions\relax
+\LoadClass{article}
+% \end{macrocode}
+%\iffalse
+%%
+%% Packages required
+%%
+% \fi
+% \subsection{Packages required for the class}\label{clspackages}
+% \begin{CPK@package}{geometry}
+% Package for establishing margins and text area.
+% Use the paper size and margins that were specified when the relevant option was selected by the used (or the A5 default). ()
+% \iffalse
+%% Package for establishing margins and text area.
+% \fi
+% \begin{macrocode}
+\RequirePackage[nohead,\VSG@papersize,
+ \VSG@margins]{geometry}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{fontspec}
+% Font specification setup for use with \XeLaTeX{}.
+% \iffalse
+%% Font specification setup for use with \XeLaTeX{}.
+% \fi
+% \begin{macrocode}
+\RequirePackage{fontspec}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{caladea}
+% Caladea family of fonts, designed by Carolina Giovagnoli
+% and Andres Torresi of the Huerta Tipografica foundry and
+% adopted by Google for ChromeOS as a font-metric compatible
+% replacement for Cambria.
+% \iffalse
+%% Caladea family of fonts, designed by Carolina Giovagnoli and Andres Torresi of the Huerta Tipografica foundry and adopted by Google for ChromeOS as a font-metric compatible replacement for Cambria.
+% \fi
+% \begin{macrocode}
+\RequirePackage{caladea}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{raleway}
+% The current Raleway family is an extension of the original
+% Raleway Thin by Matt McInerney. The family has been extended
+% by Impallari, for more information see the impallari website
+% \url{http://www.impallari.com/projects/overview/matt-mcinerneys-raleway-family}.
+% \iffalse
+%% The current Raleway family is an extension of the original Raleway Thin by Matt McInerney. The family has been extended by Impallari, for more information see the impallari website http://www.impallari.com/projects/overview/matt-mcinerneys-raleway-family.
+% \fi
+% \begin{macrocode}
+\RequirePackage[scale=.9]{raleway}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{graphicx}
+% Provide for graphics (PNG, JPG, or PDF format (only) for
+% pdflatex; EPS format (only) for standard \LaTeX{}).
+% \iffalse
+%% Provide for graphics (PNG, JPG, or PDF format (only) for pdflatex; EPS format (only) for standard \LaTeX{}).
+% \fi
+% \begin{macrocode}
+\RequirePackage{graphicx}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{url}
+% Handling of URI formatting.
+% \iffalse
+%% Handling of URI formatting.
+% \fi
+% \begin{macrocode}
+\RequirePackage{url}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{fancybox}
+% This provides round-cornered and drop-shadow boxes.
+% \iffalse
+%% This provides round-cornered and drop-shadow boxes.
+% \fi
+% \begin{macrocode}
+\RequirePackage{fancybox}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{enumitem}
+% List variants: inline and compact. Note that this replaces
+% the earlier defaults of \textsf{paralist} and
+% \textsf{mdwlist}.
+% \iffalse
+%% List variants: inline and compact. Note that this replaces the earlier defaults of paralist and mdwlist.
+% \fi
+% \begin{macrocode}
+\RequirePackage[inline]{enumitem}
+ \setlist[description]{style=unboxed}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{fix-cm}
+% Allow infinitely-variable font scaling.
+% \iffalse
+%% Allow infinitely-variable font scaling.
+% \fi
+% \begin{macrocode}
+\RequirePackage{fix-cm}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{multicol}
+% Provides multi-column typesetting.
+% \iffalse
+%% Provides multi-column typesetting.
+% \fi
+% \begin{macrocode}
+\RequirePackage{multicol}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{nicefrac}
+% Slanted fractions, even in math mode.
+% \iffalse
+%% Slanted fractions, even in math mode.
+% \fi
+% \begin{macrocode}
+\RequirePackage{nicefrac}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{fancyvrb}
+% Add more robust verbatim facilities.
+% \iffalse
+%% Add more robust verbatim facilities.
+% \fi
+% \begin{macrocode}
+\RequirePackage{fancyvrb}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{bbding}
+% Karel Horak's dingbats symbols.
+% \iffalse
+%% Karel Horak's dingbats symbols.
+% \fi
+% \begin{macrocode}
+\RequirePackage{bbding}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{parskip}
+% Creates paragraphs separated by white-space with no
+% indentation.
+% \iffalse
+%% Creates paragraphs separated by white-space with no indentation.
+% \fi
+% \begin{macrocode}
+\RequirePackage{parskip}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{ragged2e}
+% Allow hyphenation in ragged setting.
+% \iffalse
+%% Allow hyphenation in ragged setting.
+% \fi
+% \begin{macrocode}
+\RequirePackage{ragged2e}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{calc}
+% Required for calculations involving lengths or counters,
+% such as changes to widths for margin adjustment.
+% \iffalse
+%% Required for calculations involving lengths or counters, such as changes to widths for margin adjustment.
+% \fi
+% \begin{macrocode}
+\RequirePackage{calc}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{ifthen}
+% Package to enable if--then--else conditional
+% processing.
+% \iffalse
+%% Package to enable if--then--else conditional processing.
+% \fi
+% \begin{macrocode}
+\RequirePackage{ifthen}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{textcomp}
+% Additional commands for common symbols and punctuation.
+% \iffalse
+%% Additional commands for common symbols and punctuation.
+% \fi
+% \begin{macrocode}
+\RequirePackage{textcomp}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{array}
+% Additional column formatting for tables.
+% \iffalse
+%% Additional column formatting for tables.
+% \fi
+% \begin{macrocode}
+\RequirePackage{array}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{relsize}
+% Provides size-relative font size changes (smaller, larger,
+% etc).
+% \iffalse
+%% Provides size-relative font size changes (smaller, larger, etc).
+% \fi
+% \begin{macrocode}
+\RequirePackage{relsize}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{textcase}
+% Provides a more sophisticated casing function than the
+% default.
+% \iffalse
+%% Provides a more sophisticated casing function than the default.
+% \fi
+% \begin{macrocode}
+\RequirePackage{textcase}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{flexlogo}
+% Allows user-programmable changes to the positioning of
+% letters in the \TeX{}-related logos on a per-font basis.
+% \iffalse
+%% Allows user-programmable changes to the positioning of letters in the \TeX{}-related logos on a per-font basis.
+% \fi
+% \begin{macrocode}
+\RequirePackage{flexlogo}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{ulem}
+% Underlining as an option (\emph{not}
+% automatically replacing italics).
+% \iffalse
+%% Underlining as an option (not automatically replacing italics).
+% \fi
+% \begin{macrocode}
+\RequirePackage[normalem]{ulem}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{xcolor}
+% Provide color.
+% \iffalse
+%% Provide color.
+% \fi
+% \begin{macrocode}
+\RequirePackage{xcolor}
+ \@ifundefined{T}{%
+ \newcommand{\T}[2]{{\fontencoding{T1}\selectfont#2}}}{}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{babel}
+% Add language, cultural changes, and H\&J support for many
+% languages.
+% \iffalse
+%% Add language, cultural changes, and H\&J support for many languages.
+% \fi
+% \begin{macrocode}
+\RequirePackage[british]{babel}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{biblatex}
+% Use \textsf{biblatex} instead of \BibTeX{}
+% \iffalse
+%% Use biblatex instead of \BibTeX{}
+% \fi
+% \begin{macrocode}
+\RequirePackage[backend=biber,doi=true,
+ isbn=true,url=true,uniquename=false,style=apa]{biblatex}
+ \AtBeginDocument{\setlength{\bibitemsep}{1ex}
+ \defbibheading{shortbib}[Bibliography]{\section{#1}}}
+ \@ifpackagewith{babel}{british}{%
+ \DeclareLanguageMapping{british}{british-apa}}{\relax}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{csquotes}
+% Adds correct curly quotes for cited titles when using
+% \textsf{biblatex}
+% \iffalse
+%% Adds correct curly quotes for cited titles when using biblatex
+% \fi
+% \begin{macrocode}
+\RequirePackage{csquotes}
+% \end{macrocode}
+% \end{CPK@package}
+% \begin{CPK@package}{menukeys}
+% Graphical representations of menus, directories, and keys.
+% \iffalse
+%% Graphical representations of menus, directories, and keys.
+% \fi
+% \begin{macrocode}
+\RequirePackage{menukeys}
+ \renewmenumacro{\menu}[>]{roundedmenus}
+ \renewmenumacro{\directory}[/]{hyphenatepathswithfolder}
+ \renewmenumacro{\keys}{shadowedroundedkeys}
+% \end{macrocode}
+% \end{CPK@package}
+%
+% \subsection{Additions and changes to package defaults}\label{packagemods}
+% As we're using \XeLaTeX{}, the first thing to do is add
+% any non-package fonts, then everything else.\par
+% \begin{CPK@font}{zcoN}
+% This is the Nimbus–15 Narrow replacement for Courier.\par
+% \begin{macrocode}
+\setmonofont[Scale=MatchLowercase]{zcoN}
+% \end{macrocode}
+% \end{CPK@font}
+% \begin{CPK@macro}{\labelitemi}
+% Use a pointy pencil from the bbding package for
+% itemized lists.\par
+% \begin{macrocode}
+\renewcommand{\labelitemi}{%
+ \raisebox{-.5ex}{\textcolor{Purple}{\PencilRight}}}
+\setlength{\leftmargini}{18pt}% don't waste margin space in lists
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\example}
+% Provide commands for distinguishing examples and their
+% output.\par
+% \begin{macrocode}
+\newcommand{\example}{%
+ \color{DarkGreen}\textsf{\bfseries Example:} \color{MediumBlue}}
+\def\endexample{\color{black}}
+\newcommand{\gives}[1]{%
+ \thinspace\color{DarkGreen}\raisebox{-.4ex}
+ {\ArrowBoldRightStrobe}~\color{DarkRed}{\rmfamily
+ #1}\color{black}}
+\newcommand{\nobox}{~\raisebox{-.25ex}{%
+ \footnotesize\Square\llap\XSolidBrush}}
+\newcommand{\yesbox}{~\raisebox{-.25ex}{%
+ \footnotesize\Square\llap\CheckmarkBold}}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\comment}
+% In fancyverb's Verbatim, allow rubric embedded as
+% marked text in red \par
+% \begin{macrocode}
+\newcommand{\comment}[1]{\ifthenelse{\equal{#1}{ }}{}{#1}\normalfont
+ \itshape\footnotesize\color{DarkRed}}
+% Allow notification of newly-added material
+\newcommand{\added}{\color{MediumBlue}}
+% This reverts rubric back to normal, to avoid embedded spaces
+\newcommand{\revert}{\ttfamily\upshape\color{black}}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\monthdate}
+% Define a month-year date European way round.\par
+% \begin{macrocode}
+\newcommand{\monthdate}{\ifcase\month\or January\or
+ 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}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\hyphenation}
+% There's something odd about the hyphenation...these
+% were broken:\par
+% \begin{macrocode}
+\hyphenation{mathe-mati-cal auto-mati-cal-ly docu-ment docu-ments
+ docu-men-tation statis-ti-cal}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\maketitle}
+% \begin{macrocode}
+\renewcommand{\maketitle}{%
+ \hbox to\textwidth{%
+ \vbox{\hsize=.73\textwidth\huge\bfseries\raggedright
+ \@title}
+ \hss
+ \vbox{\hsize=.27\textwidth\scriptsize\raggedright
+ \@author
+ \par
+ \textit{\@date}}}
+ \par\bigskip\hrule\medskip
+}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\section}
+% Pack headings together more tightly.\par
+% \begin{macrocode}
+\renewcommand\section{\@startsection{subsection}{1}{\z@}%
+ {-0pt\@plus -.2ex \@minus -.2ex}%
+ {1pt \@plus .2ex}%
+ {\sffamily\Large\bfseries}}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-0pt\@plus -.2ex \@minus -.2ex}%
+ {1pt \@plus .2ex}%
+ {\sffamily\large\bfseries}}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-.5ex\@plus -1ex \@minus -.2ex}%
+ {.25ex \@plus .2ex}%
+ {\sffamily\normalsize\bfseries}}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {1ex \@plus1ex \@minus.2ex}%
+ {-1em}%
+ {\sffamily\normalsize}}
+\setcounter{secnumdepth}{5}% we don't want numbered sections
+\renewcommand{\thesection}{}
+\renewcommand{\thesubsection}{}
+\renewcommand{\thesubsubsection}{\arabic{subsubsection}}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\DeclareTeXLogo}
+% \begin{macrocode}
+\DeclareTeXLogo{Caladea(0)}{m}{n}{.1667}{.125}[.4]
+\DeclareTeXLogo{Caladea(0)}{m}{it}{.1667}{.08}[.4]
+\DeclareTeXLogo{Caladea(0)}{bx}{n}{.1667}{.125}[.4]
+\DeclareLaTeXLogo{Caladea(0)}{bx}{n}{.27}{.1333}[.1]
+\DeclareLaTeXLogo{Caladea(0)}{m}{n}{.3}{.1}[.1]
+\DeclareTeXLogo{Raleway(0)}{bx}{n}{.1667}{.125}[.38]
+\DeclareLaTeXLogo{Raleway(0)}{m}{n}{.3}{.1}[.1]
+\DeclareLaTeXLogo{Raleway(0)}{b}{n}{.27}{.15}[.1]
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\footnoterule}
+% Adjust footnote fence.\par
+% \begin{macrocode}
+\renewcommand{\footnoterule}{\kern-3pt
+ \hrule height.2pt width.25\columnwidth\kern 2.8pt}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\pagestyle}
+% No page numbers, we're faking it; and let text go very
+% sloppy to fit.\par
+% \begin{macrocode}
+\pagestyle{empty}
+\spaceskip=4pt plus4pt minus3pt
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\textsc}
+% Cater for some fonts not having small caps.\par
+% \begin{macrocode}
+\renewcommand{\textsc}[1]{{\smaller\MakeTextUppercase{#1}}}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\ff}
+% Abbreviate changes of font.\par
+% \begin{macrocode}
+\newcommand{\ff}[2][T1]{\fontencoding{#1}\fontfamily{#2}\selectfont}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@macro}{\descriptionlabel}
+% Stop the {\ttfamily{}\textbackslash{}descriptionlabel}command
+% reverting to the serif font.\par
+% \begin{macrocode}
+\renewcommand{\descriptionlabel}[1]{%
+ \hspace\labelsep{\sffamily\bfseries #1}}
+% \end{macrocode}
+% \end{CPK@macro}
+% \begin{CPK@environment}{note}
+% A trivial environment for notes\par
+% \begin{macrocode}
+\newenvironment{note}{\small\textbf{Note.}\quad}{\par}
+% \end{macrocode}
+% \end{CPK@environment}
+% \iffalse
+%</class>
+% \fi
+% \appendix
+% \iffalse
+%<*veryshortguide>
+% \fi
+% \clearpage
+% \section{The very short guide to typesetting with \LaTeX{}}\label{veryshortguide}
+% \iffalse
+%% The very short guide to typesetting with \LaTeX{}
+% \fi
+% This is the base text for the Very Short Guide.\par
+% \begin{macrocode}
+\documentclass[a5paper]{vsg}
+\addbibresource{veryshortguide.bib}
+\setlength{\bibnamesep}{-\itemsep}
+\begin{document}
+\title{The very short guide to typesetting with~\LaTeX}
+\author{Silmaril Consultants\\
+ \textbf{Textual Therapy Division}\\
+ \protect\url{http://latex.silmaril.ie}}
+\date{\monthdate}
+\maketitle
+\subsection*{What's this all about? What's \LaTeX?}
+
+\LaTeX\ is a document preparation system which uses the \TeX\ typesetting
+program. It enables you to produce publication-quality documents with
+great accuracy and consistency. \LaTeX\ works on any computer and
+produces industry-standard PDF. 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 structures, 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. Install the software from
+\url{www.tug.org/texlive/} or buy a commercially-supported
+version from one of the vendors (see the list on p.\thinspace\pageref{comm}).
+
+\subsection*{Creating and typesetting your document}
+
+\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} (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 {\small\keys{Build}} or {\small\keys{Compile}}
+ toolbar button or menu item in your editor to typeset and display
+ the document;\label{typeset}
+ \item Make any changes needed in your original document and repeat
+ step \ref{typeset}.
+\end{enumerate}
+
+\subsection*{Syntax (how to type \LaTeX\ commands --- these are the rules)}
+
+\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}.\\
+ \example \verb+\title{Irisches Tagebuch}\author{Heinrich Böll}+\endexample
+ \item \textbf{If options are used, they go in square brackets
+ before the curly braces}.\\
+ \example \verb+\documentclass[a4paper,11pt]{book}+\endexample
+ \item \textbf{Spaces after commands \emph{without} braces get suppressed}.\\
+ \example \verb+Copyright \copyright␣+\texttt{\number\year}
+ \gives{Copyright ©\number\year} \nobox\\
+ To prevent this, put empty curly braces after the command:\\
+ \example \verb+Copyright \copyright{}␣+\texttt{\number\year}
+ \gives{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}
+\begin{note}
+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}), StackExchange
+(\url{tex.stackexchange.com}), or the Usenet newsgroup
+\url{comp.text.tex}. For packages (plugins), use CTAN, the
+Comprehensive \TeX\ Archive Network (\url{www.ctan.org}). For
+further details, see \citetitle{fi}
+\parencite{fi} and other online resources.
+\end{note}
+
+\begin{multicols}{2}\small\parskip4pt
+\subsection*{Writing a \LaTeX\ document}
+\subsubsection{Basic document structure}
+
+Here's the skeleton of a \LaTeX\ document. These three lines are
+\textsc{compulsory}: your document will not work without them:
+
+\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
+!added\documentclass[11pt]{article}
+!comment your Preamble goes here (extra setups, if any)
+!added\begin{document}
+!comment your document text goes here
+!added\end{document}
+\end{Verbatim}
+\vspace*{-.5\baselineskip}
+{\fontsize67\selectfont\sffamily New material in each example is shown
+in {\ttfamily\added blue}; material from previous examples is in
+black. Comments and mnemonics are in \textcolor{DarkRed}{red}.\par}
+
+\begin{itemize}[noitemsep]
+ \item The document class name \textsc{must} be one of the standard
+ \verb+book+, \verb+article+, or \verb+report+, or one of the many
+ others preinstalled or downloadable (eg \verb+thesis+,
+ \verb+memoir+, etc);
+ \item There are body type size options \verb+10pt+ (the default),
+ \verb+11pt+, and \verb+12pt+;
+ \item There are paper size options including \verb+a4paper+
+ (210\thinspace mm$\times$297\thinspace mm) and \verb+letterpaper+
+ (8½$''\times$11$''$) [see below].
+\end{itemize}
+
+\subsubsection{Front matter}
+
+The \textbf{Preamble} [see above] is where you speci\-fy any
+\textbf{packages} (\LaTeX\ plugins like typefaces or special
+formatting), and where you put any changes to standard features.
+
+\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
+\documentclass[a4paper,11pt]{book}
+!added\usepackage{charter,graphicx}!revert
+!added\setlength{\parindent}{1em}!revert
+\begin{document}
+!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}
+
+The title, author, and date \textsc{must} be followed by the
+\verb+\maketitle+ command to be formatted correctly.
+
+\subsubsection{Body matter}
+
+\textbf{Leave a blank line between paragraphs} as you type: this
+signals a new paragraph. Spacing is controlled by the
+document class and packages you use. For an unindented,
+line-spaced style, use the \textsf{parskip} package.
+
+\paragraph{Sectioning:}
+Sections get numbered automatically in bold type, and get included in
+the Table of Contents (if you use it). Numbering can be turned off
+selectively. Section heading layout can be modified with the
+\textsf{sectsty}, \mbox{\textsf{titlesec}}, and other packages.
+
+\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
+!comment (Preamble, titling, and abstract as above)
+\tableofcontents
+!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}
+
+\paragraph{Lists:}
+There are three types of list: \textbf{itemized} (bulleted), \textbf{enumerated} (numbered
+or lettered), and \textbf{descriptive} (topic-and-explanation
+format).
+
+Like \textsf{document}, these are all \textbf{environments}, using
+\verb+\begin{...}+ and \verb+\end{...}+.
+
+\begingroup\fontsize{4.5}{5.5}\selectfont
+\renewcommand{\labelitemi}{\textbullet}
+\leftmargini=2em
+\setlength{\tabcolsep}{3pt}
+\begin{tabular}{@{}%
+ p{.25\columnwidth}|%
+ p{.32\columnwidth}|%
+ p{.33\columnwidth}@{}}
+\begin{verbatim}
+\begin{itemize}
+ \item 1lb Sugar
+ \item ½pt Cream
+ \item Chocolate
+ \item 2oz Butter
+\end{itemize}
+\end{verbatim}
+&
+\begin{verbatim}
+\begin{enumerate}
+ \item Mix ingredients
+ \item Boil to 112°C
+ \item Stir and cool
+ \item Pour into dish
+\end{enumerate}
+\end{verbatim}
+&
+\begin{verbatim}
+\begin{description}
+ \item[Fudge] is fun...
+ \item[Broccoli] sucks...
+ \item[Exercise] is good
+ for you if taken daily
+\end{description}
+\end{verbatim}
+\\\hline\scriptsize
+\begin{itemize}[noitemsep]
+\item 1lb Sugar
+\item ½pt Cream
+\item Chocolate
+\item 2oz Butter
+\end{itemize}
+&\fontsize{6.5}{8}\selectfont
+\begin{enumerate}[noitemsep]
+\item Mix ingredients
+\item Boil to 112°C
+\item Stir and cool
+\item Pour into dish
+\end{enumerate}
+&\tiny
+\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. Use the \textsf{enumitem}
+package to control list formatting.
+
+\colorbox{LightGrey}{\color{black}\begin{minipage}{.965\columnwidth}%
+\sffamily\scriptsize\bfseries\raggedright
+For help, see the links on the front and back pages. There is a
+summary of common commands at\\
+\url{www.stdout.org/~winston/latex/latexsheet.pdf}
+and a comprehensive list at
+\url{www.eeng.dcu.ie/local-docs/latex-help/}~.
+\end{minipage}}
+\columnbreak
+\paragraph{Tables and figures:}
+These environments \textbf{float} (to fit
+available space). They have \verb+\caption+ and \verb+\label+ commands.
+
+\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
+!added\begin{figure} !comment(see below)
+\caption{Swiss and Dutch Mennonite
+ migrations of the 1700s and 1800s}
+\label{lmig}
+!added\centering !comment(centre the contents)
+!added\includegraphics[width=.8\columnwidth]
+!added {menno-a}\\ !comment(double backslash for linebreak)
+!added\scriptsize!revert Courtesy of Paul C. Adams,
+ Department of Geography and the
+ Environment, University of Texas at
+ Austin.
+!added\cite{adams}\end{figure}
+\end{Verbatim}
+
+Graphics \textsc{must} be EPS files for standard \LaTeX, but JPG, PNG,
+or PDF for pdf\LaTeX.
+
+\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
+!added\begin{table}
+ !added\caption{Mean growth rate and intakes
+ !added of supplement, milk, and water for 4
+ !added diets (after Sherington, J, undated)}
+ \label{dietgrowth}
+ \centering
+ !added\begin{tabular}{|l|r|r|r|r|}
+ !added\hline !comment(horizontal line between rows)
+ !added&Growth&Supplement&Milk&Water
+ !added\\\hline !comment(double backslash for new row)
+ !added Supplement&rate&intake&intake&intake
+ !added\\\hline
+ !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}
+
+\begin{center}\sffamily
+ \fontsize78\selectfont
+\setlength{\tabcolsep}{2pt}
+\setlength{\arrayrulewidth}{.2pt}
+\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
+ Sherington, J, undated)}\\[6pt]\hline
+\vrule height1.1em width0pt&Growth&Supplement&Milk&Water\\[-1pt]
+Supplement&rate&intake&intake&intake\\[-1pt]
+&(g/day)&(g/day)&(ml/kg\textsuperscript{\fontsize34\selectfont 0.75})&(ml/kg\textsuperscript{\fontsize34\selectfont 0.75})\\[3pt]\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{center}
+Packages like \textsf{longtable} and \textsf{array} can help
+with more complex table formats.
+
+\end{multicols}
+
+\begin{center}\sffamily
+ \textbf{Figure 1}: \textit{Swiss and Dutch Mennonite migrations of the
+ 1700s and 1800s}\\[3pt]
+ \ifafive\includegraphics[width=.8\columnwidth]{menno-a}\fi
+ \iflegal\includegraphics[width=.7\columnwidth]{menno-a}\fi
+ \\\scriptsize
+ Courtesy of Paul C. Adams, Department of Geography
+ and the Environment, University of Texas at Austin. [1]
+\end{center}
+
+\begin{multicols}{2}\small\parskip4pt
+\paragraph{Typefaces:}
+{\ff{lrm}\selectfont The default typeface in \LaTeX\ is Computer
+ Modern, like this.}
+
+{\footnotesize\tabcolsep4pt
+\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&\ff[OT1]{pnr}Pandora&pandora\\
+\ff{pnc}Century&newcent&\ff[U]{yfrak}Fraktur&oldgerm\\
+\end{tabular}
+}
+
+Dozens of other font packages are available in \TeX\ Live and the \LaTeX\ Font
+Catalogue, including mathematics and decorative fonts. Any
+Postscript Type~1 font can be configured for \LaTeX.
+
+If you use \XeLaTeX\ and the \textsf{fontspec} package, you can also
+use your computer's system fonts as well as those available
+with \TeX\ Live.
+
+\colorbox{LightGrey}{\color{black}\begin{minipage}{.965\columnwidth}%
+\sffamily\scriptsize\raggedright
+Commercial implementations of \TeX\ for Windows with business-level
+support are available from Personal \TeX, Inc (PC\TeX); MacKichan
+Software, Inc (Scientific Word); Micropress, Inc (V\TeX), and
+True\TeX\ Software (True\TeX).\label{comm}
+\end{minipage}}
+
+\columnbreak
+\textsf{Typefaces continued}
+
+To change font for a word or phrase, use these commands (they can be
+nested):
+
+{\small
+\begin{tabular}{l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
+ Hello\char'175}@{}>{\ \gives\bgroup}l<{Hello\egroup}}
+Italics&it&\itshape\\
+Boldface&bf&\bfseries\\
+Smallcaps&sc&\ff{cmr}\scshape\\
+Sans-serif&sf&\sffamily\\
+Monospace&tt&\ttfamily\\
+\end{tabular}}
+
+\begingroup\small
+\example\verb+\textit{\textbf{\textsf+\ifafive\linebreak\fi
+\verb+{bold+ \iflegal\linebreak\fi\verb+italic sans}}}+
+\gives{\ff{cmss}\textit{\textbf{bold italic sans}}}
+\par\endgroup
+
+Sizes for titles, headings, footnotes, etc are automatic, but
+there are some step-sizes:
+
+{\scriptsize\centering
+\begin{tabular}{>{\ttfamily\char'134}lrrr}
+normalsize&10&11&12\\\hline\vrule height1.1em width0pt
+tiny&5&6&7\\
+scriptsize&6&7&8\\
+footnotesize&7&8&9\\
+small&9&10&11\\
+large&11&12&14\\
+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}{\tiny* sizes rounded here to save space}
+\par}
+
+For other sizes, add the special command
+{\added\verb+\RequirePackage{fix-cm}+}\iflegal\linebreak\fi \emph{before} the
+\verb+\documentclass+ line and use
+{\added\verb+\fontsize{+\texttt{\uline{pp}}\verb+}{+\texttt{\uline{bb}}\verb+}\selectfont+}
+for the point-size (\textit{pp}) and baseline
+(\textit{bb}).
+
+{\sffamily\footnotesize
+ Size commands are all \textbf{unscoped} commands, so enclose them \emph{and}
+the applicable text in curly braces to stop them affecting the rest
+of the document.\par}
+For double or 1½ line-spacing (eg in theses) use the \textsf{setspace}
+package.
+
+You can use colour palettes in the RGB, CMYK, HTML, and other
+colourspaces with \iflegal\\\fi the \textsf{xcolor} \ifafive\\\fi
+package and the\hfil
+\smash{\raisebox{0ex}{\sffamily\bfseries\Huge\iflegal\quad\else\enspace\fi
+\textcolor[HTML]{2F50AD}{G}%
+\textcolor[HTML]{B32F17}{o}%
+\textcolor[HTML]{F3C20B}{o}%
+\textcolor[HTML]{2F50AD}{g}%
+\textcolor[HTML]{48C847}{l}%
+\textcolor[HTML]{B32F17}{e}}}%
+\\\verb+\color{+\texttt{\textit{name}}\verb+}+ command.
+
+For verbatim text, use the \verb+\verb+ command or the
+\textsf{verbatim} environment, or (better) the \textsf{listings} or
+\textsf{fancyvrb} packages.
+
+\paragraph{Footnotes:}
+You do footnotes with \iflegal\\\fi \verb+\footnote(like this}+.\footnote{Like
+ this.} Endnotes too.
+
+\paragraph{Cross-references:}\label{blah} Use the command
+\verb+\label{...}+ to label the target, and \verb+\ref{...}+ or
+\verb+\pageref{...}+ to refer to it. Make up the labels yourself.
+
+\begingroup\small
+\example{...\ttfamily section \verb+\ref{blah}+ on
+ p.\\ \verb+\pageref{blah}+.}\gives{...section \ref{blah} on
+ p.\thinspace\pageref{blah}}.
+\par\endgroup
+
+\paragraph{Citation and reference:} Create your bibliographic database
+in BIB\TeX\ format \parencite{bibtex} using \emph{JabRef} or
+similar. Each entry \textsc{must} have a unique label (here `\verb+fi+'):
+\begin{Verbatim}[frame=single,fontsize=\scriptsize,commandchars=!<>]
+!added@book{fi,
+!added title = {Formatting Information},
+!added author = {Peter Flynn},
+!added publisher = {Silmaril},
+!added year = {2016}}
+\end{Verbatim}
+Use the
+\textsf{biblatex} package to specify the style, and give
+the filename of your database:
+\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
+!added\usepackage[style=apa]{biblatex}
+!added\addbibresource{myrefs.bib}
+\end{Verbatim}
+To cite, use \verb+\cite{...}+ (or
+\verb+\textcite+ or \verb+\parencite+) with the relevant label:\\ \example{\verb+\textcite{fi}+}\gives{\textcite{fi}}.
+
+\subsubsection{Back matter}
+For an index, use the \textsf{makeidx} package and the
+\verb+\makeindex+ command with the \verb+\index{...}+
+and \verb+\printindex+ commands and the \textsf{makeindex} program.
+
+\nocite{*}
+{\defbibheading{shortbib}[References]{\subsection*{#1}}\renewcommand*{\bibfont}{\scriptsize}\setlength{\bibhang}{1em}\urlstyle{tt}\label{refs}\printbibliography[heading=shortbib]}
+
+\colorbox{LightGrey}{\color{black}\begin{minipage}{.965\columnwidth}%
+\sffamily\scriptsize\bfseries\raggedright
+For information about \LaTeX\ training and consutancy, please contact
+Silmaril at \url{latex@silmaril.ie}
+\end{minipage}}%
+\end{multicols}
+\end{document}
+% \end{macrocode}
+% \iffalse
+%</veryshortguide>
+% \fi
+% \iffalse
+%<*vsg-bib>
+% \fi
+% \clearpage
+% \section{The bibliography for the Very Short Guide to Typesetting with \LaTeX{}}\label{vsg-bib}
+% \iffalse
+The bibliography for the Very Short Guide to Typesetting with \LaTeX{}
+% \fi
+% This is the bibliography for the Very Short Guide.\par
+% \begin{macrocode}
+@book{fi,
+ title = {{Formatting Information}},
+ author = {Peter Flynn},
+ publisher = {Silmaril},
+ url = {http://latex.silmaril.ie/},
+ year = {2016}}
+
+@InProceedings{adams,
+ author = {Paul Adams},
+ title = {{Linguistic Chaos in Montreal}},
+ booktitle = {{Chaos and the City miniconference}},
+ year = 2002,
+ month = {Nov},
+ url = {http://www.utexas.edu/depts/grg/adams/chaos.ppt},
+ organization = {University of Texas School of Architecture}}
+
+@Manual{bibtex,
+ title = {{BIB\TeX ing}},
+ author = {Oren Patashnik},
+ organization = {\TeX\ Users Group},
+ address = {Portland, RI},
+ url = {http://ftp.heanet.ie/pub/CTAN/tex/biblio/bibtex/base/btxdoc.pdf},
+ year = 1988}
+
+
+@Manual{sherington,
+ author = {Sherington, J},
+ title = {{Informative Presentation of Graphs and Statistics}},
+ organization = {Statistical Services Centre, University of Reading},
+ year = 1998,
+ url = {http://www.reading.ac.uk/ssc/publications/guides/toptgs.htm},
+ note = {4.2, example table}
+}
+% \end{macrocode}
+% \iffalse
+%</vsg-bib>
+% \fi
+% \newgeometry{left=3cm}
+% \clearpage
+% \section{The \LaTeX{} Project Public License}\label{LPPL:LPPL}
+% \begin{quotation}\small\noindent
+% Everyone is allowed to distribute verbatim copies of this
+% license document, but modification of it is not allowed.
+% \end{quotation}
+% \subsection{Preamble}\label{LPPL:Preamble}
+% The \LaTeX{} Project Public License (\textsc{lppl})
+% is the primary license under which the \LaTeX{} kernel and the
+% base \LaTeX{} packages are distributed.\par
+% You may use this license for any work of which you hold the
+% copyright and which you wish to distribute. This license may be
+% particularly suitable if your work is \TeX{}-related (such as a
+% \LaTeX{} package), but it is written in such a way that you can
+% use it even if your work is unrelated to \TeX{}.\par
+% The section \emph{Whether and How to Distribute Works under This
+% License}, below, gives instructions, examples, and
+% recommendations for authors who are considering distributing
+% their works under this license.\par
+% This license gives conditions under which a work may be
+% distributed and modified, as well as conditions under which
+% modified versions of that work may be distributed.\par
+% We, the \LaTeX{3} Project, believe that the conditions below
+% give you the freedom to make and distribute modified versions of
+% your work that conform with whatever technical specifications
+% you wish while maintaining the availability, integrity, and
+% reliability of that work. If you do not see how to achieve your
+% goal while meeting these conditions, then read the document
+% {\ttfamily{}cfgguide.tex} and {\ttfamily{}modguide.tex} in the base \LaTeX{}
+% distribution for suggestions.\par
+% \subsection{Definitions}\label{LPPL:Definitions}
+% In this license document the following terms are used:\par
+% \begin{description}[style=unboxed]
+% \item[Work\thinspace:]Any work being distributed under this License.
+% \item[Derived Work\thinspace:]Any work that under any applicable law is derived from
+% the Work.
+% \item[Modification\thinspace:]Any procedure that produces a Derived Work under any
+% applicable law~--- for example, the production of a file
+% containing an original file associated with the Work or a
+% significant portion of such a file, either verbatim or
+% with modifications and/or translated into another
+% language.
+% \item[Modify\thinspace:]To apply any procedure that produces a Derived Work
+% under any applicable law.
+% \item[Distribution\thinspace:]Making copies of the Work available from one person to
+% another, in whole or in part. Distribution includes (but
+% is not limited to) making any electronic components of the
+% Work accessible by file transfer protocols such as
+% \textsc{ftp} or \textsc{http} or by
+% shared file systems such as Sun's Network File System
+% (\textsc{nfs}).
+% \item[Compiled Work\thinspace:]A version of the Work that has been processed into a
+% form where it is directly usable on a computer system.
+% This processing may include using installation facilities
+% provided by the Work, transformations of the Work, copying
+% of components of the Work, or other activities. Note that
+% modification of any installation facilities provided by
+% the Work constitutes modification of the Work.
+% \item[Current Maintainer\thinspace:]A person or persons nominated as such within the Work.
+% If there is no such explicit nomination then it is the
+% `Copyright Holder' under any applicable
+% law.
+% \item[Base Interpreter\thinspace:]A program or process that is normally needed for
+% running or interpreting a part or the whole of the
+% Work.\par
+% A Base Interpreter may depend on external components
+% but these are not considered part of the Base Interpreter
+% provided that each external component clearly identifies
+% itself whenever it is used interactively. Unless
+% explicitly specified when applying the license to the
+% Work, the only applicable Base Interpreter is a
+% `\LaTeX{}-Format' or in the case of files
+% belonging to the `\LaTeX{}-format' a program
+% implementing the `\TeX{} language'.
+% \end{description}
+% \subsection{Conditions on Distribution and Modification}\label{LPPL:Conditions}
+% \begin{enumerate}
+% \item Activities other than distribution and/or modification
+% of the Work are not covered by this license; they are
+% outside its scope. In particular, the act of running the
+% Work is not restricted and no requirements are made
+% concerning any offers of support for the Work.
+% \item \label{LPPL:item:distribute}You may distribute a complete, unmodified copy of the
+% Work as you received it. Distribution of only part of the
+% Work is considered modification of the Work, and no right to
+% distribute such a Derived Work may be assumed under the
+% terms of this clause.
+% \item You may distribute a Compiled Work that has been
+% generated from a complete, unmodified copy of the Work as
+% distributed under Clause~item~\ref{LPPL:item:distribute} above above, as
+% long as that Compiled Work is distributed in such a way that
+% the recipients may install the Compiled Work on their system
+% exactly as it would have been installed if they generated a
+% Compiled Work directly from the Work.
+% \item \label{LPPL:item:currmaint}If you are the Current Maintainer of the Work, you may,
+% without restriction, modify the Work, thus creating a
+% Derived Work. You may also distribute the Derived Work
+% without restriction, including Compiled Works generated from
+% the Derived Work. Derived Works distributed in this manner
+% by the Current Maintainer are considered to be updated
+% versions of the Work.
+% \item If you are not the Current Maintainer of the Work, you
+% may modify your copy of the Work, thus creating a Derived
+% Work based on the Work, and compile this Derived Work, thus
+% creating a Compiled Work based on the Derived Work.
+% \item \label{LPPL:item:conditions}If you are not the Current Maintainer of the Work, you
+% may distribute a Derived Work provided the following
+% conditions are met for every component of the Work unless
+% that component clearly states in the copyright notice that
+% it is exempt from that condition. Only the Current
+% Maintainer is allowed to add such statements of exemption to
+% a component of the Work.
+% \begin{enumerate}
+% \item If a component of this Derived Work can be a direct
+% replacement for a component of the Work when that
+% component is used with the Base Interpreter, then,
+% wherever this component of the Work identifies itself to
+% the user when used interactively with that Base
+% Interpreter, the replacement component of this Derived
+% Work clearly and unambiguously identifies itself as a
+% modified version of this component to the user when used
+% interactively with that Base Interpreter.
+% \item Every component of the Derived Work contains
+% prominent notices detailing the nature of the changes to
+% that component, or a prominent reference to another file
+% that is distributed as part of the Derived Work and that
+% contains a complete and accurate log of the
+% changes.
+% \item No information in the Derived Work implies that any
+% persons, including (but not limited to) the authors of
+% the original version of the Work, provide any support,
+% including (but not limited to) the reporting and
+% handling of errors, to recipients of the Derived Work
+% unless those persons have stated explicitly that they do
+% provide such support for the Derived Work.
+% \item You distribute at least one of the following with
+% the Derived Work:
+% \begin{enumerate}
+% \item A complete, unmodified copy of the Work; if your
+% distribution of a modified component is made by
+% offering access to copy the modified component from
+% a designated place, then offering equivalent access
+% to copy the Work from the same or some similar place
+% meets this condition, even though third parties are
+% not compelled to copy the Work along with the
+% modified component;
+% \item Information that is sufficient to obtain a
+% complete, unmodified copy of the Work.
+% \end{enumerate}
+% \end{enumerate}
+% \item If you are not the Current Maintainer of the Work, you
+% may distribute a Compiled Work generated from a Derived
+% Work, as long as the Derived Work is distributed to all
+% recipients of the Compiled Work, and as long as the
+% conditions of Clause~item~\ref{LPPL:item:conditions} above, above, are met
+% with regard to the Derived Work.
+% \item The conditions above are not intended to prohibit, and
+% hence do not apply to, the modification, by any method, of
+% any component so that it becomes identical to an updated
+% version of that component of the Work as it is distributed
+% by the Current Maintainer under Clause~item~\ref{LPPL:item:currmaint} above, above.
+% \item Distribution of the Work or any Derived Work in an
+% alternative format, where the Work or that Derived Work (in
+% whole or in part) is then produced by applying some process
+% to that format, does not relax or nullify any sections of
+% this license as they pertain to the results of applying that
+% process.
+% \item % \begin{enumerate}
+% \item A Derived Work may be distributed under a different
+% license provided that license itself honors the
+% conditions listed in Clause~item~\ref{LPPL:item:conditions} above above, in
+% regard to the Work, though it does not have to honor the
+% rest of the conditions in this license.
+% \item If a Derived Work is distributed under a different
+% license, that Derived Work must provide sufficient
+% documentation as part of itself to allow each recipient
+% of that Derived Work to honor the restrictions in
+% Clause~item~\ref{LPPL:item:conditions} above above, concerning
+% changes from the Work.
+% \end{enumerate}
+% \item This license places no restrictions on works that are
+% unrelated to the Work, nor does this license place any
+% restrictions on aggregating such works with the Work by any
+% means.
+% \item Nothing in this license is intended to, or may be used
+% to, prevent complete compliance by all parties with all
+% applicable laws.
+% \end{enumerate}
+% \subsection{No Warranty}\label{LPPL:Warranty}
+% There is no warranty for the Work. Except when otherwise
+% stated in writing, the Copyright Holder provides the Work
+% `as is', without warranty of any kind, either
+% expressed or implied, including, but not limited to, the implied
+% warranties of merchantability and fitness for a particular
+% purpose. The entire risk as to the quality and performance of
+% the Work is with you. Should the Work prove defective, you
+% assume the cost of all necessary servicing, repair, or
+% correction.\par
+% In no event unless required by applicable law or agreed to
+% in writing will The Copyright Holder, or any author named in the
+% components of the Work, or any other party who may distribute
+% and/or modify the Work as permitted above, be liable to you for
+% damages, including any general, special, incidental or
+% consequential damages arising out of any use of the Work or out
+% of inability to use the Work (including, but not limited to,
+% loss of data, data being rendered inaccurate, or losses
+% sustained by anyone as a result of any failure of the Work to
+% operate with any other programs), even if the Copyright Holder
+% or said author or said other party has been advised of the
+% possibility of such damages.\par
+% \subsection{Maintenance of The Work}\label{LPPL:Maintenance}
+% The Work has the status `author-maintained'
+% if the Copyright Holder explicitly and prominently states near
+% the primary copyright notice in the Work that the Work can only
+% be maintained by the Copyright Holder or simply that it is
+% `author-maintained'.\par
+% The Work has the status `maintained' if there
+% is a Current Maintainer who has indicated in the Work that they
+% are willing to receive error reports for the Work (for example,
+% by supplying a valid e-mail address). It is not required for the
+% Current Maintainer to acknowledge or act upon these error
+% reports.\par
+% The Work changes from status `maintained' to
+% `unmaintained' if there is no Current Maintainer,
+% or the person stated to be Current Maintainer of the work cannot
+% be reached through the indicated means of communication for a
+% period of six months, and there are no other significant signs
+% of active maintenance.\par
+% You can become the Current Maintainer of the Work by
+% agreement with any existing Current Maintainer to take over this
+% role.\par
+% If the Work is unmaintained, you can become the Current
+% Maintainer of the Work through the following steps:\par
+% \begin{enumerate}
+% \item Make a reasonable attempt to trace the Current
+% Maintainer (and the Copyright Holder, if the two differ)
+% through the means of an Internet or similar search.
+% \item If this search is successful, then enquire whether the
+% Work is still maintained.
+% \begin{enumerate}
+% \item If it is being maintained, then ask the Current
+% Maintainer to update their communication data within one
+% month.
+% \item \label{LPPL:item:intention}If the search is unsuccessful or no action to resume
+% active maintenance is taken by the Current Maintainer,
+% then announce within the pertinent community your
+% intention to take over maintenance. (If the Work is a
+% \LaTeX{} work, this could be done, for example, by
+% posting to \url{news:comp.text.tex}.)
+% \end{enumerate}
+% \item % \begin{enumerate}
+% \item If the Current Maintainer is reachable and agrees to
+% pass maintenance of the Work to you, then this takes
+% effect immediately upon announcement.
+% \item \label{LPPL:item:announce}If the Current Maintainer is not reachable and the
+% Copyright Holder agrees that maintenance of the Work be
+% passed to you, then this takes effect immediately upon
+% announcement.
+% \end{enumerate}
+% \item \label{LPPL:item:change}If you make an `intention announcement'
+% as described in~item~\ref{LPPL:item:intention} above above and after three
+% months your intention is challenged neither by the Current
+% Maintainer nor by the Copyright Holder nor by other people,
+% then you may arrange for the Work to be changed so as to
+% name you as the (new) Current Maintainer.
+% \item If the previously unreachable Current Maintainer becomes
+% reachable once more within three months of a change
+% completed under the terms of~item~\ref{LPPL:item:announce} above
+% or~item~\ref{LPPL:item:change} above, then that
+% Current
+% Maintainer must become or remain the Current Maintainer upon
+% request provided they then update their communication data
+% within one month.
+% \end{enumerate}
+% A change in the Current Maintainer does not, of itself,
+% alter the fact that the Work is distributed under the
+% \textsc{lppl} license.\par
+% If you become the Current Maintainer of the Work, you should
+% immediately provide, within the Work, a prominent and
+% unambiguous statement of your status as Current Maintainer. You
+% should also announce your new status to the same pertinent
+% community as in~item~\ref{LPPL:item:intention} above
+% above.\par
+% \subsection{Whether and How to Distribute Works under This
+% License}\label{LPPL:Distribute}
+% This section contains important instructions, examples, and
+% recommendations for authors who are considering distributing
+% their works under this license. These authors are addressed as
+% `you' in this section.\par
+% \subsubsection{Choosing This License or Another License}\label{LPPL:Choosing}
+% If for any part of your work you want or need to use
+% \emph{distribution} conditions that differ
+% significantly from those in this license, then do not refer to
+% this license anywhere in your work but, instead, distribute
+% your work under a different license. You may use the text of
+% this license as a model for your own license, but your license
+% should not refer to the \textsc{lppl} or otherwise
+% give the impression that your work is distributed under the
+% \textsc{lppl}.\par
+% The document {\ttfamily{}modguide.tex} in the base \LaTeX{}
+% distribution explains the motivation behind the conditions of
+% this license. It explains, for example, why distributing
+% \LaTeX{} under the \textsc{gnu} General Public
+% License (\textsc{gpl}) was considered inappropriate.
+% Even if your work is unrelated to \LaTeX{}, the discussion in
+% {\ttfamily{}modguide.tex} may still be
+% relevant, and authors intending to distribute their works
+% under any license are encouraged to read it.\par
+% \subsubsection{A Recommendation on Modification Without
+% Distribution}\label{LPPL:WithoutDistribution}
+% It is wise never to modify a component of the Work, even
+% for your own personal use, without also meeting the above
+% conditions for distributing the modified component. While you
+% might intend that such modifications will never be
+% distributed, often this will happen by accident~--- you may
+% forget that you have modified that component; or it may not
+% occur to you when allowing others to access the modified
+% version that you are thus distributing it and violating the
+% conditions of this license in ways that could have legal
+% implications and, worse, cause problems for the community. It
+% is therefore usually in your best interest to keep your copy
+% of the Work identical with the public one. Many works provide
+% ways to control the behavior of that work without altering any
+% of its licensed components.\par
+% \subsubsection{How to Use This License}\label{LPPL:HowTo}
+% To use this license, place in each of the components of
+% your work both an explicit copyright notice including your
+% name and the year the work was authored and/or last
+% substantially modified. Include also a statement that the
+% distribution and/or modification of that component is
+% constrained by the conditions in this license.\par
+% Here is an example of such a notice and statement:\par
+% \iffalse
+%<*ignore>
+% \fi
+\begin{lstlisting}[language={[LaTeX]TeX}]
+%%% pig.dtx
+%%% Copyright 2005 M. Y. Name
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `maintained'.
+%%
+%% The Current Maintainer of this work is M. Y. Name.
+%%
+%% This work consists of the files pig.dtx and pig.ins
+%% and the derived file pig.sty.
+\end{lstlisting}
+% \iffalse
+%</ignore>
+% \fi
+% Given such a notice and statement in a file, the
+% conditions given in this license document would apply, with
+% the `Work' referring to the three files
+% {\ttfamily{}pig.dtx}, {\ttfamily{}pig.ins}, and {\ttfamily{}pig.sty} (the last being generated
+% from {\ttfamily{}pig.dtx} using {\ttfamily{}pig.ins}), the `Base
+% Interpreter' referring to any
+% `\LaTeX{}-Format', and both `Copyright
+% Holder' and `Current Maintainer'
+% referring to the person
+% M.~Y.~Name\index{!}.\par
+% If you do not want the Maintenance section of
+% \textsc{lppl} to apply to your Work, change
+% `maintained' above into
+% `author-maintained'. However, we recommend that
+% you use `maintained' as the Maintenance
+% section was added in order to ensure that your Work remains
+% useful to the community even when you can no longer maintain
+% and support it yourself.\par
+% \subsubsection{Derived Works That Are Not Replacements}\label{LPPL:NotReplacements}
+% Several clauses of the \textsc{lppl} specify
+% means to provide reliability and stability for the user
+% community. They therefore concern themselves with the case
+% that a Derived Work is intended to be used as a (compatible or
+% incompatible) replacement of the original Work. If this is not
+% the case (e.g., if a few lines of code are reused for a
+% completely different task), then clauses 6b and 6d shall not
+% apply.\par
+% \subsubsection{Important Recommendations}\label{LPPL:Recommendations}
+% \paragraph{Defining What Constitutes the Work}
+% The \textsc{lppl} requires that distributions
+% of the Work contain all the files of the Work. It is
+% therefore important that you provide a way for the licensee
+% to determine which files constitute the Work. This could,
+% for example, be achieved by explicitly listing all the files
+% of the Work near the copyright notice of each file or by
+% using a line such as:\par
+% \iffalse
+%<*ignore>
+% \fi
+\begin{lstlisting}[language={[LaTeX]TeX}]
+%% This work consists of all files listed in manifest.txt.
+\end{lstlisting}
+% \iffalse
+%</ignore>
+% \fi
+% in that place. In the absence of an unequivocal list it
+% might be impossible for the licensee to determine what is
+% considered by you to comprise the Work and, in such a case,
+% the licensee would be entitled to make reasonable
+% conjectures as to which files comprise the Work.\par
+% \Finale
+