missed commit

git-svn-id: svn://tug.org/texlive/trunk@38621 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 448 insertions, 0 deletions

diff --git a/Master/texmf-dist/source/latex/paracol/ppts.dtx b/Master/texmf-dist/source/latex/paracol/ppts.dtx
new file mode 100644
index 00000000000..311a1efda13
--- /dev/null
+++ b/Master/texmf-dist/source/latex/paracol/ppts.dtx
@@ -0,0 +1,448 @@
+% \marginparpush5pt \@mparswitchtrue
+% \section{Two-Sided Typesetting and Parallel-Paging}
+% \label{sec:ppts}
+% \changes{v1.3-2}{2013/09/17}
+%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}

+% \changes{v1.3-4}{2013/09/17}
+%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}

+% \changes{v1.3-5}{2013/09/17}
+%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}

+% 
+% This and the next section are typeset with \Uidx{\!\twosided!} enabling
+% features |p|, |c| and |m| and also |b| for a part of the next section.
+% The effect of |p| feature can be seen by the left side, or in other word
+% inside, margin of this odd-numbered page is narrower than that of the
+% previous pages because the author reduced the effective left side margin
+% being $\!\oddsidemargin!+1\,|in|$ by 75\,\%\footnote{

+% 

+% This document itself does not have |twoside| option in its
+% \!\documentclass! but the inconsistency between the option and
+% \!\twosided! is not visible because \!\pagestyle! is |plain|.}.
+% 

+% This setting makes the right side or outside margin of this page enlarged
+% by 125\,\% as well as the left side and outside margin of the next
+% even-numbered page.
+% 
+% Next, we see the effects of |c| and |m| features by the \env{paracol}
+% environment below for which \Uidx{\!\columnratio!}|{0.6}| and
+% \Uidx{\!\marginparthreshold!}|{0}| are declared to make the \emph{inside}
+% columns (left ones in odd-numbered pages) are wider than the
+% \emph{outside} ones and all marginal notes go to outside (right in
+% odd-numbered pages) margins.
+% 

+% \columnratio{0.6}\marginparthreshold{0}
+% 

+% \par\Hrule
+% \begin{paracol}{2}
+% \switchcolumn
+% \footnotetext*{Since the author is temporarily disabling the warning from
+% marginal note placement mechanism of \LaTeX, pushing down the second
+% marginal note from column-1 is silently performed when you process this
+% document.}
+% \switchcolumn
+% This line\Marginpar{First marginal note from column-0.} of the first
+% paragraph of the inside column-0 has a marginal note.  Now the author puts
+% a few dummy lines to keep a space below the marginal note.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% This line\Marginpar{Second marginal note from column-0.} of the second
+% paragraph of the inside column-0 also has a marginal note.  Now the author
+% puts a few dummy lines again but this time to go down to the bottom of the
+% page.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% This is the third paragraph of the inside column-0 having a page break in
+% it.  Since shortly we will be in an even-numbered page
+% \pageref{page:ppts2} (now), this wider column\Marginpar{Third marginal
+% note from column-0} is now right one keeping it
+% inside, while the marginal note given in the first line of this page goes
+% to left and outside.  Now we will have a \!\switchcolumn! below this
+% paragraph to go to the column-1 and back to the previous page
+% \pageref{sec:ppts}.\label{page:ppts2}
+% \switchcolumn
+% \it
+% This is the first paragraph in the narrower, italicized and outside
+% column-1.  In this paragraph, we shortly have a marginal note, italicized
+% too, which goes to the outside margin shared by all marginal notes from
+% both columns.\Marginpar{\it First marginal note from column-1.}  The
+% marginal note given here is placed its natural position and its first line
+% is aligned to the first line of the second sentence of this paragraph by
+% exploitation of the space between two marginal notes from the column-0,
+% though we already have had three notes from the column.
+% 
+% Now\Marginpar{\it Second marginal note from column-1.} the author puts
+% another marginal note whose first line would be aligned to that of this
+% paragraph, but it is pushed down below the second marginal note from the
+% column-0 because two notes conflict with each other over the
+% space\footnotemark*[+0].  Note that since the note from this column is given
+% \emph{after} that from the column-0 was given, the conflict is solved
+% pushing the note from this column down rather than that from the
+% column-0.  Now the author puts a few dummy lines to go to the second last
+% line of this page.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\par
+% 
+% This is the third paragraph of the outside column-1, which becomes left
+% shortly by the page break.\Marginpar{\it Third marginal note from
+% column-1.}  The third marginal note is given in the first line of this
+% page, but it is pushed down again due to the conflict with the note from
+% the column-0.
+% \end{paracol}
+% \Hrule
+% 
+% Note that the position of the last marginal note in the \env{paracol}
+% \Marginpar{Marginal note given after \env{paracol} environment is closed.}
+% environment which we just have closed affects the marginal note placement
+% in \postenv.  For example, the marginal note given in the first line of
+% this paragraph is pushed down.
+% 
+% From the next page, we will see a few examples of \parapag{}ing.
+% 
+% 
+% 
+% \newpage
+% \subsection{Example of Paired Parallel-Paging}
+% \label{sec:ppts-paired}
+% 
+% Shortly we will start a \env{paracol} environment by \beginparacol|[2]{4}|
+% having four columns but two for each of left and right \paired{}
+% \parapag{}es.  Since the author declares \!\columnratio!|{0.6}[0.5]|, the
+% columns in left pages are made unbalanced while those in right pages are
+% balanced.
+% 

