summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/paracol/man.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/paracol/man.dtx')
-rw-r--r--macros/latex/contrib/paracol/man.dtx863
1 files changed, 863 insertions, 0 deletions
diff --git a/macros/latex/contrib/paracol/man.dtx b/macros/latex/contrib/paracol/man.dtx
new file mode 100644
index 0000000000..f604ba24fa
--- /dev/null
+++ b/macros/latex/contrib/paracol/man.dtx
@@ -0,0 +1,863 @@
+% \begingroup
+% \hbadness9000 \hfuzz6pt
+%
+% \begin{paracol}{2}[\section{Introduction}]
+% This document describes the usage of yet another multi-column package named
+% \textsf{paracol}. The unique feature of the package is that columns are
+% typeset {\em in parallel.}
+%
+% Suppose you are writing a bilingual document whose left column is written in
+% a language, say English, and right column has the translation of the left
+% column in another language, e.g., Japanese. With the \textsf{paracol}
+% package you may write an English part of arbitrarily length and then {\em
+% switch} to its Japanese counterpart to place both parts side by side. Of
+% course you may return to the English writing similarly.
+%
+% The {\em\Uidx\cswitch} is always allowed when you complete an outermost
+% level paragraph. You may be unaware whether a column is broken into
+% multiple pages before switching because the package automatically goes
+% back and forward to the correct page and vertical position when you switch
+% the column. Moreover, you may {\em\Uidx\sync{}e} columns so that the tops
+% of the first paragraphs after switching in all columns are vertically
+% aligned. At a \sync{}ation point, you may give a single-column text,
+% for example a common section header, optionally. You may also switch
+% single-column and multi-column in a page arbitrary.
+%
+% This manual itself is an example of two-column documents typeset by
+% \textsf{paracol}. Since the author is not familiar with languages other
+% than English and Japanese and the latter should be hardly understood by
+% most of readers, the right column is the translation of the left English
+% column into a computational language. That is, the right column is the
+% \LaTeX{} source code of the left column\footnote{
+% 
+% Not really but its essence
+% is shown.\label{fn:first}}.
+%
+% \switchcolumn
+%\begin{Verbatim}
+%\begin{paracol}{2}[\section{Introduction}]
+%\hbadness5000
+%This document describes the usage of yet
+%another multi-column package named
+%\textsf{paracol}. The unique feature of
+%the package is that columns are typeset
+%{\em in parallel.}
+%
+%Suppose you are writing a bilingual
+%document whose left column is written in a
+%language, say English, and right column has
+%the translation of the left column in
+%another language, e.g. Japanese. With the
+%\textsf{paracol} package you may write an
+%English part of arbitrary length and then
+%{\em switch} to its Japanese counterpart to
+%place both parts side by side. Of course
+%you may return to the English writing
+%similarly.
+%
+%The column switching is always allowed when
+%you complete an outermost level paragraph.
+%You may be unaware whether a column is
+%broken into multiple pages before switching
+%because the package automatically goes back
+%and forward to the correct page and
+%vertical position when you switch the
+%column. Moreover, you may {\em
+%synchronize} columns so that the tops of
+%the first paragraphs after switching in all
+%columns are vertically aligned. At a
+%synchronization point, you may give a
+%single-column text, for example a common
+%section header, optionally. You may also
+%switch single-column and multi-column in a
+%page arbitrary.
+%
+%This manual itself is an example of
+%two-column documents typeset by
+%\textsf{paracol}. Since the author is not
+%familiar with languages other than English
+%and Japanese and the latter should be
+%hardly understood by most of readers, the
+%right column is the translation of the left
+%English column into a computational
+%language. That is, the right column is the
+%\LaTeX{} source code of the left column%
+%\footnote{Not really but its essence is
+%shown.}.
+%
+%\switchcolumn
+% \end{Verbatim}
+% |\begin{verbatim}|\\
+% {\it Here is the source of above.}\\
+% |\end{verbatim}|\footnote{
+% This \texttt{verbatim} construct is simply referred as to
+% ``\textit{source}'' hereafter.}
+%
+%
+%
+% \switchcolumn*[\section{Basic Usage}]
+% Loading the package is very simple. What you have to do is
+% \!\usepackage!|{|\Uidx{\env{paracol}}|}| in the preamble. Note that
+% \textsf{paracol} can be used with \LaTeXe{} and does not work with
+% \LaTeX{} 2.09.
+%
+% \switchcolumn
+%
+%\begin{Verbatim}
+%\switchcolumn*[\section{Basic Usage}]
+%Loading the package is very simple. What
+%you have to do is |\usepackage{paracol}|
+%\end{Verbatim}
+% |in the preamble. ...|\footnote{
+% Hereafter, a part of the source code may be omitted like this.}\\
+% |\switchcolumn|\\
+% \textit{source}
+%
+% \switchcolumn*
+% The fundamental means of parallel-column typesetting are the environment
+% \env{paracol} and the command \Uidx{\!\switchcolumn!}. The \env{paracol}
+% environment needs an argument to specify the number of columns. Thus the
+% following is the basic construct for two-parallel-column documents.
+% \begin{quote}
+% \!\begin!|{|\env{paracol}|}{2}|\\
+% \textit{left column text}\\
+% \!\switchcolumn!\\
+% \textit{right column text}\\
+% \!\switchcolumn!\\
+% \textit{left column text}\\
+% \!\switchcolumn!\\
+% \textit{right column text}\\
+% \!\switchcolumn!\\
+% \mbox{\hspace{4em}}$\vdots$\\
+% \!\end!|{|\env{paracol}|}|
+% \end{quote}
+%
+% \switchcolumn
+%\begin{Verbatim}
+%\switchcolumn*
+%The fundamental means of parallel-column
+%typesetting are the environment |paracol|
+%and the command |\switchcolumn|. ...
+%\switchcolumn
+%\end{Verbatim}
+% \textit{source}
+%
+% \switchcolumn[1]*
+%\begin{Verbatim}
+%\switchcolumn[1]*
+%\end{Verbatim}
+% \textit{source}
+%\begin{Verbatim}
+%\switchcolumn[0]
+%The |\switchcolumn| command may have an
+%optional argument to specify the column
+%number (zero origin) to start. ...
+%\end{Verbatim}
+%
+% \switchcolumn[0]
+% The \!\switchcolumn! command may have an optional argument to specify the
+% column number (zero origin) to start. That is, \!\switchcolumn!|[0]|
+% means to switch to the leftmost column, |\switchcolumn[1]| is to start the
+% second column and so on. Thus the |\switchcolumn| without the optional
+% argument may be considered as \!\switchcolumn!|[|$i+1\bmod{n}$|]| where
+% $i$ is the ordinal of the column you are leaving from and $n$ is the
+% number of columns given to \env{paracol} environment.
+%
+%
+%
+% \switchcolumn[0]*[\section{Column Synchronization}\label{sec:sync}]
+% The \!\switchcolumn! command may also be followed by a `|*|' to
+% {\em\Uidx\sync{}e} columns. After you switch from a column to another by
+% \!\switchcolumn!|*| (or \!\switchcolumn!|[|$i$|]*|), all the columns are
+% vertically aligned at the bottom of the {\em deepest} one preceding the
+% command. For example, the previous section has three \!\switchcolumn!|*|
+% commands at which left and right columns are vertically aligned.
+%
+% The {\em starred} version of \!\switchcolumn! may have an optional
+% argument to specify a single-column {\em\Uidx\mctext} whose bottom is the
+% vertical alignment point of columns. For example, \!\section!
+% commands in this manual are given as optional arguments
+% of \!\switchcolumn!|*| like;
+%\begin{Verbatim}
+% \switchcolumn*[\section{Basic Usage}]
+%\end{Verbatim}
+% The \env{paracol} environment may also start with a \mctext{} by
+% specifying it as the optional argument of \!\begin!|{|\env{paracol}|}|.
+% For example, at the beginning of this document, the author put;
+%\begin{Verbatim}
+% \begin{paracol}{2}[\section{Introduction}]
+%\end{Verbatim}
+%
+% \switchcolumn
+%\begin{Verbatim}
+%\switchcolumn[0]*[%
+% \section{Column Synchronization}
+% \label{sec:sync}]
+%The |\switchcolumn| command may also be
+%followed by a `|*|' to {\em synchronize}
+%columns. ...
+%
+%The {\em starred} version of
+%|\switchcolumn| may have an optional
+%argument to specify a multi-column text
+%whose bottom is the vertical alignment
+%points of the columns. ...
+%\switchcolumn
+%\end{Verbatim}
+% \textit{source}
+%
+%
+%
+% \begin{column*}[\section{Environments for Columns}\label{sec:env}]
+% \Uidx{\Index{column-switching environment}}
+% \subsection{Environment \texttt{column}}
+% The \!\switchcolumn! is simple but you may prefer to pack the contents of a
+% column in an environment. The \Uidx{\env{column}} environment is
+% available for this well-structuralization of \LaTeX{} sources for
+% parallel-columned documents. A construct;
+% \begin{quote}
+% \!\begin!|{|\env{column}|}|\\
+% \textit{text for a column}\\
+% \!\end!|{|\env{column}|}|
+% \end{quote}
+% is (almost) equivalent to;
+% \begin{quote}
+% \!\switchcolumn!\\
+% \textit{text for a column}
+% \end{quote}
+% The \Uidx{\env{column*}} environment is also available for the column
+% \sync{}ation and may have an optional argument for \mctext.
+% \end{column*}
+%
+% \begin{column}
+% \subsection{\ttfamily Environment column}
+%\begin{Verbatim}
+%\begin{column*}[%
+% \section{Environments for Columns}
+% \label{sec:env}]
+%\subsection{Environment \texttt{column}}
+%The |\switchcolumn| is simple but you may
+%prefer to pack the contents of a column in
+%an environment. ...
+%\end{column*}
+%\begin{column}
+%\end{Verbatim}
+% \textit{source}\\
+% |\end{column}|
+% \end{column}
+%
+% \begin{nthcolumn*}{1}
+% \subsection{\ttfamily Environment nthcolumn}
+%\begin{Verbatim}
+%\begin{nthcolumn*}{1}
+%\end{Verbatim}
+% \textit{source}
+%\begin{Verbatim}
+%\end{nthcolumn*}
+%
+%\begin{nthcolumn}{0}
+%\subsection{Environment \texttt{nthcolumn}}
+%The |\switchcolumn| can start an
+%arbitrarily specified column with the
+%column number given through its optional
+%argument, but the |column| environment
+%cannot do it. ...
+%\end{nthcolumn}
+%\end{Verbatim}
+% \end{nthcolumn*}
+% \begin{nthcolumn}{0}
+% \subsection{Environment \texttt{nthcolumn}}
+% The \!\switchcolumn! can start an arbitrarily specified column with the
+% column number given through its optional argument, but the \env{column}
+% environment cannot do it. If you want to start $i$-th column, you have to
+% do \!\begin!|{|\Uidx{\env{nthcolumn}}|}{|$i$|}| (or
+% \Uidx{\env{nthcolumn*}} with an optional argument to \sync{}e).
+% \end{nthcolumn}
+%
+%
+%
+% \begin{leftcolumn*}
+% \subsection[Environments \texttt{leftcolumn} and \texttt{rightcolumn}]
+% {Environments \texttt{leftcolumn} and\\\texttt{rightcolumn}}
+% The environments \Uidx{\env{leftcolumn}} and \Uidx{\env{rightcolumn}} (and
+% their starred versions with an optional argument) are available as more
+% convenient means than saying \!\begin!|{|\env{nthcolumn}|}{0}| to switch
+% to the left(most) column and
+% \!\begin!|{|\env{nthcolumn}|}{1}| to the right (but may not be rightmost)
+% one.
+% 
+% \Uidx{\EnvIndex{leftcolumn*}}\Uidx{\EnvIndex{rightcolumn*}}
+%
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\textwidth{}\\
+% double-column figure \#1\\
+% \\\hline
+% \end{tabular}}
+% \caption{A Double-Column Figure}
+% \end{figure*}
+% \begin{figure}[t]\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\
+% single-column figure \#1\\
+% \\\\\hline
+% \end{tabular}}
+% \caption{A Single-Column Figure}
+% \end{figure}
+% \end{leftcolumn*}
+%
+% \begin{rightcolumn}
+% \subsection{\ttfamily Environment leftcolumn and\\rightcolumn}
+%\begin{Verbatim}
+%\begin{leftcolumn*}
+%\subsection{%
+% Environments \texttt{leftcolumn} and\\
+% \texttt{rightcolumn}}
+%The environments |leftcolumn| and
+%|rightcolumn| (and their starred versions
+%with an optional argument) are available as
+%more convenient means than saying
+%|\begin{nthcolumn}{0}| to switch to the
+%left(most) column and ...
+%\begin{figure*}...\end{figure*}
+%\begin{figure}[t]...\end{figure}
+%\end{leftcolumn*}
+%\begin{rightcolumn}
+%\end{Verbatim}
+% \textit{source and a \texttt{figure} env}\\
+% |\end{rightcolumn}|
+% \begin{figure}[t]\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\
+% \ttfamily single-column figure \#2\\
+% \\\hline
+% \end{tabular}}
+% \caption{\ttfamily Another Single-Column Figure}
+% \end{figure}
+% \end{rightcolumn}
+%
+%
+%
+% \begin{leftcolumn*}[\section{Floats, Footnotes and Counters}
+% \label{sec:float}]
+% \changes{v1.2-7}{2013/05/11}
+% {Remove \cs{nosv} from verbatim example of Table~1 shown in the right
+% column.}
+% \changes{v1.32-3}{2015/10/10}
+% {Add footnote to mention the page-wise float problem.}
+% \begin{table}[b]\nosv
+% \caption{A Single-Column Table}
+% \centerline{\begin{tabular}[t]{|l|c|r|}\hline
+% An&example&of\\\hline
+% single&column&table\\\hline
+% \end{tabular}}
+% \end{table}
+% \subsection{Figures and Tables}
+% As shown in this page, double-column figures\slash tables (or those
+% spanned multiple columns if you have three or more) may be placed by
+% \env{figure*} and \env{table*} environments as usual\footnote{
+% 
+% See Section~\ref{sec:problem} for the appearance order issue of
+% double-column floats.}.
+% 
+% A single-column figure\slash table will be placed in the column in which
+% you put \env{figure} and \env{table}. For example, the body of a
+% \env{figure} environment in a \env{leftcolumn} environment is
+% \emph{always} placed in a left column. That is, even if the column of the
+% \emph{current} page does not have enough room to place the figure, it will
+% not be thrown to the right column but will be placed in the left column of
+% the next page\footnote{
+% 
+% Or some farther page if \LaTeX{} cannot solve the placement problem wisely.}.
+%
+% Another caution about float placement is that you have to be careful when
+% you try to put a top-float explicitly with |t|-option or implicitly without
+% placement option (i.e., |tbp| in most classes) and to \sync{}e columns.
+% The rule is as follows; after you \sync{}e columns in a page, the page
+% cannot have top-floats any more. When you \sync{}e columns,
+% \textsf{paracol} fixes a virtual horizontal line in the page as the
+% \sync{}ation barrier. Thus no top-floats cannot be added above the
+% line\footnote{
+% 
+% Even if you have enough space above, sorry.}.
+% 
+% Therefore, the author put two \env{figure} environments for the figures
+% shown in this page into the \env{leftcolumn*} and \env{rightcolumn}
+% environment for the previous section.
+%
+% \subsection{Footnotes and Marginal Notes}
+% \changes{v1.2-2}{2013/05/11}
+% {Add a footnote mentioning page-wise footnotes.}
+%
+% Footnotes are also put at the bottom of the column in which \!\footnote!
+% commands and their references reside (like this\footnote{
+% 
+% Unless you specify to make footnotes {\em page-wise} as explained in
+% Section \ref{sec:ref-scfnote} and \ref{sec:fnnp}.}),
+% 
+% as shown in page~\pageref{fn:first} and this page. Marginal
+% notes behave similarly like what you are seeing in the left margin of this
+% sentence\marginpar{
+% 
+% \raggedright An example of marginal note.}
+% 
+% and the right marginal note in this page\footnote{
+% 
+% If you have three or more columns, marginal notes of the second or
+% succeeding columns are placed in the right margin in default setting. The
+% \textsf{paracol} package solves the placement problem of marginal notes
+% from two or more columns sharing a side margin by moving some of them down
+% if they conflict over the space with each other.}.
+%
+% \subsection{Local and Global Counters}
+% \UsageIndex{local counter}
+% \UsageIndex{global counter}
+% 
+% You probably found that the numbering of figures and tables is \emph{global}
+% while that of footnotes are \emph{local}. That is, the figure in the right
+% column of the previous page has number~3 following its left-column
+% counterpart Figure~2. The tables in the page are also numbered as 1 and 2
+% crossing the column boundary. However, the footnotes in each column have
+% their own numbering sequence. Moreover, the footnote numbers in left
+% columns are typeset in roman font while those in right columns have italic
+% shapes. Similarly, subsection numbering is local and the headings in right
+% columns have typewriter-face numbers.
+%
+% This happens because the author declared the counters \counter{figure} and
+% \counter{table} are \emph{global} in the preamble of this document by
+% saying;
+% \begin{itemize}\item[]
+% \Uidx{\!\globalcounter!}|{figure}|\\
+% \!\globalcounter!|{table}|
+% \end{itemize}
+% and do nothing about \counter{footnote} and \counter{subsection} counters.
+% By default, all the counters except for |page| are local to columns. The
+% value of a \lcounter{} of a column is saved somewhere when you leave the
+% column, and it is restored when you revisit the column. The initial values
+% of the \lcounter{}s are the values they have at
+% \!\begin!|{|\env{paracol}|}|. After you close the \env{paracol}
+% environment, the values of the leftmost column are used for the rest of
+% your document until you start new \env{paracol} environment. On a
+% restart, \lcounter{}s in a column have the values they had at the last
+% \Endparacol, except for those which have been modified outside the
+% environment because the modifications are \emph{broadcasted} to
+% \lcounter{}s in all columns. You will see the effect of this
+% inter-environment counter value conservation in the footnote numbers in
+% the right column in page~\pageref{fn:right3} and \pageref{fn:right4}.
+%
+% This broadcasting of a \lcounter{} value can be done explicitly in
+% \env{paracol} environments by a command $\Uidx{\!\synccounter!}\Arg{ctr}$.
+% This command makes $\mathit{ctr}$ in all columns have the value of that in
+% the column in which the command appears. In addition, another command
+% \Uidx{\!\syncallcounters!} performs this broadcasting for all \lcounter{}s.
+%
+% If you make a counter global by the command \!\globalcounter!, the
+% save/restore operations are not performed to the counter and thus it is
+% globally incremented by |\[ref]|\AB|stepcounter|
+% 
+% \SpecialIndex{\refstepcounter}\SpecialIndex{\stepcounter}
+% 
+% or commands such as \!\caption! and \!\section!. Note that the value of a
+% \gcounter{} depends on the place where it is incremented (or set) in
+% the \emph{source code} rather than where it appears in the output. Thus
+% if the author put a \env{table} environment here to increment \env{table}
+% counter, the right-column table at the bottom of page~\pageref{tab:right}
+% would be Table~3 because its \env{table} environment does not appear yet
+% in the source code. Note that, however, though the counter \counter{page}
+% is global as expected, its numbering is consistent among all columns as
+% far as you refer to the value by $\!\pageref!\Arg{label}$ and/or see the
+% values in table of contents, etc.
+%
+% Another counter which the author made global in this document is
+% \counter{section}. As explained in Section~\ref{sec:sync}, an optional
+% \mctext{} of \cswitch{} is considered as in the leftmost column. Since
+% \!\section! commands in this document are always given in \mctext{}s, so
+% far, it seems unnecessary to make \counter{section} global because it is
+% incremented correctly in the leftmost column. However, the stepping
+% \counter{section} has a side effect to reset its descendent counter
+% \counter{subsection} and referred to from \!\thesubsection! command. Thus
+% if \counter{section} were local, the right-column subsections in
+% Section~\ref{sec:env} would be numbered as ``0.1'', ``0.2'' and ``0.3''
+% because the local value of \counter{section} would be zero. Moreover, the
+% right-column subsections of this section would be ``0.4'', ``0.5'' and
+% ``0.6'' because stepping \counter{section} local to the left column would
+% not reset \counter{subsection} local to the right column.
+%
+% You may give a local appearance to a counter \textit{ctr} for the $i$-th
+% column (zero origin) by a command;
+% \begin{itemize}\item[]
+% \Uidx{\!\definethecounter!}|{|\textit{ctr}|}{|$i$|}{|\textit{def}|}|
+% \end{itemize}
+% where \textit{def} is to be the body of the local definition of
+% |\the|\textit{ctr}. For example, the preamble of this document has the
+% following to give non-default defitions to \!\thefootnote! and
+% \!\thesubsection! for right columns.
+% 
+%\begin{Verbatim}
+% \definethecounter{footnote}{1}{%
+% \textit{\arabic{footnote}}}
+% \definethecounter{subsection}{1}{%
+% \texttt{%
+% \arabic{section}.\arabic{subsection}}}
+%\end{Verbatim}
+%\end{leftcolumn*}
+%
+% \begin{rightcolumn}
+% \begin{table}[b]\nosv
+% \caption{\ttfamily Another Single-Column Table}
+% \label{tab:right}
+% \centerline{\ttfamily \begin{tabular}[t]{|l|r|}\hline
+% Another&example\\\hline
+% of&single\\\hline
+% column&table\\\hline
+% \end{tabular}}
+% \end{table}
+% \subsection{\ttfamily Figures and Tables}
+%\begin{Verbatim}
+%\begin{leftcolumn*}[\section{%
+% Floats, Footnotes and Counters}]
+%\begin{table}[b]
+%\caption{A Single-Column Table}
+%\centerline{\begin{tabular}[t]{|l|c|r|}
+% \hline
+% An&example&of\\\hline
+% single&column&table\\\hline
+% \end{tabular}}
+%\end{table}
+%\subsection{Figures and Tables}
+%As shown in this page, double-column
+%figures\slash tables (or those spanned
+%multiple columns if you have three or more
+%columns) may be placed by |figure*| and
+%\end{Verbatim}
+% {\ttfamily |table*| environments as usual\footnote{Another example
+% of footnote.\label{fn:right3}}. ...}
+%
+% \subsection{\ttfamily Footnotes and Marginal Notes}
+%\begin{Verbatim}
+%Footnotes are also put at the bottom of the
+%column in which |\footnote| commands and
+%their references reside (like
+%this\footnote{...}), as shown in page~2 and
+%this page. Marginal notes behave similarly
+%like what you are seeing in the left margin
+%of this sentense\marginpar{\raggedright
+%An example of marginal note.} and the right
+%marginal note in this
+%\end{Verbatim}
+% |page\footnote{...}. ...|
+% \marginpar{\raggedright\ttfamily
+% Another example of marginal note.}
+%
+% \begin{figure}[t]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\\\
+% \ttfamily another figure with [t] option\\
+% \ttfamily to fill space
+% \\\\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% Another Figure with [t] Option}
+% \end{figure}
+%
+% \begin{figure}[b]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\
+% \ttfamily a figure with [b] option\\
+% \ttfamily to fill space\\
+% \\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% A Figure with [b] Option}
+% \end{figure}
+%
+% \subsection{\ttfamily Local and Global Counters}
+%\begin{Verbatim}
+%You probably found that the numbering of
+%figures and tables is \emph{global} while
+%that of footnotes are \emph{local}. ...
+%\end{leftcolumn*}
+%\begin{rightcolumn}
+%\end{Verbatim}
+% \textit{source}.\\
+% |\end{rightcolumn}|
+%
+% \begin{figure}[p]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\\\
+% \ttfamily a figure with [p] option\\
+% \ttfamily to fill space
+% \\\\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% A Figure with [p] Option}
+% \end{figure}
+%
+% \begin{figure}[p]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\\\
+% \ttfamily another figure with [p] option\\
+% \ttfamily to fill space
+% \\\\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% Another Figure with [p] Option}
+% \end{figure}
+%
+% \begin{figure}[p]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\\\
+% \ttfamily yet another figure with [p]\\
+% \ttfamily option to fill space
+% \\\\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% Yet Another Figure with [p] Option}
+% \end{figure}
+%
+% \begin{figure}[p]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\\\
+% \ttfamily fourth figure with [p]\\
+% \ttfamily option to fill space
+% \\\\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% Forth Figure with [p] Option}
+% \end{figure}
+%
+% \begin{figure}[t]\nosv
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\columnwidth{}\\\\\\
+% \ttfamily yet another figure with [t]\\
+% \ttfamily option to fill space
+% \\\\\\\hline
+% \end{tabular}}
+% \caption{\ttfamily
+% Yet Another Figure with [t] Option}
+% \end{figure}
+% \end{rightcolumn}
+% \switchcolumn*
+% \flushpage
+% \end{paracol}
+%
+%
+%
+% \section{Closing \texttt{paracol} Environment and Page Flushing}
+% \label{sec:man-close}
+% The final example shown here is this single-column text which the author put
+% after the \env{paracol} environment above is closed. As you are seeing, a
+% \env{paracol} environment can be finished at any vertical position in a
+% page and can be followed by ordinary single column texts.
+%
+% \begin{paracol}{2}
+% \begin{leftcolumn}
+% The environment may also be restarted anywhere you like as shown here.
+%
+% The last issue is to flush a page. The ordinary \!\newpage! command works
+% as you expect. If you say \!\newpage! in the left column in a page, the
+% contents following it will appear in the left column in the next page. Note
+% that this does not affect the layout of the right column.
+%
+% To flush all columns in a page, a command \Uidx{\!\flushpage!} is
+% available. This command in $i$-th column is almost equivalent to;
+% \begin{itemize}\item[]
+% \!\switchcolumn!|[|$i$|]*[|\!\newpage!|]|
+% \end{itemize}
+% but more robust\footnotemark\label{fn:flush}.
+% The ordinary page breaking command \Uidx{\!\clearpage!} may also be used
+% to flush all columns and to start a fresh page, but it has a side effect
+% to put all figures and tables which are not yet output.
+% \end{leftcolumn}
+%
+% \begin{rightcolumn}
+%\begin{Verbatim}
+%\begin{paracol}{2}
+%\begin{leftcolumn}
+%The environment may also be restarted
+%anywhere you like as shown here. ...
+%\end{leftcolumn}
+%\begin{rightcolumn}
+%\end{Verbatim}
+% \textit{source}\\
+% |\end{rightcolumn}|\\
+% |\end{paracol}|\\
+% |Now the aurthor will do ...|
+% \end{rightcolumn}
+% \end{paracol}
+%
+% \changes{v1.1}{2012/05/11}
+% {Add \cs{columnratio}\texttt{\char`\{0.6\char`\}} and a phrase
+% for it.}
+% Now the author will do |\flushpage| shortly to start a real binlingual
+% example from the next page, after showing another example of closing
+% \env{paracol} environments in this sentence and of restarting in the next
+% one, in which {\em unbalanced column width} is demonstrated using
+% \Uidx{\!\columnratio!} command shown in Section~\ref{sec:ref-colwidth}.
+%
+% \columnratio{0.6}
+% \begin{paracol}{2}
+% \begin{leftcolumn}
+% O.K., we have restarted \env{paracol} environment and we will see the
+% effect of \!\flushpage! now!!\footnotetext{
+% 
+% For example \texttt{\string\switchcolumn*} may flush a page for the
+% \sync{}ation and thus \texttt{\string\newpage} may leave an empty page.}
+% 
+% \end{leftcolumn}
+% \begin{rightcolumn}
+%\begin{Verbatim}
+%\columnratio{0.6}
+%\begin{paracol}{2}
+%\begin{leftcolumn}
+%O.K., ...
+%\end{leftcolumn}
+%\end{Verbatim}
+% |\begin{rightcolumn}| \textit{source}\\
+% |\end{rightcolumn}|
+% \flushpage
+% \end{rightcolumn}
+%
+%
+%
+% \changes{v1.2-7}{2013/05/11}
+% {Correct a few words in German and English libretti.}
+% \newenvironment{Gverse}{\ensurevspace{2\baselineskip}\begin{leftcolumn*}
+% \begin{myverse}}
+% {\end{myverse}\end{leftcolumn*}}
+% \newenvironment{Everse}{\begin{rightcolumn}\begin{myverse}}
+% {\end{myverse}\end{rightcolumn}}
+% \makeatletter
+% \newenvironment{myverse}{\leftmargini0pt\partopsep0pt\verse}{\endverse}
+%
+% \begin{leftcolumn*}[
+% \centerline{\Large An Die Freude/To Joy}\label{page:bfreude}\smallskip
+% \centerline{\large Friedrich Schiller}\smallskip
+% The following is the libretto of the fourth movement of Beethoven's Ninth
+% Symphony, his adaptation of Schiller's ode ``An Die Freude'' (or ``To Joy'' in
+% English). Beethoven's additions and revisions are indicated in italics.]
+% \end{leftcolumn*}
+% \begin{Gverse}
+% \itshape O Freunde, nicht diese T\"one! \\
+% Sondern la{\ss}t uns angenehmere anstimmen und freu\-denvollere
+% \footnote{If I had been a good student in my German class, I could find
+% the German translation of the right column footnote \ref{fn:right4} is
+% ``Dieser Teil wurde van Beethoven hinzugef\"ugt'' by myself without
+% the kind help from a user.}.
+% \end{Gverse}
+% \begin{Everse}
+% \itshape Oh friends, no more of these sad tones!\\
+% Let us rather raise our voices together\\
+% In more pleasant and joyful tones
+% \footnote{This part was added by Beethoven.\label{fn:right4}}.
+% \end{Everse}
+% \begin{Gverse}
+% Freude!\\
+% Freude, sch\"oner G\"otterfunken
+% Tochter aus Elysium,\\
+% Wir betreten feuertrunken,
+% Himmlische, dein Heiligtum!\\
+% Deine Zauber binden wieder,
+% {\itshape Was die Mode streng geteilt;\\
+% Alle Menschen werden Br\"uder\footnote{
+% Original: Was der Mode Schwert geteilt;\\
+% Bettler werden F\"urstenbr\"uder,},}
+% Wo dein sanfter Fl\"u\-gel weilt
+% \end{Gverse}
+% \begin{Everse}
+% Joy! \\
+% Joy, thou shining spark of God,\\
+% Daughter of Elysium,\\
+% With fiery rapture, goddess,\\
+% We approach thy shrine.\\
+% Your magic reunites\\
+% {\itshape That which stern custom has parted;\\
+% All humans will become brothers\footnote{
+% Original:
+% What custom's sword has parted;\\
+% Beggars become princes' brothers}}\\
+% Under your protective wing.
+% \end{Everse}
+% \begin{Gverse}
+% Wem der gro{\ss}e Wurf gelungen,
+% eines Freundes Freund zu sein;\\
+% Wer ein holdes Weib errungen,
+% mische seinen Jubel ein!\\
+% Ja, wer auch nur eine Seele
+% sein nennt auf dem Erdenrund!\\
+% Und wer's nie gekonnt, der stehle
+% weinend sich aus diesem Bund!
+% \end{Gverse}
+% \begin{Everse}
+% Let the man who has had the fortune\\
+% To be a helper to his friend,\\
+% And the man who has won a noble woman,\\
+% Join in our chorus of jubilation!\\
+% Yes, even if he holds but one soul\\
+% As his own in all the world!\\
+% But let the man who knows nothing of this\\
+% Steal away alone and in sorrow.
+% \end{Everse}
+% \begin{Gverse}
+% Freude trinken alle Wesen
+% an den Br\"usten der Natur;\\
+% Alle Guten, alle B\"osen
+% folgen ihrer Rosenspur.\\
+% K\"usse gab sie uns und Reben,
+% einen Freund, gepr\"uft im Tod;\\
+% Wollust ward dem Wurm gegeben,
+% und der Cherub steht vor Gott.
+% \end{Gverse}
+% \begin{Everse}
+% All the world's creatures drink\\
+% From the breasts of nature;\\
+% Both the good and the evil\\
+% Follow her trail of roses.\\
+% She gave us kisses and wine\\
+% And a friend loyal unto death;\\
+% She gave the joy of life to the lowliest,\\
+% And to the angels who dwell with God.
+% \end{Everse}
+% \begin{Gverse}
+% Froh, wie seine Sonnen fliegen
+% durch des Himmels pr\"acht'gen Plan,\\
+% Laufet, Br\"uder, eure Bahn,
+% freudig, wie ein Held zum Siegen.
+% \end{Gverse}
+% \begin{Everse}
+% Joyous, as his suns speed\\
+% Through the glorious order of Heaven,\\
+% Hasten, brothers, on your way,\\
+% Joyful as a hero to victory.
+% \end{Everse}
+% \begin{Gverse}
+% Seid umschlungen, Millionen!
+% Diesen Ku{\ss} der ganzen Welt!\\
+% Br\"uder, \"uber'm Sternenzelt
+% mu{\ss} ein lieber Vater woh\-nen.
+% \end{Gverse}
+% \begin{Everse}
+% Be embraced, all ye millions!\\
+% With a kiss for all the world!\\
+% Brothers, beyond the stars\\
+% Surely dwells a loving Father.
+% \end{Everse}
+% \begin{Gverse}
+% Ihr st\"urzt nieder, Millionen?
+% Ahnest du den Sch\"opfer, Welt?\\
+% Such'ihn \"uberm Sternenzelt!
+% \"Uber Sternen mu{\ss} er wohnen.
+% \end{Gverse}
+% \begin{Everse}
+% Do you kneel before him, oh millions?\\
+% Do you sense the Creator's presence?\\
+% Seek him beyond the stars!\\
+% He must dwell beyond the stars.
+% \end{Everse}
+% \end{paracol}
+% \label{page:efreude}
+% \endgroup
+\endinput