summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/paracol/bgpaint.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/paracol/bgpaint.dtx')
-rw-r--r--macros/latex/contrib/paracol/bgpaint.dtx601
1 files changed, 601 insertions, 0 deletions
diff --git a/macros/latex/contrib/paracol/bgpaint.dtx b/macros/latex/contrib/paracol/bgpaint.dtx
new file mode 100644
index 0000000000..ac79f4e9a9
--- /dev/null
+++ b/macros/latex/contrib/paracol/bgpaint.dtx
@@ -0,0 +1,601 @@
+% \backgroundcolor{t}[rgb]{0.7,0,0}
+% \backgroundcolor{b}[rgb]{0.8,0.6,0}
+% \backgroundcolor{l}[rgb]{0,0,0.7}
+% \backgroundcolor{r}[rgb]{0,0.7,0}
+% \backgroundcolor{c[0]}[rgb]{1,0.8,1}
+% \backgroundcolor{c[1]}[rgb]{1,1,0.8}
+% \backgroundcolor{g}[rgb]{0.8,1,1}
+% \backgroundcolor{f}[rgb]{0.8,0,1}
+% \backgroundcolor{n}[rgb]{0.8,0.6,1}
+% \backgroundcolor{p}[rgb]{0.8,1,0.6}
+% \backgroundcolor{s}[rgb]{0.8,0.8,0.8}
+% \pagerim5pt
+%
+% \section{Examples of Background Painting}
+% \label{sec:bgpaint}
+% \subsection{Fundamental Painting}
+% \label{sec:bgpaint-fund}
+% \twosided[pcm]
+%
+% As you undoubtedly notice, this page and a few pages following it are
+% colorfully painted. For this and the next three pages, the author
+% declared the \bground{} color of each region as follows.
+% 
+% \begin{itemize}\item[]
+% |\backgroundcolor{t}[rgb]{0.7,0,0} % dark red for top margin|\\
+% |\backgroundcolor{b}[rgb]{0.8,0.6,0} % dark orange for bottom margin|\\
+% |\backgroundcolor{l}[rgb]{0,0,0.7} % dark blue for left margin|\\
+% |\backgroundcolor{r}[rgb]{0,0.7,0} % dark green for right margin|\\
+% |\backgroundcolor{c[0]}[rgb]{1,0.8,1} % pink for colunmn-0|\\
+% |\backgroundcolor{c[1]}[rgb]{1,1,0.8} % cream yellow for column-1|\\
+% |\backgroundcolor{g}[rgb]{0.8,1,1} % light blue for the gap|\\
+% |\backgroundcolor{f}[rgb]{0.8,0,1} % purple for page-wise floats|\\
+% |\backgroundcolor{n}[rgb]{0.8,0.6,1} |
+% |% light purple for page-wise footnotes|\\
+% |\backgroundcolor{p}[rgb]{0.8,1,0.6} |
+% |% pale green for pre/post-environment|\\
+% |\backgroundcolor{s}[rgb]{0.8,0.8,0.8} % light gray for spanning texts|
+% \end{itemize}
+% 
+% \SpecialUsageIndex{\backgroundcolor}
+% 
+% Therefore, the \bground{} of this |p|re-environment paragraph and other
+% stuff above is painted by pale green.
+% 
+% \Index{pre-environment stuff}
+% 
+% Since the author set \Uidx{\!\pagerim!} to be 5\,|pt|, you will see
+% unpainted strips of 5\,|pt| wide at all paper edges surrounding painted
+% regions. For this and the next three pages, \Uidx{\!\twosided!}|[pcm]| is
+% declared to enable |p|, |c| and |m| features but to disable the |b|
+% feature. Therefore, though this page \pageref{sec:bgpaint} is even and
+% thus the left outside margin is wider than the right inside one, the
+% \bground{}s of |l|(eft) and |r|(ight) margins are painted by dark blue and
+% dark green respectively.
+% \par\bigskip
+% 
+% \begin{paracol}{2}
+% This column-0 is now right and inside because of the |c| feature of
+% \!\twosided! is enabled. On the other hand, the \bground{} is this column
+% is painted by pink because \!\backgroundcolor! for |c[0]| specifies so.
+% That is, the column ordinals optionally given to |c|(olumn) (and |g|(ap))
+% regions are \emph{logical} ones not always corresponding to their
+% \emph{physical} positions in a page.
+%
+% \switchcolumn
+% \begingroup\it
+% As explained in the right column-0, the \bground{} of this left and
+% outside column-1 is painted by cream yellow as
+% {\rm\!\backgroundcolor!|{c[1]}|} specifies. Now we have a
+% {\rm\!\switchcolumn!|*|} with a \mctext{} to show the \bgpaint{} for
+% it\footnote{
+% 
+% Since the footnotes in this \env{paracol} environment are \scfnote{} and
+% \mgfnote{}, and \!\backgroundcolor!\texttt{\char`\{n\char`\}} specifies
+% light purple, the \bground{} of this (foot)|n|(ote) region is painted by
+% the color.}.
+% 
+% \par\endgroup
+% \switchcolumn*[\subsection*{The background of this |s|(panning text)
+% region is painted by light gray}\medskip]
+%
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\textwidth{}\\
+% \texttt{f}(loat) region for this page-wise figure is painted by purple\\
+% \\\hline
+% \end{tabular}}
+% \caption{A Page-Wise Figure}
+% \end{figure*}
+%
+% This paragraph is to show how the first line of a paragraph just below a
+% \mctext{} is placed in the painted region.
+% \par\vfill
+%
+% \switchcolumn
+% \begingroup\it
+% See the right column for the reason why this paragraph is here.
+% \par\vfill
+%
+% See the right column for what we are now doing.
+% \par\endgroup
+% \switchcolumn
+%
+% Now we have a \!\flushpage! to see the \bgpaint{} for a material not shown
+% in the page, i.e., a page-wise float.
+% \flushpage
+%
+% Since we are now in an odd-numbered page \pageref{page:bgpaint2}, this
+% column-0 is now a left one and is still painted by pink of course.
+% \par\vfill\label{page:bgpaint2}
+%
+% This paragraph is to show how the last line of a page without \Scfnote{}s
+% is placed in the painted region.
+% \par\newpage
+%
+% This page is to show how the page without any \pwstuff{} looks like.
+% \par\vfill
+%
+% Shortly we will close this \env{paracol} environment in the next page.
+% \par\newpage
+%
+% Now we are closing this \env{paracol} environment to show how its
+% \postenv{} is painted.
+%
+% \switchcolumn
+% \begingroup\it
+% As expected, the \bground{} of this column-1 is still painted by cream
+% yellow.
+% \par\vfill
+%
+% See the comment in the left column.
+% \par\newpage
+%
+% See the right column for the reason why we have this almost blank page.
+% \par\vfill
+%
+% See the right column for what will happen shortly.
+% \par\newpage
+%
+% See the left column for the reason why we are now closing the environment.
+% \endgroup
+% \end{paracol}
+% \bigskip
+% 
+% The \bground{} of this paragraph in |p|(ost-environment) region is also
+% painted by pale green, because \postenv{} can be \preenv{} at the same
+% time as we see shortly. \par\bigskip
+%
+% \begin{paracol}{2}
+% This short \env{paracol} environment illustrates how the \preenv{} of this
+% environment, or the \postenv{} of the last environment in other words, is
+% painted.
+%
+% \switchcolumn
+% \begingroup\it
+% Therefore, the author does not have much to say in this column, except for
+% giving a footnote here\footnote{
+% 
+% Since this footnote is \mgfnote{} with that in the \postenv{}, it is
+% considered as a part of \postenv{} and thus painted by pale green rather
+% than light purple.\label{fn:bgpaint1}}.
+% \endgroup
+% \end{paracol}
+% \bigskip
+%
+% Before moving to the next example, one caution is given for \bgpaint{} of
+% \Mgfnote{}s. As the footnote \ref{fn:bgpaint1} itself says, \Mgfnote{}s
+% given in the \lpage{} of a \env{paracol} environment are considered as
+% belonging to \postenv{}. Therefore, the footnote \ref{fn:bgpaint1} is
+% painted by pale green as well as another footnote given now\footnote{
+% 
+% Since this footnote really belongs to \postenv{}, its \bground{} is painted
+% by pale green naturally.}.
+% \par\label{page:bgpaint4}
+%
+%
+%
+% \newpage
+% \backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0}
+% \backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0}
+% \backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7}
+% \backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0}
+% \backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1}
+% \backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8}
+% \backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1}
+% \backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1}
+% \backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1}
+% \backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6}
+% \backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8}
+%
+% \subsection{Mirrored Painting and Enlarging/Shrinking/Shifting Regions}
+% \label{sec:bgpaint-me}
+% \twosided
+%
+% At a glance, this and the next three pages look painted similarly to
+% previous four pages, but by a careful examination you should notice
+% two important differences. The first one is found in the colors
+% of left and right margins. As the author enabled all features of
+% \Uidx{\!\twosided!} including |b| for \mirror{}ing and we are now in an
+% even-numbered page \pageref{sec:bgpaint-me}, the left and outside margin
+% is painted by dark green for the region |r|(ight margin), while the right
+% and inside one is painted by dark blue for |l|(eft margin).
+%
+% The other is that regions are enlarged, shrunk or shifted by 4\,|pt| by
+% the following \!\backgroundcolor! commands with extensions.
+% 
+% \begin{itemize}\item[]
+% |\backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0} |
+% |% B up|\\
+% |\backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0} |
+% |% T down|\\
+% |\backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7} |
+% |% R left T/B outside|\\
+% |\backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0} |
+% |% L right T/B outside|\\
+% |\backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1} |
+% |% all edges outside|\\
+% |\backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8} |
+% |% all edges outside|\\
+% |\backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1} |
+% |% L/R inside & T/B outside|\\
+% |\backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1} |
+% |% L/R outside & T/B up|\\
+% |\backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1} |
+% |% L/R outside & T/B down|\\
+% |\backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6} |
+% |% all edges outside|\\
+% |\backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8} |
+% |% L/R outside & T/B inside|
+% \end{itemize}
+% 
+% \SpecialUsageIndex{\backgroundcolor}
+% 
+% In the comments above, |L|(eft), |R|(ight), |T|(op) and |B|(ottom) mean
+% edges moved by a given extension. Therefore, for example,
+% ``|L/R outside & T/B up|'' for |f|(loat) region means it is enlarged
+% horizontally and shifted up vertically by the asymmetric extension
+% |(4pt,4pt)(4pt,-4pt)|. These a little bit complicated setting of
+% extensions are to solve the problems in the fundamental example shown in
+% previous four pages, namely too strict definition of the regions to be
+% painted. That is, both vertical edges of regions having texts, e.g.,
+% |c|(olumn) regions, should look too close to the first and last letters.
+% Similarly both horizontal edges of those regions seem too close especially
+% when the first line is tall (e.g., the section title in
+% p.\Tie\pageref{sec:bgpaint} and the page-wise figure in
+% p.\Tie\pageref{page:bgpaint2}) and the last line of a column is followed by
+% \mctext{} or \postenv. Therefore, the author made fine tuning moving
+% inside edges of margins outside, and so on. We will come back this issue
+% after exemplifying the effect of the tuning.
+% \par\bigskip
+% 
+% \advance\skip\footins4pt\relax
+% \begin{paracol}{2}
+% By the tuning to enlarge this |c|(olumn) region, this paragraph has
+% comfortable spaces above and below it, as well as at the both side edges.
+%
+% \switchcolumn
+% \begingroup\it
+% This paragraph is surrounded by spaces of a small but comfortable amount as
+% well.\footnote{
+% 
+% Shifting this (foot)|n|(ote) region down a little bit, the space below this
+% footnote and above the top edge of the |b|(ottom margin) region is enlarged.}.
+% 
+% \par\endgroup
+% \switchcolumn*[\subsection*{The background of this |s|(panning text)
+% region is painted by light gray and enlarged horizontally but shrunk
+% vertically}\par\medskip]
+%
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\textwidth{}\\
+% shifting up this \texttt{f}(loat) region gives us a small space above
+% the top edge of the rectangle\\
+% \\\hline
+% \end{tabular}}
+% \caption{A Page-Wise Figure}
+% \end{figure*}
+%
+% This paragraph is to show how well the first line of a paragraph just below a
+% \mctext{} is separated from the boundary of two painted regions.
+% \par\vfill
+%
+% \switchcolumn
+% \begingroup\it
+% See the right column for the reason why this paragraph is here.
+% \par\vfill
+%
+% See the right column for what we are now doing.
+% \par\endgroup
+% \switchcolumn
+%
+% By enlarging this |c|(olumn) region and shift the (foot)|n|(ote) region
+% down, this paragraph has a comfortable amount of space below it.
+% \flushpage
+%
+% Similarly to other paragraphs below \pwstuff, this paragraph is well
+% separated from the bottom edge of the |f|(loat) region above.
+%
+% \par\vfill\label{page:bgpaint-me2}
+%
+% As in the case of the line above \Scfnote{}s, the last line of this
+% paragraph has a sufficient space separating it from the top edge of the
+% |b|(ottom margin) region.
+% \par\newpage
+%
+% This page is to show how the page without any \pwstuff{} looks like. As
+% you are seeing, the space above this paragraph is sufficient and
+% comfortable.
+% \par\vfill
+%
+% Shortly we will close this \env{paracol} environment in the next page.
+% \par\newpage
+%
+% Now we are closing this \env{paracol} environment to show how this
+% paragraph is separated from the boundary of |c|(olumn) and
+% |p|(ost-environment) regions.
+%
+% \switchcolumn
+% \begingroup\it
+% See the comment in the left column for the intention of placing this
+% paragraph here.
+% \par\vfill
+%
+% See the comment in the left column, too.
+% \par\newpage
+%
+% See the right column for the reason why we have this almost blank page.
+% \par\vfill
+%
+% See the right column for what will happen shortly.
+% \par\newpage
+%
+% See the left column for the reason why we are now closing the environment.
+% \endgroup
+% \end{paracol}
+% \bigskip
+% 
+% The \bground{} of this paragraph in |p|(ost-environment) region is
+% painted by pale green as done in p.\Tie\pageref{page:bgpaint4}, but its top
+% and bottom edges \emph{look} shifted down and up to give spaces below and
+% above the last and first paragraphs in \env{paracol} environments,
+% respectively.
+% \par\bigskip
+%
+% \begin{paracol}{2}
+% This short \env{paracol} environment illustrates how the \preenv{} of this
+% environment, or the \postenv{} of the last environment in other words, is
+% painted.
+%
+% \switchcolumn
+% \begingroup\it
+% Therefore, the author does not have much to say in this column, except for
+% giving a footnote here\footnote{
+% 
+% As the footnote \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1}, this
+% \Mgfnote{} is a part of \postenv{} and thus painted by pale green rather
+% than light purple.\label{fn:bgpaint-me1}}.
+% \endgroup
+% \end{paracol}
+% \bigskip
+%
+% In the setting with \!\backgroundcolor! commands in
+% p.\Tie\pageref{sec:bgpaint-me}, the author carefully moved contacting edges
+% of regions. For example, to enlarge |c|(olumn) regions, the inside edges
+% of |l|(eft margin) and |r|(ight margin) regions are moved outside, and both
+% vertical edges of the |g|(ap) region shifted toward its inside. As for
+% the horizontal edges, the bottom edges of |t|(op margin) and |f|(loat)
+% regions are moved up, the top edges of |b|(ottom margin) and
+% (foot)|n|(ote) regions are moved down, and both top and bottom edges of
+% the |s|(panning text) region are shifted toward its inside.
+%
+% These edge shifting could make a region too narrow or too much shifted
+% resulting in a material in it overreaching its boundary, especially in
+% vertical shifting of horizontal edges. However we can exploit some large
+% space automatically or manually inserted above and/or below the material
+% to avoid overreaching. That is the author exploited the following spaces;
+% \!\headsep! below the page head (though it is empty in this document);
+% \!\dbltextfloatsep! below the bottom-most page-wise float; spaces that
+% \!\subsection!|*| inserts above and below it together with manually
+% inserted \!\medskip! below it; \!\skip!\!\footins!\footnote{
+% 
+% This is a kind of ``length command'' maybe not widely known.}
+% 
+% above the first footnote which the author enlarged by 4\,|pt| temporarily
+% for this and the next subsections; and \!\footskip! from the bottom edge
+% of text area to that of the page number.
+%
+% Now you might notice that the explanation above does not mention the |p|
+% region for \Preenv{} and \postenv. As you should find in the settings,
+% this region is enlarged horizontally \emph{and vertically} so that its top
+% and bottom edges are moved up and down when the region is at the top or
+% bottom of a page, as you are seeing now and find in
+% p.\Tie\pageref{sec:bgpaint-me}. However, this enlargement of course has a
+% side effect that the region collides against |c|(olumn) and |g|(ap) regions
+% also enlarged vertically making them overlapped. This overlap will be
+% invisible with most of \emph{printers} because, as shown in
+% Section\Tie\ref{sec:ref-bgpaint}, |p| region is painted \emph{before} |c|
+% and |g| regions are painted. In addition, since relatively large spaces
+% of \!\bigskip! are manually inserted before each \beginparacol{} and after
+% each \Endparacol{}, texts in \Preenv{} and \postenv{} are well separated
+% from region boundaries.
+%
+% This overlay painting |c| and |g| over |p|, however, might produce an
+% unexpected result with some printer with which, for example, two colors
+% are \emph{blended} in the thin overlapped strip\footnote{
+% 
+% For example, a dvi previewer |dviout| produces such a blended result with
+% the default setting of coloring.}.
+% 
+% Unfortunately, this overlay painting is inevitable in the current version
+% 1.3, but in a future version, hopefully 1.4, more sophisticated
+% \emph{position-dependent} region definition, for example, to shift the top
+% edge of |p| region only when the region is at the top of page, could be
+% introduced.
+%
+% Another remark is that the \mirror{}ing specified by the |b| feature of
+% \!\twosided! works not only on the colors of side margins but also on
+% their asymmetric shrinkage. That is, the asymmetric shifts of vertical
+% edges of |l| and |r| regions correctly performed irrespective of their
+% physical positions, i.e., even when the |l| (resp.\ |r|) region is at
+% the right (resp.\ left) margin and the edge to be shift is the left
+% (resp.\ right) one rather than right (resp.\ left).
+%
+%
+%
+% \newpage \suppressfloats
+% \nobackgroundcolor{t}
+% \nobackgroundcolor{b}
+% \nobackgroundcolor{l}
+% \nobackgroundcolor{r}
+% \nobackgroundcolor{g}
+% \backgroundcolor{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1}
+% \backgroundcolor{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8}
+% \backgroundcolor{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1}
+% \backgroundcolor{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8}
+%
+% \subsection{Regions with Infinite Extensions}
+% \label{sec:bgpaint-inf}
+%
+% You are now seeing another \bgpaint{} much different from previous two
+% examples. That is, after disabling painting of |t|, |b|, |l|, |r| and |g|
+% regions by \Uidx{\!\nobackgroundcolor!}, the author gave the followings
+% for painting this and the next pages.
+% 
+% \begin{itemize}\item[]
+% |\backgroundcolor|
+% |{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1}|\\
+% |\backgroundcolor|
+% |{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8}|\\
+% |\backgroundcolor|
+% |{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1}|\\
+% |\backgroundcolor|
+% |{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8}|
+% \end{itemize}
+% 
+% \SpecialUsageIndex{\backgroundcolor}
+% 
+% The first two lines above is different from the previous declaration
+% because inside edges of |c[0]| and |c[1]| regions are shifted toward
+% outside of them and thus inside of unpainted |g| region so that the edges
+% are contacted. On the other hand, the last two lines are for
+% \emph{under-painting} of columns and has \emph{\bginfext} to make top,
+% bottom and outside edges of |C| regions reaching to the corresponding
+% paper edges. Since this under-painting is done with colors same as those
+% of over-painting of |c| regions, you will have an impression that the
+% paper is two-toned and \pwstuff{} are pasted on the paper\footnote{
+% 
+% This footnote is given outside \env{paracol} environment but its
+% \bground{} is painted by light purple because it is merged with the
+% footnote \ref{fn:bgpaint-inf2}.\label{fn:bgpaint-inf1}}.
+% 
+% \par\bigskip
+% 
+% \begin{figure}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\textwidth{}\\
+% \parbox{.8\textwidth}{
+% This \texttt{f}(loat) region could be extended to both side edges
+% and the top edge of the paper if its extension were
+% \texttt{(10000pt,10000pt)(10000pt,-4pt)}.}\\
+% \\\hline
+% \end{tabular}}
+% \caption{A Page-Wise Figure \emph{Imported} from Pre-Environment}
+% \label{fig:bgpaint-inf}
+% \end{figure}
+% 
+% \begin{paracol}{2}
+% Though you cannot see, the right edge of this over-painted |c[0]| region
+% is shifted right by 4\,|pt| to hide the small patch at the right bottom
+% corner of the |p| region above by overlaying.
+%
+% \switchcolumn
+% \begingroup\it
+% As explained in the right column, this {\rm|c[1]|} region also has an
+% invisible left edge shifted left by {\rm4\,|pt|}\footnote{
+% 
+% This (foot)|n|(ote) region could be extended to both side edges and the
+% bottom edge of the paper if its extension were
+% \texttt{(10000pt,-4pt)(10000pt,10000pt)}.\label{fn:bgpaint-inf2}}.
+% \endgroup
+%
+% \switchcolumn*[\subsection*{This \texttt{s}(panning text) region could be
+% extended to both side edges of the paper if its extension were
+% \texttt{(10000pt,-4pt)}.}\par\medskip]
+%
+% The author does not have much to say now for this column chunk.
+% \par\vfill
+%
+% Still nothing to say particular to the page break we will have shortly.
+% \par\newpage
+%
+% This paragraph is just for keeping the \env{paracol} environment alive in
+% this page.
+% \switchcolumn
+%
+% \begingroup\it
+% Little to say as well.
+% \par\vfill
+%
+% Nothing to say as well.
+% \par\newpage
+%
+% This paragraph is not necessary for keeping alive the environment but is
+% given for consistent view.
+% \endgroup
+%
+% \begin{figure*}\nosv
+% \def\arraystretch{0.8}
+% \centerline{\begin{tabular}[b]{|c|}\hline
+% \hbox to.9\textwidth{}\\
+% \parbox{.8\textwidth}{
+% This figure is given in the \env{paracol} environment closed in the
+% previous page but its background is not painted.}\\
+% \\\hline
+% \end{tabular}}
+% \caption{A Page-Wise Figure \emph{Exported} to Post-Environment}
+% \label{fig:bgpaint-inf2}
+% \end{figure*}
+% \end{paracol}
+% \bigskip
+%
+% Note that overlay painting is inevitable for two-toned page painting, as
+% far as you want to paint \bground{} of \pwstuff.
+%
+% The last issue of \bgpaint{} is about painting materials given outside
+% \env{paracol}. As you have seen, \Preenv{} and \postenv{} are painted but
+% it is done only when they reside in a page having a portion of a
+% \env{paracol} environment (maybe) of course. Therefore, the next page is
+% \emph{not} painted because the page does not have any parallel-columned
+% stuff. Therefore, even if you wish to paint the whole of your document
+% including pages without \env{paracol} stuff, you cannot do it just with
+% \Paracol{} package, at least so far.
+%
+% On the other hand, some materials given outside \env{paracol} environments
+% are painted as if they are given in the environment when they are
+% \emph{imported} into the environment. One category has footnotes given in
+% \preenv{} when \!\footnotelayout!|{m}| is specified for merging, as
+% exemplified by the footnote \ref{fn:bgpaint-inf1} in the previous page.
+% Note that such a footnote is painted by the color for |n| region rather
+% than |p| region even when there are no footnotes in the \env{paracol}
+% environment. The other category has ordinary floats given by \env{figure}
+% and/or \env{table}
+% (i.e., neither \env{figure*} nor \env{table*}) environments outside
+% \env{paracol} and then \emph{deferred} to a page having (a portion of)
+% stuff produced by \env{paracol}. Since such a float, e.g.,
+% Figure\Tie\ref{fig:bgpaint-inf} in this page, is considered as a page-wise
+% float given in the \env{paracol} environment in this section, its
+% background is painted by the color for the |f| region, rather than that
+% for the |p| region which would be used if the float were is placed in the
+% previous page. Note that such a deferred float import could occur not
+% only from the page having \beginparacol{} but also from pages preceding
+% it. For example, if you have three \env{figure} environments in a page
+% $p-1$ just preceding the page $p$ in which you start a \env{paracol}
+% environment, it could happen that first one is placed in $p-1$ without
+% painting, the second is placed in $p$ and painted by the color for |p|,
+% and the third is placed in $p+1$ and painted by the color for |f|.
+%
+% Finally some materials \emph{exported} from a \env{paracol} environment
+% are painted as if they are in \postenv. In previous two subsections, we
+% saw \Mgfnote{}s (e.g., \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1}
+% and \ref{fn:bgpaint-me1} in p.\Tie\pageref{fn:bgpaint-me1}) are painted by
+% the color of |p| rather than |n|. The other kind of exportation is of
+% page-wise floats given in a \env{paracol} environment but deferred to the
+% page next to the page having \Endparacol, or further. For example,
+% Figure~\ref{fig:bgpaint-inf2} is given in the \env{paracol} environment
+% above in this page, but its \bground{} is not painted because the next page
+% in which the figure is placed does not have any parallel-columned
+% stuff\footnote{
+% 
+% If it has, the background is painted by the color for |p|.}.
+% 
+% \newpage\vspace*{\fill}
+% \centerline{(intentionally blanked page to show this page is \emph{not}
+% painted)}
+% \vfill
+% \advance\skip\footins-4pt\relax
+% \endinput