+% \columnratio{0.6}[0.5]
+% \par\Hrule
+% \begin{paracol}[2]{4}
+% This is the first paragraph of the leftmost column-0,
+% \Marginpar{Marginal note from column-0.}
+% whose first line has a marginal note placed in the right margin because
+% the setting of \!\marginparthreshold! being 0 is still effective and we
+% are in the odd-numbered page \pageref{sec:ppts-paired}.  Now we
+% have a \!\switchcolumn! to the next column-1.
+% 
+% \switchcolumn
+% \begin{Hfuzz}{1.1pt}\it
+% This is the first paragraph of the second and right column-1 in the left
+% \parapag{}e.  We shortly give an italicized mar\-gin\-al note carefully, so
+% that it does not conflict with the marginal note from the column-0.
+% \Marginpar{\it Marginal note from column-1.}
+% That is, now the author puts the note.  Now we
+% have a \!\switchcolumn! to the next column-2.
+% \end{Hfuzz}
+% \footnotetext*{This footnote is put in the left \parapag{}e together with
+% another footnote below given in the column-2 in the right \parapag{}e.
+% \label{fn:ppts-paired1}}
+% 
+% \switchcolumn
+% \begingroup\sf
+% This is the first paragraph of the column-2 being the left column of the
+% right \parapag{}e.  Though we are in a page different from that column-0
+% and 1 reside in, this page is still numbered \pageref{sec:ppts-paired}
+% because the left and right page is \paired.  Therefore, the left margin of
+% this page is narrower than the right margin because the page number is
+% odd.
+% 

+% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e
+% though it is given in the column-2 in the right \parapag{}e and thus its
+% reference is in the column, of course.\label{fn:ppts-paired2}}
+% 
+% You have to notice
+% \Marginpar{\sf Marginal note from column-2.}
+% the first paragraph does not start from the page top
+% but above it we have some space of exactly same size as the \preenv{}
+% shown in the left \parapag{}e.  Therefore, the top of the first paragraphs
+% in all columns are aligned.  The marginal note given in the first line of
+% this paragraph goes to the right margin of this page because of the
+% \!\marginparthreshold! setting and the parity of this page.  Now we have a
+% \!\switchcolumn! to the next column-3.
+% \par\endgroup
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+%     \hbox to.9\textwidth{}\\
+%     \sf page-wise figure given in column-2\\
+%     \\\hline
+%     \end{tabular}}
+% \caption{A Page-Wise Figure}
+% \end{figure*}
+% 
+% \switchcolumn
+% \begingroup\sl
+% This is the first paragraph
+% \Marginpar{\sl Marginal note from column-3.}
+% in the last rightmost column-3 whose width is equal to that of the column-2.
+% The marginal note given in the first line goes to right and does not
+% conflict with that from the column-2.  We are now going back to the
+% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext.
+% \endgroup
+% 
+% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the
+% page width, this text does not span the boundary between the left and
+% right parallel-pages.}]
+% 
+% We have come back to this column-0.  The space above the \mctext{} is due
+% to the \sync{}ation because two paragraphs in the column-2 are
+% significantly taller in total than the paragraphs in other columns.  As
+% the spanning text itself says, it cannot extend to the right \parapag{}e.
+% The author puts dummy lines to go to the page bottom.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% Now we will have a page break shortly.  You could be surprised by seeing
+% this column is not in the left \parapag{}e after the break but in the
+% right one.  This is because the feature |c| is enabled to swap not only
+% columns in a page but also the left and right \paired{} \parapag{}es when
+% they are even-numbered.  The other feature |p| makes the left outside
+% margins of this right and the previous left pages wider than the right
+% inside margins.\label{page:ppts-paired2}
+% 
+% \switchcolumn
+% \begingroup\it
+% We have restarted this column-1.  This paragraph has a
+% footnote\footnotemark*[-1] as shown below.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\par
+% 
+% After the page break below, this column also goes to the right page
+% together with the column-0
+% \Marginpar{\it Another marginal note from column-1.}
+% and is placed outside (left) in the page, as well as the marginal note
+% in this right page but in the outside margin.
+% \par\endgroup
+% 
+% \switchcolumn
+% \begingroup\sf
+% We have a few other materials not shown in right \parapag{}es.  The space
+% above this paragraph is for the \mctext{} placed in the left \parapag{}e.
+% The \Scfnote{} given here\footnotemark{} is also not in this page but in
+% the left.  Finally, the author has put a page-wise figure spanning columns
+% just before \!\switchcolumn! by which we left this column, but it will be
+% in the right page \pageref{page:ppts-paired2} together with column-0 and
+% 1.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% Though the footnote numbered \ref{fn:ppts-paired2} goes to the left page,
+% its space and that of \ref{fn:ppts-paired1} make this and the next columns
+% shorter in the previous page.  Similarly, we have a space above for the
+% page-wise figure shown in the right page.
+% \par\endgroup
+% 
+% \switchcolumn
+% \begingroup\sl
+% As expected, this line is aligned to the first line of the paragraph in
+% the column-2 as well as those in column-0 and 1.  It is also consistent
+% the first lines including that of this paragraph are not indented because
+% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first
+% paragraphs unindented.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
+%
+% After the page break we will have shortly, this column becomes the
+% leftmost in the left \parapag{}e, as you are seeing now,
+% \Marginpar{\sl Another marginal note from column-3.}
+% but still outermost as well as the marginal note in the outside left
+% margin.
+% \endgroup
+% \end{paracol}
+% \Hrule
+% 
+% Now you are seeing yet another material placed only in the page in which
+% the column-0 resides and thus being the right page now, i.e., this
+% paragraph and the next one in the \postenv.  You might be disappointed by
+% the fact the \emph{outside} pages, i.e., left in this page
+% \pageref{page:ppts-paired2} and right in the previous page
+% \pageref{sec:ppts-paired}, cannot have \pwstuff{} but it is what the
+% author can do now for the version 1.3 and thus you have to wait some
+% future versions in which the author could devise a mechanism to exploit
+% the corresponding space in the pages\footnote{

+% 

+% You might complain the immaturity of \parapag{}ing and might claim that it
+% should be included in \Paracol{} after the author implements the
+% mechanism.  In fact the author himself is frustrated current features of
+% \parapag{}ing but he dared to release the version 1.3 knowing that there
+% are people who happily typeset their \parapag{}ed documents with the
+% current limited features.}.
+% 

