summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paracol
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-10-28 23:39:47 +0000
committerKarl Berry <karl@freefriends.org>2011-10-28 23:39:47 +0000
commit08521dabedd78b6b28f56c0fc227f17acfbd5daa (patch)
tree2298f971bc0a87a331961cc1ab33bf82891f2142 /Master/texmf-dist/doc/latex/paracol
parent8c4c55e62396b8d36fdbae726ebb52e47a8e449d (diff)
paracol (28oct11)
git-svn-id: svn://tug.org/texlive/trunk@24426 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/paracol')
-rw-r--r--Master/texmf-dist/doc/latex/paracol/README40
-rw-r--r--Master/texmf-dist/doc/latex/paracol/paracol-man.pdfbin85173 -> 125522 bytes
-rw-r--r--Master/texmf-dist/doc/latex/paracol/paracol-man.tex819
3 files changed, 53 insertions, 806 deletions
diff --git a/Master/texmf-dist/doc/latex/paracol/README b/Master/texmf-dist/doc/latex/paracol/README
index a8cee1b5f52..be9b330bab7 100644
--- a/Master/texmf-dist/doc/latex/paracol/README
+++ b/Master/texmf-dist/doc/latex/paracol/README
@@ -1,10 +1,10 @@
-paracol (v0.91): a multi-column package to typeset columns in "parallel".
+paracol (v1.00): a multi-column package to typeset columns in "parallel".
===
Copyright (C) 2005-2011
Hiroshi Nakashima <h.nakashima@DOMAIN; DOMAIN=media.kyoto-u.ac.jp>
(Kyoto Univerisity)
This package can be redistributed and/or modified under the terms
-of the LaTeX Project Public License Distributed from CTAN
+of the LaTeX Project Public License distributed from CTAN
archives in directory macros/latex/base/lppl.txt; either
version 1 of the License, or any later version.
===
@@ -12,9 +12,32 @@ version 1 of the License, or any later version.
[Contents]
- README ............ this document
-- paracol.sty ....... the style file
-- paracol-man.tex ... LaTeX source of the manual
-- paracol-man.pdf ... PDF of the manual
+- paracol.ins ....... for docstrip
+- paracol.dtx ....... main dtx for manual and implementation document
+- man.dtx ........... source of Section 1 to 6 of user's manual
+- ref.dtx ........... source of Section 7 of user's manual
+- impl.dtx .......... source of implementation document
+- paracol-man.pdf ... PDF of user's manual
+
+[How to "make"]
+
+ % tex paracol.ins # you'll have paracol.sty and paracol-man.tex
+
+# to have user's manual (its PDF is included in the distribution)
+ % latex paracol-man
+ % latex paracol-man # you need do it twice to make index correct.
+ % makeindex -s gind.ist -o paracol-man.ind paracol-man.idx
+ % latex paracol-man
+
+# to have implementation document
+ % latex paracol.dtx
+ % latex paracol.dtx # you need do it twice to make index correct.
+ % makeindex -s gind.ist -o paracol.ind paracol.idx
+ % makeindex -s gglo.ist -o paracol.gls paracol.glo
+ % latex paracol.dtx
+
+Note that if you want LaTeXing paracol-man.tex and/or paracol.dtx,
+you need newvbtm.sty being also available in CTAN.
[Features]
@@ -27,8 +50,11 @@ version 1 of the License, or any later version.
+ Counters are "local" to each column in default but you may make some of
them global to all columns by \globalcounter{<ctr>}.
-+ \definethecounter{<ctr>}{<i>}{<def>} to give <ctr> its appearance
- <def>inition specific to <i>-th column.
++ \definethecounter{<ctr>}{<col>}{<rep>} to give <ctr> its <rep>resentaion
+ specific to <col>-th column.
+
++ \addcontentsonly{<file>}{<col>} to allow contents output for <file> only
+ from <col> (new for v1.00).
Enjoy!
diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf
index ffd8f72a0a9..bda56762ffe 100644
--- a/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf
+++ b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.tex b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
index f2af2d6b6f6..16fe5567df7 100644
--- a/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
+++ b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
@@ -1,808 +1,29 @@
-%234567890123456789012345678901234567890123
-\documentclass{article}
+%% LaTeX file 'paracol-man'.
+%% Copyright (C) 2005-2011
+%% Hiroshi Nakashima <h.nakashima@DOMAIN; DOMAIN=media.kyoto-u.ac.jp>
+%% (Kyoto University)
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License distributed from CTAN
+%% archives in directory macros/latex/base/lppl.txt; either
+%% version 1 of the License, or any later version.
+
+\ProvidesFile{paracol-man.tex}
+[2011/10/10 v1.0 ]
+\documentclass{ltxdoc}
\usepackage{paracol}
\usepackage{newvbtm}
-
+\DisableCrossrefs
+\PageIndex
+\CodelineNumbered
+\RecordChanges
+\OnlyDescription
+\def\ONLYDESCRIPTION{}
\textwidth210mm
\advance\textwidth-40mm \oddsidemargin20mm \advance\oddsidemargin-1in
\columnsep10mm
\marginparwidth20mm \advance\marginparwidth-\marginparsep
\marginparsep.5\marginparsep
-
-\def\|{\verb|}
-
-\newverbatim{Verbatim}{\topsep0pt \partopsep0pt}{}{}{}
-
-%\def\topfraction{.9}
-%\def\bottomfraction{.9}
-%\def\textfraction{.1}
-
-% making counters global
-\globalcounter{section}
-\globalcounter{figure}
-\globalcounter{table}
-
-% giving local \theCTR definition
-\definethecounter{footnote}{1}{\textit{\arabic{footnote}}}
-\definethecounter{subsection}{1}{%
- \texttt{\arabic{section}.\arabic{subsection}}}
-
-\let\AB\allowbreak
-
-\hyphenation{col-umn col-umns}
-
-\title{Package \textsf{paracol} User's Manual\\
- (version 0.91)}
-\author{Hiroshi Nakashima\\(Kyoto University)}
-\date{2011/09/16}
-
-
-
+\raggedbottom
\begin{document}
-\hbadness9000 \hfuzz6pt
-\maketitle
-\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 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
-\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
-
-\begin{verbatim}
-\end{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{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
-\|paracol| and the command \|\switchcolumn|. The \|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{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{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
-last column number and $n$ is the number of columns given to \|paracol|
-environment.
-
-
-
-\switchcolumn[0]*[\section{Column Synchronization}\label{sec:sync}]
-The \|\switchcolumn| command may also be followed by a `\|*|' to {\em
-synchronize} 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 multi-column text whose bottom is the vertical alignment
-points of the columns. For example, \|\section| commands in this manual are
-given as optional arguments of\break\|\switchcolumn*| like;
-\begin{Verbatim}
- \switchcolumn*[\section{Basic Usage}]
-\end{Verbatim}
-The \|paracol| environment may also start with a multi-column text by
-specifying it as the optional argument of \|\begin{paracol}|. For example,
-at the beginning of this document, the author put;
-\begin{Verbatim}
- \begin{paracol}[\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}]
-\subsection{Environment \texttt{column}}
-The \|\switchcolumn| is simple but you may prefer to pack the contents of a
-column in an environment. The \|column| environment is available for this
-well-structurization of \LaTeX{} sources for parallel columned documents. A
-construct;
-\begin{quote}
-\|\begin{column}|\\
-\textit{text for a column}\\
-\|\end{column}|
-\end{quote}
-is (almost) equivalent to;
-\begin{quote}
-\|\switchcolumn|\\
-\textit{text for a column}
-\end{quote}
-The \|column*| environment is also available for the column synchronization
-and may have an optional argument for multi-column text.
-\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 \|column|
-environment cannot do it. If you want to start $i$-th column, you have to
-do \|\beign{nthcolumn}{|$i$\|}| (or \|nthcolumn*| with an optional argument
-to synchronize).
-\end{nthcolumn}
-
-
-
-\begin{leftcolumn*}
-\subsection{Environment \texttt{leftcolumn} and\\\texttt{rightcolumn}}
-The environment \|leftcolumn| and \|rightcolumn| (and their starred
-versions with an optional argument) are available as more convenient means
-than saying \|\begin{nthcolumn}{0}| and \|\begin{nthcolumn}{1}|.
-
-\begin{figure*}
-\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]
-\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{%
- Environment \texttt{leftcolumn} and\\
- \texttt{rightcolumn}}
-The environment \|leftcolumn| and
-\|rightcolumn| (and their starred versions
-with an optional argument) are available as
-more convenient means than saying
-\|\begin{nthcolumn}{0}| and
-\|\begin{nthcolumn}{1}|.
-\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]
-\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}]
-\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) may be placed by \|figure*| and
-\|table*| environments as usual. A single-column figure\slash table will be
-placed in the column in which you put \|figure| and \|table|. For example,
-the contents of \|figure| environment in a \|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 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 synchronize columns.
-The rule is as follows; after you synchronize columns in a page, the page
-cannot have top-floats any more. When you synchronize columns,
-\textsf{paracol} fixes a virtual horizontal line in the page as the
-synchronization 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 \|figure| environments for the figures shown
-in the previous page into the \|leftcolumn*| and \|rigtcolumn| environment
-for the previous section.
-
-\subsection{Footnotes and Marginal Notes}
-Footnotes are also put at the bottom of the column in which \|\footnote|
-commands and their references (like this\footnote{%
-%
-An example of footnote.})
-%
-reside, as shown in page~2 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 just right of the column. Thus marginal notes
-of non-leftmost and non-rightmost columns will appear in the space
-separating columns rather than the margin of a page.}.
-
-\subsection{Local and Global Counters}
-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, sub-section numbering is local and the headings in right
-columns have typewriter-face numbers.
-
-This happens because the author declared the counters \|figure| and \|table|
-are \emph{global} in the preamble of this document by saying;
-\begin{itemize}\item[]%{
-\|\globalcounter{figure}|\\
-\|\globalcounter{table}|
-\end{itemize}%}
-and do nothing about \|footnote| and \|subsection| counters. By default,
-all the counters except for \|page| are local to columns. The value of a
-local counter of a column is saved somewhere when you leave the column, and
-it is restored when you revisit the column. The initial value of the
-local counters are the value they have at \|\begin{paracol}|. After you
-close the \|paracol| environment, the values of the left-most column are
-used for the rest of your document.
-
-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| or commands such as
-\|\caption| and \|\section|. Note that the value of a global counter
-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
-\|table| environment here to increment \|table| counter, the right-column
-table at the bottom of page~\pageref{tab:right} would be Table~3 because its
-\|table| environment does not appear yet in the source code.
-
-Another counter which the author made global in this documnet is
-\|section|. As explained in Section~\ref{sec:sync}, an optional
-multi-column text of column switching is considered as in the left-most
-column. Since \|\section| commands in this document are always multi-column
-texts, so far, it seems unnecessary to make \|section| global because it is
-incremented correctly in the left-most column. However, the stepping
-\|section| has a side effect to reset its decendent counter \|subsection|
-and referred from \|\thesubsection| command. Thus if \|section| were local,
-the right-column sub-sections in Section~\ref{sec:env} would be numbered as
-``0.1'', ``0.2'' and ``0.3'' because the local value of \|section| would be
-zero. Moreover, the right-column sub-sections of this section would be
-``0.4'', ``0.5'' and ``0.6'' because stepping \|section| local to
-left-columns would not reset \|subsection| local to right-columns.
-
-You may give a local appearance to a counter \textit{ctr} for the $i$-th
-column (zero origin) by a command;
-\begin{itemize}\item[]%
- \|\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
-\|\thesubsetion| 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]
-\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.}. ...}
-
-\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 (like this\footnote{%
-An example of footnote.}) reside, 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
-\end{Verbatim}
-\|note in this page\footnote{...}. ...|%
-\marginpar{\raggedright\ttfamily
-Another example of marginal note.}
-
-\begin{figure}[h]%{
-\centerline{\begin{tabular}[b]{|c|}\hline
- \hbox to.9\columnwidth{}\\\\
- \ttfamily a figure with [h] option\\
- \ttfamily to fill space\\
- \\\\\hline
- \end{tabular}}
-\caption{\ttfamily
-A Figure with [h] Option}
-\end{figure}%}
-
-\begin{figure}[b]%{
-\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}%}
-
-\begin{figure}[p]%{
-\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]%{
-\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]%{
-\centerline{\begin{tabular}[b]{|c|}\hline
- \hbox to.9\columnwidth{}\\\\\\\\
- \ttfamily yet another a figure with [p]\\
- \ttfamily option to fill space
- \\\\\\\\\hline
- \end{tabular}}
-\caption{\ttfamily
-Yet Another Figure with [p] 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*}
-\end{Verbatim}
-\textit{source}.
-
-\begin{figure}[t]%{
-\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}%}
-\end{rightcolumn}
-\end{paracol}
-
-
-
-\section{Closing \texttt{paracol} Environment and Page Flushing}
-The final example shown here is this single-column text which the author put
-after \|paracol| environment is closed. As you are seeing, \|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 affects the layout of the right column.
-
-To flush all columns in a page, a command \|\flush|\AB\|page| is available.
-This command in $i$-th column is almost equivalent to;
-\begin{itemize}\item[]%{
-\|\switchcolumn[|$i$\|]*[\newpage]|
-\end{itemize}%}
-but more robust\footnote{%
-%
-For example \texttt{\string\switchcolumn*} may flush a page for the
-synchronization and thus \texttt{\string\newpage} may leave an empty page.}.
-%
-The ordinary page breaking command \|\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{leftcolumn}
-The environment may also be restarted
-anywhere you like as shown here. ...
-\end{leftcolumn}
-\end{Verbatim}
-\textit{source}
-\end{rightcolumn}
-
-\begin{leftcolumn}
-Now the aurthor will do \|\flushpage| shortly to start a real binlingual
-example from the next page. O.K., now!!\flushpage
-\end{leftcolumn}
-
-
-
-\newenvironment{Gverse}{\begin{leftcolumn*}%[\centerline{\hrulefill}]
- \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}\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, this footnote
-would say ``This part was added by Beethoven.'' in German.}.
-\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.}.
-\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 brothere\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}
-%\flushpage
-\begin{Gverse}
-Freude trinken alle Wesen
-an den Br\"usten der Natur;\\
-Alle Guten, all 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}
-
-
-
-\section*{Acknowledgements}
-The author thanks to Yacine Daddi Addoun who gave the author the motivation
-to write the style for his bilingual document. He also thanks to Robin
-Fairbairns who kindly invited the style to CTAN after the author's lazy six
-years failing to upload the style.
+\DocInput{paracol.dtx}
\end{document}