summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-11 23:55:21 +0000
committerKarl Berry <karl@freefriends.org>2006-01-11 23:55:21 +0000
commit77e0aa77698cd91cf53d520960cc3a6cf1929f7c (patch)
tree34205c6ab65d681e33a8da0976ebdcae6d765693
parent1331203eca389b2daa306b13be4a6088ef6b52e0 (diff)
trunk/Master/texmf-dist/source/latex/multicap
git-svn-id: svn://tug.org/texlive/trunk@400 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/source/latex/multicap/multicap.dtx500
1 files changed, 500 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/multicap/multicap.dtx b/Master/texmf-dist/source/latex/multicap/multicap.dtx
new file mode 100644
index 00000000000..9cd88e5e7fa
--- /dev/null
+++ b/Master/texmf-dist/source/latex/multicap/multicap.dtx
@@ -0,0 +1,500 @@
+% \iffalse
+%%
+%% Package `multicap' to use with LaTeX2e
+%% Copyright 2002 John Vassilogiorgakis.
+%%
+%% Contact at: giannis@iris.math.aegean.gr
+%%
+%% This program may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.2
+%% 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.2 or later is part of all distributions of LaTeX
+%% version 1999/12/01 or later.
+%%
+%<*dtx>
+\ProvidesFile{multicap.dtx}
+%</dtx>
+%<package>\NeedsTeXFormat{LaTeX2e}
+%<package>\ProvidesPackage{multicap}
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage[english]{babel}
+\usepackage{multicol,tabularx,multicap}
+\renewcommand{\thetable}{\os{\arabic{table}}}
+\newcommand{\os}{\oldstylenums}
+\setlength{\columnseprule}{.4pt}
+\setlength{\columnsep}{18pt}
+\setlength{\textwidth}{39pc}
+\setlength{\textheight}{54pc}
+\setlength{\parindent}{1em}
+\setlength{\parskip}{0pt plus 1pt}
+\setlength{\oddsidemargin}{0pc}
+\setlength{\marginparwidth}{0pc}
+\setlength{\topmargin}{-2.5pc}
+\setlength{\headsep}{20pt}
+\setlength{\columnsep}{1.5pc}
+\setcounter{columnbadness}{7000}
+\setcounter{finalcolumnbadness}{7000}
+\begin{document}
+ \typeout
+ {***********************************************************************
+ ^^J* multicap.dtx requires multicol.sty, multicap.sty and tabular.sty *
+ ^^J***********************************************************************}
+\DocInput{multicap.dtx}
+\end{document}
+%</driver>
+% \fi
+% \ProvidesFile{multicap.dtx}
+ [2002/05/04 v1.0 formatting captions inside multicols]
+%
+%% \CheckSum{194}
+%
+% \MakeShortVerb{\|}
+%
+% \GetFileInfo{multicap.dtx}
+% \title{The \texttt{`multicap'} \LaTeXe\ package\thanks{Version number \fileversion{}.
+% Last revised \filedate{}.}}
+% \author{John Vassilogiorgakis\\
+% \texttt{giannis@iris.math.aegean.gr}}
+% \date{12th May 2002}
+%
+% \maketitle
+%
+% \begin{abstract}
+% This is a package for formating captions of column figures and column tabular material which cannot be floats
+% (i.e. outside a \texttt{figure} or \texttt{table} environment in standard \LaTeX) in the \texttt{multicols}
+% environment provided by the \textsf{multicol}
+% package. It also provides an easy way to customize your captions, either in single column or inside \texttt{multicols}.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \begin{multicols}{2}[\section{Introduction}]\hbadness=10000
+% As it is known, the \textsf{multicol} package supports partially floats inside
+% \texttt{multicols} environment. To be exact, only the star versions of the floating environments
+% are supported, excluding the existence of column floats---i.e. only page wide floats can be used \cite{MB}. However, one can
+% put a column image or tabular material
+% with one or another way---with an |\includegraphics|
+% command, or a \texttt{tabularx} environment inside a |center| environment---getting satisfactory
+% results like the following:
+% \begin{center}
+% \begin{tabularx}{\linewidth}{p{35pt}>{$}X<{$}>{$}X<{$}}
+% \hline
+% &\mathbf{x_1}&\mathbf{x_2}\\\hline\hline
+% \os{1}.&(x-1,y-1)&(x+1,y+1)\\
+% \os{2}.&(x,y-1)&(x,y+1)\\
+% \os{3}.&(x+1,y-1)&(x-1,y+1)\\
+% \os{4}.&(x-1,y)&(x+1,y)\\
+% \hline
+% \end{tabularx}
+% \end{center}
+% The same thing can happen, of course, with `column figures'. The column material
+% is placed outside of a floating environment by simply specifying:
+% \begin{center}
+% \textit{... text before column material ...}
+% \begin{verbatim}
+% \begin{center}
+% \begin{tabularx}{\linewidth}{...}
+% ...
+% \end{tabularx}
+% \end{center}
+% \end{verbatim}
+% \textit{... text after column material ...}
+% \end{center}
+% The only thing left, is to add captions to this column material, as we would have done if this material were
+% inside a floating environment. Moreover, we want the numbering of these captions to be handled correctly, even
+% if a star-form of a floating environment appears and even if we are switching between |multicols| and single column layout.
+% Finally, we also want the text specified by the caption to appear in the
+% list of figures or tables and the references to this material to work correctly.
+% \end{multicols}
+%
+% \begin{multicols}{2}[\section{Usage}]\hbadness=10000
+% The package loads with\begin{center}
+% \fbox{\cs{usepackage}\texttt{\{multicap\}}}
+% \end{center}
+% and it requires the \textsf{ifthen} package.
+% The \textsf{multicap} package defines the |\mfcaption| and |\mtcaption| commands,
+% which replace the |\caption| command outside of a floating environment;
+% for column figures and column tabular
+% material respectively, that are necessary outside of a floating environment inside |multicols|.
+%
+% The syntax of the commands is the same as the one of |\caption|'s:
+% ^^A \DescribeMacro{\mfcaption}
+% \begin{center}
+% \fbox{\cs{mfcaption}[\textit{short text}]\{\textit{long text}\}}
+% \end{center}
+% for formating captions of `column figures' and
+% ^^A \DescribeMacro{\mtcaption}
+% \begin{center}
+% \fbox{\cs{mtcaption}[\textit{short text}]\{\textit{long text}\}}
+% \end{center}
+% for formating captions of column tabular material (`column tables'). As in the case of the |\caption|
+% command, the optional argument \textit{short text} goes into the list of figures or tables. If this is not
+% specified, then the mandatory argument \textit{long text} does the job.
+%
+% Thus, the previous `orphan' tabular\footnote{Sorry for using the same example again and again.} can now have a caption like this:
+% \begin{center}
+% \begin{tabularx}{\linewidth}{p{35pt}>{$}X<{$}>{$}X<{$}}
+% \hline
+% &\mathbf{x_1}&\mathbf{x_2}\\\hline\hline
+% \os{1}.&(x-1,y-1)&(x+1,y+1)\\
+% \os{2}.&(x,y-1)&(x,y+1)\\
+% \os{3}.&(x+1,y-1)&(x-1,y+1)\\
+% \os{4}.&(x-1,y)&(x+1,y)\\
+% \hline
+% \end{tabularx}
+% \mtcaption[This captions produced with the \cs{mtcaption} command.]{Caption inside \texttt{multicols}.}
+% \end{center}
+% The command line arguments were:
+% \begin{verbatim}
+% \begin{center}
+% \begin{tabularx}{\linewidth}{...}
+% ...
+% \end{tabularx}
+% \mtcaption[This captions produced with the
+% \mtcaption command.]{Caption inside
+% \texttt{multicols}.}
+% \end{center}
+% \end{verbatim}
+% It is clear now, that you just put the column material---either this is a tabular material, a figure, a picture
+% loaded with an |\epsfig|, |\includegraphics| or anything relative---followed by an |\mfcaption|, for column `figures',
+% or an |\mtcaption| for `column tables', command inside a |center| environment and thats all. You have a caption for this
+% column material, as if it was inside a floating environment. Moreover, placing the whole stuff inside a \texttt{minipage} and
+% using the |\columnbreak| command, you can achieve good looking results by manually placing the column float
+% at the top or the bottom of the page.
+%
+% \subsection{Options and customization}
+% A tactic of many well known typographers and something that one encounters very often in well printed books,
+% is that the comments explaining what is shown in a floating element, are typesetting with a \textsf{sans serif font} and with a
+% completely different lead (baseline skip) and font size than the main document's. For example, you may have a book
+% typeseted in \os{10}/\os{12}, and the captions of the floats to be in \os{9}/\os{11}.\os{5} or something else, depending
+% from the kind of the font. Especially the use of \textsf{unmodulated sans serif fonts} with a smaller font size
+% than the main document's
+% and the appropriate lead, is something that harmonizes well enough with the narrow linewidth of the two column
+% output.
+%
+% \subsubsection{The \texttt{normal} option}
+% The captions produced by the
+% \verb+\mfcaption+, \verb+\mtcaption+ and \verb+\caption+
+% commands with \textsf{multicap}, are typesetting the |\figurename| (or |\tablename|) and
+% the mandatory argument \textit{long text} with the
+% \textsf{sans serif font} defined by the
+% |\sfdefault| command. The number that is associated with the column float is typeseted with \textsc{small caps},
+% if there exists this shape for the \textsf{sans}. If not, a
+% \begin{verbatim}
+% \renewcommand{\thefigure}{%
+% \textmormal{\textsc{\arabic{figure}}}}
+% \end{verbatim}
+% in the preamble solves the problem\footnote{Replace \cs{textsc} with \cs{oldstylenums} if you are typesetting with the
+% Computer Modern fonts.}, typesetting the counter with small caps but with the normal font this time. This
+% is to deal with the high level typographic demands, that wants the comments explaining what is shown in a float
+% to be typeseted with \textsf{sans} and the number associated with this floating element to be old style.
+%
+% ^^A \DescribeMacro{normal}
+% If you don't want this perspective, \textsf{multicap} offers the unique package
+% option |normal| that typesets all
+% captions in the usual way. This can be chosen by specifying
+% \begin{center}
+% \fbox{\cs{usepackage}\texttt{[normal]\{multicap\}}}
+% \end{center}
+% in the preamble.
+%
+% \subsubsection{Changing caption's \cs{fontsize} parameters}
+% Package |multicap| offers you also the possibility to easily change the |\fontsize| parameters of the captions.
+% This can be
+% done by simply changing the values of the
+% \begin{center}\fbox{\texttt{mcapsize}}\ \,and\,\ \fbox{\texttt{mcapskip}}\end{center}
+% counter variables with the |\setcounter| declaration. What really happens, is that the values of the above counters go
+% into the first and second argument respectively of the |\fontsize| command, that changes locally inside |\mfcaption|,
+% |\mtcaption| and |\caption|.
+% For example, if you want your captions to be typeseted in \os{9}/\os{11}, then you have to do in the
+% preamble the following declarations:
+% \begin{verbatim}
+% \setcounter{mcapsize}{9}
+% \setcounter{mcapskip}{11}.
+% \end{verbatim}
+%
+% We should emphasize at this point, that \textsf{multicap's} options, along with the \texttt{mcapsize} and \texttt{mcapskip}
+% parameters, take effect \textit{and} in the |\caption| command which the package redefines. Thus, the usage of \textsf{multicap}
+% is somehow wider, in the sense that these tuning options were not given especially for a multicolumn layout. The
+% truth is that in multiple columns such changes fit better, but a novice user can also use them to format his captions
+% of his single column layout. This is not true for the parameters discussing in the next sections, which act affects
+% only the two new commands
+% |\mfcaption| and |\mtcaption| and their usage is restricted only for multicolumn output.
+%
+% \subsubsection{The \cs{abvmcapskip} length}
+% The vertical space added between the column float and the caption produced either by the |\mfcaption| or
+% |\mtcaption| command, is controlled by the
+% \begin{center}\fbox{\cs{abvmcapskip}}\end{center}
+% length parameter, which
+% is equal to the value of \os{10}pt. It is not suggested to change this value (with the |\setlength| declaration), unless if you want
+% to typeset captions with an extremely different font size and |\baselineskip|
+% than the main document's.
+%
+% \subsubsection{The \cs{blwmcapskip} length}
+% From the other side now, if you decide not to use some of the |\mfcaption| and |\mtcaption| commands that appear in your
+% code, inside a |center| environment\footnote{I suggest not to do so.}
+% (i.e. you may want to put them inside the range of a |\centering|
+% command or anything of the above,
+% thus giving a more compact look on your multicolumn layout), there is the
+% possibility of changing the vertical space separating the caption from the following text by changing the
+% \begin{center}\fbox{\cs{blwmcapskip}}\end{center} length parameter (again with |\setlength|). The default value of
+% |\blwmcapskip| is equal to the
+% value of |\parsep|.
+% However, such a change will affect only the captions produced by the |\mfcaption| and |\mtcaption| commands that are
+% outside of a |center| environment.
+%
+% This tuning option is made possible, because placing one of the |\mfcaption| or |\mtcaption|
+% declarations outside of a |center| environment, the vertical space added between the \textit{text before column
+% material} and the column float, will be smaller than the vertical space that follows after the caption and before the
+% \textit{text after the column material}. This way, with the |\blwmcapskip|, you can
+% balance the vertical space before and after the column float.
+%
+% In any case, if you wish to have a more compact look using the |\centering| command for example, you should specify
+% something like this:
+% \begin{center}\textit{... text before column material ...}
+% \begin{verbatim}
+% \par{\centering
+% \begin{tabularx}{\linewidth}{...}
+% ...
+% \end{tabularx}}
+% \mtcaption{Another caption inside multicols.}
+% \end{verbatim}
+% \textit{... text after column material ...}\end{center}
+% leaving the |\mfcaption| or |\mtcaption| declarations outside the range of |\centering|\,\footnote{We would have done
+% the same thing, if we were using the \cs{caption} command.}.^^A \par
+% \begin{center}
+% \begin{tabularx}{\linewidth}{p{35pt}>{$}X<{$}>{$}X<{$}}
+% \hline
+% &\mathbf{x_1}&\mathbf{x_2}\\\hline\hline
+% \os{1}.&(x-1,y-1)&(x+1,y+1)\\
+% \os{2}.&(x,y-1)&(x,y+1)\\
+% \os{3}.&(x+1,y-1)&(x-1,y+1)\\
+% \os{4}.&(x-1,y)&(x+1,y)\\
+% \hline
+% \end{tabularx}
+% \mtcaption{Another caption inside \texttt{multicols}.}
+% \end{center}
+%
+% \subsection{Numbering}
+% When formating captions in |multicols| using the \textsf{multicap} package and a star-form of a floating
+% environment appears, the |\caption| command keeps
+% numbering the figure or table that spans all columns now correctly, continuing from where a |\mfcaption| or
+% |\mtcaption| command had stopped, depending from the kind of float. The same thing happens when the opposite occurs---when
+% switching from the page-wide float to the column float---and when switching from \texttt{multicols} to single
+% column and back. This happens because the |\mfcaption| uses the |figure| counter to count the column figures and
+% the |\mtcaption| command the |table| counter to number the column tables. So the interchange between |\mfcaption|,
+% |\mtcaption| and |\caption| and between one and multicolumn mode, does not affect the
+% numbering of the figures or tables that are handled correctly from the package.
+% \end{multicols}
+%
+% \begin{table}[h]
+% \begin{center}
+% \begin{tabularx}{.66\linewidth}{p{35pt}>{$}X<{$}>{$}X<{$}}
+% \hline
+% &\mathbf{x_1}&\mathbf{x_2}\\\hline\hline
+% \os{1}.&(x-1,y-1)&(x+1,y+1)\\
+% \os{2}.&(x,y-1)&(x,y+1)\\
+% \os{3}.&(x+1,y-1)&(x-1,y+1)\\
+% \os{4}.&(x-1,y)&(x+1,y)\\
+% \hline
+% \end{tabularx}
+% \caption{Table produced by the \texttt{table} environment.}
+% \end{center}
+% \end{table}
+%
+% \StopEventually{}
+% \begin{multicols}{2}[\section{Implementation}]\hbadness=10000
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}%
+\ProvidesPackage{multicap}[2002/05/04
+ v1.0 formatting captions inside multicols]%
+% \end{macrocode}
+% The package requires the \textsf{ifthen} package to test some conditions.
+% \begin{macrocode}
+\RequirePackage{ifthen}%
+% \end{macrocode}
+% We now define the |\@mcaptype| command which will switch between the normal font and the Sans. Next, we
+% define the default (|Sans|) and the the |normal| option, together with a warning for any unknown option to the package.
+% \begin{macrocode}
+\newcommand*{\@mcaptype}{\@empty}%
+\DeclareOption{Sans}%
+ {\renewcommand*{\@mcaptype}{\textsf}}%
+\DeclareOption{normal}%
+ {\renewcommand*{\@mcaptype}{\relax}}%
+\DeclareOption*{%
+ \PackageWarning{multicap}{Unknown option
+ `\CurrentOption'.\MessageBreak
+ Going into default mode}%
+}%
+\ExecuteOptions{Sans}%
+\ProcessOptions*%
+% \end{macrocode}
+% The counter variables |`mcapsize'| and |`mcapskip'| which go to first and second argument of the |\fontsize| command
+% respectively are defined. The |\abvmcapskip| and |\blwmcapskip| lengths are defined too and their default values
+% are being given.
+%
+% \begin{macrocode}
+\newcounter{mcapsize}%
+\newcounter{mcapskip}%
+\newlength{\abvmcapskip}%
+\newlength{\blwmcapskip}%
+\setlength{\abvmcapskip}{10\p@}%
+\setlength{\blwmcapskip}{\parsep}%
+% \end{macrocode}
+% We define one box for each command |\mfcaption|, |\mtcaption|\ and |\caption| to make some length tests later.
+% \begin{macrocode}
+\newsavebox{\mf@tempbox}%
+\newsavebox{\mt@tempbox}%
+\newsavebox{\@temp@box}%
+% \end{macrocode}
+% We redefine the |center| environment so as to set the boolean |@cent@er| true when the environment starts and false when it ends.
+% \begin{macrocode}
+\newboolean{@cent@er}%
+\renewenvironment*{center}{%
+ \setboolean{@cent@er}{true}\trivlist%
+ \centering\item\relax}%
+ {\setboolean{@cent@er}{false}\endtrivlist}%
+% \end{macrocode}
+% The command |\@mcap@fs| checks weather the values of the |`mcapsize'| and |`mcapskip'| have change, sends them to |\fontsize| and
+% stores them in the |\@mcap@size| command.
+% \begin{macrocode}
+\DeclareRobustCommand*{\@mcap@size}{\relax}%
+\newcommand*{\@mcap@fs}{%
+ \ifthenelse{\equal{\value{mcapsize}}{0}%
+ \and\equal{\value{mcapskip}}{0}}{}%
+ {\renewcommand*{\@mcap@size}{%
+ \fontsize{\value{mcapsize}}{%
+ \value{mcapskip}%
+ }%
+ \selectfont%
+ }%
+ }%
+}%
+% \end{macrocode}
+% We are now ready to define the |\mfcaption| command. After an initial skip of |\abvmcapskip| (\os{10}pt) we increment the |figure|
+% counter with |\refstepcounter| so that the references to the column figures will work correctly. We check with |\@mcap@fs|,
+% if the values of
+% the |`mcapsize'| and |`mcapskip'| counters have been changed
+% and next we add the text specified in the |\mfcaption| command
+% to the list of figures.
+% \begin{macrocode}
+\newcommand*{\mfcaption}[2][\@empty]{%
+ \\[\abvmcapskip]%
+ \@mcap@fs%
+ \refstepcounter{figure}%
+ \ifthenelse%
+ {\equal{\protect#1}{\protect\@empty}}%
+ {\addcontentsline{lof}{figure}%
+ {\protect\numberline{\thefigure}#2}}%
+ {\addcontentsline{lof}{figure}%
+ {\protect\numberline{\thefigure}#1}}%
+% \end{macrocode}
+% After the mandatory argument \textit{long text} has been stored in |\mf@tempbox|,
+% we compare the width of the \textit{long text} with that of |\linewidth|. If the comments
+% of the figure (\textit{long text})
+% fit on a line, then they will be centered, otherwise
+% they will be typeset as a paragraph with width |\linewidth|.
+% \begin{macrocode}
+ \sbox{\mf@tempbox}{%
+ \@mcap@size\@mcaptype{%
+ \figurename\ \textsc{\thefigure{}:} #2%
+ }%
+ }%
+ \ifthenelse{\lengthtest{%
+ \wd\mf@tempbox > \linewidth}}%
+ {\begin{minipage}[t]{\linewidth}%
+ \@mcap@size\@mcaptype{%
+ \figurename\ \textsc{\thefigure{}:} #2}%
+ \end{minipage}\par%
+ }%
+ {{\centering\usebox{\mf@tempbox}\\}}%
+% \end{macrocode}
+% An skip of |\blwmcapskip| follows, if we are not inside a
+% |center| environment.
+% \begin{macrocode}
+ \ifthenelse{\boolean{@cent@er}}{}%
+ {\vspace{\blwmcapskip}}%
+}%
+% \end{macrocode}
+% The |\mtcaption| command is defined by exact the same way.
+% \begin{macrocode}
+\newcommand*{\mtcaption}[2][\@empty]{%
+ \\[\abvmcapskip]%
+ \@mcap@fs%
+ \refstepcounter{table}%
+ \ifthenelse%
+ {\equal{\protect#1}{\protect\@empty}}%
+ {\addcontentsline{lot}{table}%
+ {\protect\numberline{\thetable}#2}}%
+ {\addcontentsline{lot}{table}%
+ {\protect\numberline{\thetable}#1}}%
+ \sbox{\mt@tempbox}{%
+ \@mcap@size\@mcaptype{%
+ \tablename\ \textsc{\thetable{}:} #2%
+ }%
+ }%
+ \ifthenelse{\lengthtest{%
+ \wd\mt@tempbox > \linewidth}}%
+ {\begin{minipage}[t]{\linewidth}%
+ \@mcap@size\@mcaptype{%
+ \tablename\ \textsc{\thetable{}:} #2}%
+ \end{minipage}\par%
+ }%
+ {{\centering\usebox{\mt@tempbox}\\}}%
+ \ifthenelse{\boolean{@cent@er}}{}%
+ {\vspace{\blwmcapskip}}%
+}%
+% \end{macrocode}
+% Finally, we redefine the kernel |\@makecaption| command, so as |\caption| can have the same `properties' with the
+% |\mfcaption| and |\mtcaption| commands.
+% \begin{macrocode}
+\renewcommand{\@makecaption}[2]{%
+ \vspace{10\p@}%
+ \@mcap@fs%
+ \sbox{\@temp@box}%
+ {\@mcap@size\@mcaptype{#1{}\textsc{:} #2}}%
+ \ifthenelse{\lengthtest{%
+ \wd\@temp@box > \linewidth}}%
+ {\@mcap@size\@mcaptype{#1{}\textsc{:} #2}%
+ \par%
+ }%
+ {\centering\@mcap@size\@mcaptype{%
+ #1{}\textsc{:} #2%
+ }%
+ }%
+}%
+\endinput
+% \end{macrocode}
+% \end{multicols}
+% \listoftables
+% \begin{thebibliography}{8}
+% \bibitem{Canny}{M. Goossens, F. Mittelbach and A. Samarin, ``\textit{The \LaTeX\ Companion}'', Addison Wesley,
+% \oldstylenums{1994}.}
+% \bibitem{LTX}{The \textsc{\LaTeX3} Project, ``\textit{\LaTeXe\ for class and package writers}'', \os{1995}--\os{1998}.}
+% \bibitem{MB}{Frank Mittelbach, ``\textit{An environment for multicolumn output}'', \textsc{ctan}, file \textit{multicol.dtx},
+% March, \os{2001}.}
+% \bibitem{RB}{R. Bringhurst, ``\textit{The Elements of Typographic Style}'', Hartley \textit{\&} Marks, \os{1996}.}
+% \end{thebibliography}
+% \Finale
+%%
+%% \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 \~}
+%%
+\endinput
+