+% In addition, you might think it is weird that the |c| feature of
+% \!\twosided! swaps columns \emph{and} paired pages.  However this swapping
+% is a natural consequence of the combination of \cswap{} and \paired{}
+% \parapag{}ing.  Therefore, you can simply disable the |c| feature (maybe
+% together with other features) to have more intuitive results.
+% 
+% In the next Section~\ref{sec:ppts-npaired}, you will see another kind of
+% \parapag{}ing namely \npaired{} one.  Before that, we need a blank page to
+% let the \npaired{} \parapag{}ing start from an even-numbered page so that
+% a left and right page pair comprises a double spread.  A short remark on
+% the blank next page is that it does not have a right counterpart
+% \parapag{}e because the page is outside \env{paracol} environments and does
+% not have any portion from the environments\footnote{

+% 

+% To illustrate this fact, the author dares to put a real blank page rather
+% than stepping the \counter{page} counter.}.
+% 

+% \newpage\vspace*{\fill}\centerline{(intentionally blanked page)}\vfill
+% 
+% 
+% 
+% \newpage
+% \subsection{Example of Non-Paired Parallel-Paging}
+% \label{sec:ppts-npaired}
+% 
+% This and following three pages are to show an example of \npaired{}
+% \parapag{}ing, in which the author keeps the setting of \!\twosided!,
+% \!\columnratio! and \!\marginparthreshold! unchanged.
+% The arguments of \beginparacol{} for column population are also unchanged
+% to have $2+2$ configuration, but the first argument is followed by |*| for
+% \npaired{} typesetting.  That is, the environment below starts by
+% \beginparacol|[2]*{4}|.  The contents of the environment is also almost
+% same as the previous Section~\ref{sec:ppts-paired}, while
+% \Emph{bold-faced} words show the difference from the \paired{}
+% typesetting.
+% 

+% \columnratio{0.6}[0.5]
+% \par\Hrule
+% \begin{paracol}[2]*{4}
+% This is the first paragraph of the leftmost column-0,
+% \Marginpar{Marginal note from column-0.}
+% whose first line has a marginal note placed in the \Emph{left} margin
+% because the setting of \!\marginparthreshold! being 0 is still effective
+% and we are in the \Emph{even}-numbered page
+% \Emph{\pageref{sec:ppts-npaired}}.  Now we have a \!\switchcolumn! to the
+% next column-1.
+% 
+% \switchcolumn
+% \begingroup\it
+% This is the first paragraph of the second and right column-1 in the left
+% \parapag{}e.  We shortly give an italicized mar\-gin\-al note carefully, so
+% that it does not conflict with the marginal note from the column-0.
+% \Marginpar{\it Marginal note from column-1.}
+% That is, now the author puts the note.  Now we
+% have a \!\switchcolumn! to the next column-2.
+% \par\endgroup
+% \footnotetext*{This footnote is put in the left \parapag{}e together with
+% another footnote below given in the column-2 in the right \parapag{}e.
+% \label{fn:ppts-npaired1}}
+% 
+% \switchcolumn
+% \begingroup\sf\label{page:ppts-npaired1r}
+% This is the first paragraph of the column-2 being the left column of the
+% right \parapag{}e.  \Emph{Since we are in the page next to} that column-0
+% and 1 reside in, this page is numbered \Emph{\pageref{page:ppts-npaired1r}}
+% because the left and right page is \Emph{\npaired}.  Therefore, the left
+% margin of this page is narrower than the right margin because the page
+% number is odd.
+% 

+% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e
+% though it is given in the column-2 in the right \parapag{}e and thus its
+% reference is in the column, of course.\label{fn:ppts-npaired2}}
+% 
+% You have to notice
+% \Marginpar{\sf Marginal note from column-2.}
+% the first paragraph does not start from the page top
+% but above it we have some space of exactly same size as the \preenv{}
+% shown in the left \parapag{}e.  Therefore, the top of the first paragraphs
+% in all columns are aligned.  The marginal note given in the first line of
+% this paragraph goes to the right margin of this page because of the
+% \!\marginparthreshold! setting and the parity of this page.  Now we have a
+% \!\switchcolumn! to the next column-3.
+% \par\endgroup
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+%     \hbox to.9\textwidth{}\\
+%     \sf page-wise figure given in column-2\\
+%     \\\hline
+%     \end{tabular}}
+% \caption{A Page-Wise Figure}
+% \end{figure*}
+% 
+% \switchcolumn
+% \begingroup\sl
+% This is the first paragraph
+% \Marginpar{\sl Marginal note from column-3.}
+% in the last rightmost column-3 whose width is equal to that of the column-2.
+% The marginal note given in the first line goes to right and does not
+% conflict with that from the column-2.  We are now going back to the
+% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext.
+% \endgroup
+% 
+% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the
+% page width, this text does not span the boundary between the left and
+% right parallel-pages.}]
+% 
+% We have come back to this column-0.  The space above the \mctext{} is due
+% to the \sync{}ation because two paragraphs in the column-2 are
+% significantly taller in total than the paragraphs in other columns.  As
+% the spanning text itself says, it cannot extend to the right \parapag{}e.
+% The author puts dummy lines to go to the page bottom.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\par
+% 
+% Now we will have a page break shortly.  You \Emph{will not} be surprised
+% by seeing this column \Emph{is still in the left \parapag{}e after the
+% break.}  This is because the feature |c| is \Emph{not effective in
+% \npaired{} \parapag{}ing.}  The other feature |p| \Emph{consistently makes
+% the left outside margins of this and the previous page in which this
+% column resides} wider than the right inside margins.
+% \label{page:ppts-npaired2}
+% 
+% \switchcolumn
+% \begingroup\it
+% We have restarted this column-1.  This paragraph has a
+% footnote\footnotemark*[-1] as shown below.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% After the page break below, this column also \Emph{stays in the left page}
+% together with the column-0
+% \Marginpar{\it Another marginal note from column-1.}
+% and is placed \Emph{inside (right)} in the page, as well as the marginal
+% note in this \Emph{left} page \Emph{still} in the outside margin.
+% \par\endgroup
+% 
+% \switchcolumn
+% \begingroup\sf
+% We have a few other materials not shown in right \parapag{}es.  The space
+% above this paragraph is for the \mctext{} placed in the left \parapag{}e.
+% The \Scfnote{} given here\footnotemark{} is also not in this page but in
+% the left.  Finally, the author has put a page-wise figure spanning columns
+% just before \!\switchcolumn! by which we left this column, but it will be
+% in the \Emph{left} page \Emph{\pageref{page:ppts-npaired2}} together with
+% column-0 and 1.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
+% 
+% Though the footnote numbered \Emph{\ref{fn:ppts-npaired2}} goes to the
+% left page, its space and that of \Emph{\ref{fn:ppts-npaired1}} make this
+% and the next columns shorter in the previous page.  Similarly, we have a
+% space above for the page-wise figure shown in the \Emph{left} page.
+% \par\endgroup
+% 
+% \switchcolumn
+% \begingroup\sl
+% As expected, this line is aligned to the first line of the paragraph in
+% the column-2 as well as those in column-0 and 1.  It is also consistent
+% the first lines including that of this paragraph are not indented because
+% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first
+% paragraphs unindented.\\
+% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
+% \Dotfill\\ \Dotfill\par
+%
+% After the page break we will have shortly, this column \Emph{is kept being
+% the rightmost in the right \parapag{}e}, as you are seeing now,
+% \Marginpar{\sl Another marginal note from column-3.}
+% \Emph{and} still outermost as well as the marginal note in the outside
+% \Emph{right} margin.
+% \endgroup
+% \end{paracol}
+% \Hrule
+% 
+% As the \postenv{} in Section~\ref{sec:ppts-paired} is, this paragraph
+% being the \postenv{} of the \npaired{} \parapag{}es appears only in the
+% \parapag{}e in which the column-0 belongs to, and thus in the left
+% \parapag{}e in this case.
+% \endinput