summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/flowfram/samples
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-11-13 00:16:56 +0000
committerKarl Berry <karl@freefriends.org>2012-11-13 00:16:56 +0000
commitb847625057328d18cbaff06505599203c8382a17 (patch)
treeb040c624881b1af975180256f90173d440d284d7 /Master/texmf-dist/doc/latex/flowfram/samples
parentf5c4d1df6475f098e051b5c8a71ce506a2c0d802 (diff)
flowfram 1.14 (12nov12)
git-svn-id: svn://tug.org/texlive/trunk@28238 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/flowfram/samples')
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/brochure.pdfbin64325 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/news.pdfbin29456 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/news2.pdfbin35856 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/poster.pdfbin77235 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-article.pdfbin0 -> 163034 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-article.tex283
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-blanks.tex19
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.pdfbin0 -> 101902 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.tex (renamed from Master/texmf-dist/doc/latex/flowfram/samples/brochure.tex)141
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-news.pdfbin0 -> 47959 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-news.tex (renamed from Master/texmf-dist/doc/latex/flowfram/samples/news.tex)25
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.pdfbin0 -> 52810 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.tex (renamed from Master/texmf-dist/doc/latex/flowfram/samples/news2.tex)34
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.pdfbin0 -> 136327 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.tex104
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.pdfbin0 -> 91415 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.tex (renamed from Master/texmf-dist/doc/latex/flowfram/samples/poster.tex)136
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.pdfbin0 -> 54583 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.tex49
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample.pdfbin0 -> 100462 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample.tex379
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample1.pdfbin0 -> 151242 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample1.tex305
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample2.pdfbin0 -> 142705 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample2.tex272
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample3.pdfbin0 -> 46648 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sample3.tex65
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.pdfbin0 -> 31645 bytes
-rw-r--r--Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.tex16
29 files changed, 1633 insertions, 195 deletions
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/brochure.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/brochure.pdf
deleted file mode 100644
index 4e37ce2e49b..00000000000
--- a/Master/texmf-dist/doc/latex/flowfram/samples/brochure.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/news.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/news.pdf
deleted file mode 100644
index d36d46ddccd..00000000000
--- a/Master/texmf-dist/doc/latex/flowfram/samples/news.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/news2.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/news2.pdf
deleted file mode 100644
index 62df0e2b448..00000000000
--- a/Master/texmf-dist/doc/latex/flowfram/samples/news2.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/poster.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/poster.pdf
deleted file mode 100644
index ea499d7b56f..00000000000
--- a/Master/texmf-dist/doc/latex/flowfram/samples/poster.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.pdf
new file mode 100644
index 00000000000..02743025742
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.tex
new file mode 100644
index 00000000000..ba165bd9bee
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-article.tex
@@ -0,0 +1,283 @@
+ % This file is public domain.
+
+\documentclass[a4paper]{article}
+
+\usepackage[margin=1in,top=1in,bottom=1in]{geometry}
+\usepackage{url}
+\usepackage{color}
+\usepackage{flowfram}
+
+\newcommand{\sty}[1]{\textsf{#1}}
+\newcommand{\env}[1]{\textsf{#1}}
+\newcommand{\cmdname}[1]{\texttt{\symbol{92}#1}}
+\newcommand{\meta}[1]{\textnormal{\textless\textit{#1}\textgreater}}
+
+
+\twocolumnStop[1]{2in}
+\setstaticframe{1}{label=title}
+
+\twocolumn[>1]
+
+\begin{document}
+\begin{staticcontents*}{title}
+\title{Creating Flow Frames for Posters or Magazines}
+\author{Nicola L. C. Talbot\\[1cm]\url{http://www.dickimaw-books.com/}}
+\date{}
+\maketitle
+\end{staticcontents*}
+
+This document is a sample document, see \linebreak
+\texttt{ffuserguide.pdf} for
+an up-to-date guide on how to use the \sty{flowfram} package.
+
+\section{Introduction}
+
+The \sty{flowfram} package is designed to enable you to create
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
+This is useful for creating posters\marginpar{A marginal note}
+or magazines or any other form of document that does not
+conform to the standard one or two column layout.
+
+\subsection{Setting up Frames}
+
+The \sty{flowfram} package provides three types of frame:
+{flow frames}, {static
+frames} and {dynamic frames}.
+
+\subsubsection{Flow Frames}
+
+The flow frame is the principle type of frame.
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
+position on the page, and optionally a border\footnote{A
+footnote!}.
+
+\subsubsection{Static Frames}
+
+A static frame is a rectangular area in which text neither
+flows into, nor flows out of. The contents must be set
+explicitly, and once set, the contents of the static frame will
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
+a company logo appear in the same place on every page.
+
+\subsubsection{Dynamic Frames}
+
+A dynamic frame is similar to a static frame, but its contents
+are re-typeset on each page. (A static frame stores its
+contents in a savebox, whereas a dynamic frame stores its
+contents in a macro).
+
+\section{Frame Attributes}
+\label{sec:modattr}
+
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
+same set of attributes, but some are specific to a certain type.
+The available attributes are as follows
+(\textsuperscript{\textbf{F}} indicates the key is
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
+for {static frames}
+and \textsuperscript{\textbf{D}} indicates the key
+is only available for {dynamic frames}):
+
+\begin{description}
+\item[width=\meta{length}] The width of the frame.
+
+\item[height=\meta{length}] The height of the frame.
+
+\item[x=\meta{length}] The x-coordinate of the frame.
+
+\item[y=\meta{length}] The y-coordinate of the frame.
+
+\item[border=\meta{style}] The style of the border around the
+frame, this can take the values: \texttt{none} (no border),
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
+The value \texttt{fbox} is equivalent to \texttt{plain}.
+
+\item[offset=\meta{offset}] The border offset, if it is a
+user-defined border. This is the distance from the outer
+edge of the left hand border to the left edge of the
+bounding box of the text inside the border. The \sty{flowfram}
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
+may end up shifted to the right or left.
+
+\item[bordercolor=\meta{colour}] The colour of the border
+if you are using a standard frame making command.
+The colour can either be specified as, e.g.\ \texttt{green},
+or including the colour model, e.g. \verb/[rgb]{0,1,0}/.
+
+\item[textcolor=\meta{colour}] The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
+e.g. \verb/[rgb]{0,1,0}/.
+
+\item[pages=\meta{page list}] The {list of
+pages} for which the frame
+should appear. This can either have the values: \texttt{all},
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+removes the frame from that point on---useful if you
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
+{page ranges}.
+
+\item[margin=\meta{side}\textsuperscript{F}] The side of
+the flow frame that its corresponding margin should go on. This
+can take the values \texttt{left} or \texttt{right}.
+
+\item[clear=\meta{boolean}\textsuperscript{S}] If this value
+is set, the static frame will be cleared at the start of the
+next page.
+
+\item[style=\meta{cmd}\textsuperscript{D}] This should be
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
+The command may either be a declaration, for example \verb/style=large/
+which will set the contents of all the dynamic frames in a
+large font, or it can be a command that takes a single argument,
+for example \verb/style=textbf/
+which will make the text for all the dynamic frames come out in
+bold. To unset a style, do \verb/style=none/.
+
+\end{description}
+
+\section{Miscellaneous}
+
+\subsection{Page Layout}
+
+The \sty{flowfram} package has the package option \texttt{draft}
+which will draw the {bounding boxes} for
+each frame defined. At the bottom right of each
+bounding box (except for the bounding box denoting the
+typeblock), a marker will be shown to indictate the type
+of frame, its IDN and its IDL.
+
+You can see the layout for the current page (irrespective of
+whether or not the \texttt{draft} option has been set) using
+the command:\newline
+\cmdname{flowframeshowlayout}
+
+The headers and footers will appear as usual (but will not
+be shown in draft mode), according to the format given by
+\cmdname{pagestyle}.
+
+\subsection{Frame Stacking Order}
+
+The material on each page is placed in the following order:
+\begin{enumerate}
+\item Each static frame defined for that page in ascending
+order of IDN.
+
+\item Each flow frame defined for that page in ascending
+order of IDN.
+
+\item Each dynamic frame defined for that page in ascending
+order of IDN.
+
+\item {Bounding boxes} if the \texttt{draft}
+package option has been used.
+\end{enumerate}
+
+This ordering can be used to determine if you want something
+to overlay or underlay everything else on the page.
+
+\subsection{Prematurely Ending a Flow Frame}
+
+You can force text to move immediately to the next defined
+flow frame using one of the standard \LaTeX\ page breaking commands
+which work in an analogous way to the way they
+work in standard two column mode.
+
+The command \cmdname{framebreak} is provided for situations
+where a paragraph spans two flow frames
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
+result, the end of the paragraph at the beginning of the new
+flow frame retains the width of the previous flow frame.
+
+If you want to start a new page, rather than simply move to the
+next frame, use the command\newline
+\cmdname{finishthispage}.
+
+\subsection{Floats}
+
+Since floats (such as figures and tables) can only go in
+{flow frames}, this package provides
+the additional environments:
+\env{staticfigure} and
+\env{statictable} which can be used in static frames
+and dynamic frames. Unlike their \env{figure} and
+\env{table} counterparts, they are fixed in place, and
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
+be used within \env{staticfigure} and \env{statictable} as
+usual.
+
+The standard \env{figure} and \env{table} commands will
+behave as usual in the flow frames, but their starred versions,
+\env{figure*} and \env{table*} behave no differently
+from \env{figure} and \env{table}.
+
+\subsection{Global Values}
+
+The following macros can be changed using \cmdname{renewcommand}:
+
+\begin{itemize}
+\item \cmdname{setffdraftcolor}
+
+This sets the colour of the bounding box
+when it is displayed in draft mode.
+
+\item
+\cmdname{setffdrafttypeblockcolor}
+
+This sets the colour of
+the bounding box of the typeblock when it is displayed
+in draft mode.
+
+\item \cmdname{fflabelfont}
+
+This sets the font size for the bounding box markers in
+draft mode.
+
+\end{itemize}
+
+The following are lengths, which can be changed using
+\cmdname{setlength}:
+\marginpar{Another marginal note}
+
+\begin{itemize}
+\item \cmdname{fflabelsep}
+
+This is the distance from the right hand side of the
+bounding box at which to place the bounding box marker.
+
+\item \cmdname{flowframesep}
+
+This is the gap between the text of the frame and
+its border, for the standard border types.
+
+\item \cmdname{flowframerule}
+
+This is the width of the frame's border, if using
+a border given by a frame making command that uses \cmdname{fboxsep}
+to set its border width.
+\end{itemize}
+
+\section*{Contact Details}
+
+Dr Nicola Talbot\\
+Dickimaw Books\\
+\url{http://www.dickimaw-books.com/}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-blanks.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-blanks.tex
new file mode 100644
index 00000000000..6296b14f576
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-blanks.tex
@@ -0,0 +1,19 @@
+ % This file is public domain.
+
+\documentclass{article}
+
+\usepackage{lipsum}
+\usepackage[draft]{flowfram}
+
+\onecolumn[odd]
+
+\newdynamicframe{1in}{1in}{-1in}{-1in}
+\setdynamiccontents{1}{\arabic{absolutepage}-\arabic{page}}
+
+\begin{document}
+
+\lipsum[1-4]
+
+\lipsum[1-4]
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.pdf
new file mode 100644
index 00000000000..f94e4e2451a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/brochure.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.tex
index d0434139854..c1b499a0248 100644
--- a/Master/texmf-dist/doc/latex/flowfram/samples/brochure.tex
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-brochure.tex
@@ -1,3 +1,5 @@
+ % This file is public domain.
+
\documentclass[a4paper]{report}
\usepackage[landscape,margin=1in]{geometry}
@@ -5,63 +7,45 @@
\usepackage{flowfram}
\usepackage[colorlinks]{hyperref}
-% Use sans-serif font as default font
\renewcommand{\familydefault}{cmss}
-% adjust \textheight so that it is an integer multiple of
-% \baselineskip
\adjustheight{\textheight}
-% set up pagelayout. One column for title page
-% two columns for the rest.
\onecolumninarea[1,2]{0.6\textwidth}{\textheight}{0.4\textwidth}{0pt}
\twocolumninarea[>2]{0.6\textwidth}{\textheight}{0.4\textwidth}{0pt}
-% Set up dynamic frame on the left. This is where
-% the headings will go.
\newdynamicframe{0.4\textwidth}{\textheight}{0pt}{0pt}[left]
-% put the chapter headings in this frame
\dfchaphead*{left}
-% Modify the default style
\renewcommand{\DFchapterstyle}[1]{%
\raggedright\Huge\slshape\MakeUppercase{#1}\par}
-% Make static frames for background (only for page 1)
\vtwotone[1]{0.6\paperwidth}{[cmyk]{0.65,0.13,0,0}}{backleft}%
{0.4\paperwidth}{[cmyk]{0.94,0.54,0,0}}{backright}
-% Make a border along the top of each page
\vtwotonetop{1cm}{0.6\paperwidth}{[cmyk]{0.65,0.13,0,0}}{topleft}%
{0.4\paperwidth}{[cmyk]{0.94,0.54,0,0}}{topright}
-% make a static frame for the logo
\newstaticframe{0.2\textwidth}{0.25\textheight}{0pt}{0pt}[logo]
-% empty page style, because I am going to make my own
\pagestyle{empty}
-% Each new chapter sets \thispagestyle{\chapterfirstpagestyle}, change this empty as well
-\renewcommand{\chapterfirstpagestyle}{empty}
+\renewcommand{\chapterfirstpagestyle}{empty}
-% Now make a frame in which to put my own customized footer
\newdynamicframe[>1]{\textwidth}{\headheight}{0pt}{-\footskip}[footer]
-% set the contents of the frame:
\setdynamiccontents*{footer}{%
School of Computing Sciences, University of East Anglia\hfill
http://www.cmp.uea.ac.uk/\hfill
page \thepage\ of \pageref*{lastpage}}
-
\newcommand{\env}[1]{\texttt{#1}}
\newcommand{\cmdname}[1]{\texttt{\symbol{92}#1}}
\newcommand{\meta}[1]{\textnormal{\textless\textit{#1}\textgreater}}
\begin{document}
-% not a very interesting logo
\setstaticcontents*{logo}{\sffamily{\Huge\slshape FLF} Flowfram}
{\noindent
@@ -70,19 +54,18 @@ page \thepage\ of \pageref*{lastpage}}
\noindent\large\MakeUppercase{Nicola Talbot}\\
}
-
\chapter{Introduction}
The \textsl{flowfram} package is designed to enable you to create
-frames in a document such that the
-contents of the \env{document} environment flow from one
-frame to the next in the order that they were defined.
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
This is useful for creating posters
-or magazines or any other form of document that does not
+or magazines or any other form of document that does not
conform to the standard one or two column layout.
This is a modified version of the manual for the \textsl{flowfram} package.
-It is intended to illustrated what can be done. See the full
+It is intended to illustrated what can be done. See the full
manual (ffuserguide.pdf) for
a comprehensive description, as some parts of this document
may now be out of date.
@@ -95,8 +78,8 @@ This is column~\thedisplayedframe.
The main type of frame is the flow frame. This is described on
column~\ref{flow:flowframe} on page~\pageref{flow:flowframe}.
The order used to draw the contents of each frame on the page
-is described in column~\ref{flow:stacking} on
-page~\pageref{flow:stacking}. Floats are describe in
+is described in column~\ref{flow:stacking} on
+page~\pageref{flow:stacking}. Floats are describe in
column~\ref{flow:floats} on page~\pageref{flow:floats}.
\chapter{Setting up Frames}
@@ -104,16 +87,16 @@ column~\ref{flow:floats} on page~\pageref{flow:floats}.
This is column~\thedisplayedframe.
The \textsl{flowfram} package provides three types of frame:
-{flow frames}, {static
+{flow frames}, {static
frames} and {dynamic frames}.
\section*{Flow Frames}
\labelflow{flow:flowframe}
The flow frame is the principle type of frame.
-The text of the \env{document} environment will flow from
-one frame to the next in order of definition. Each
-flow frame has an associated width, height,
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
position on the page, and optionally a border.
It is recommended that all the flow frames in a document
@@ -121,7 +104,7 @@ have the same width, otherwise problems may occur
when a paragraph spans to flow frames of unequal
widths. This is because \TeX's output routine does not
register the change in \cmdname{hsize} until it reaches
-a paragraph break. If it is absolutely necessary for
+a paragraph break. If it is absolutely necessary for
flow frames to have unequal widths, judicious use of
\cmdname{framebreak} is required.
@@ -130,14 +113,14 @@ flow frames to have unequal widths, judicious use of
A static frame is a rectangular area in which text neither
flows into, nor flows out of. The contents must be set
explicitly, and once set, the contents of the static frame will
-remain the same on each page until it is explicitly
-changed. Thus, a static frame can be used, for example, to make
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
a company logo appear in the same place on every page.
\section*{Dynamic Frames}
A dynamic frame is similar to a static frame, but its contents
-are re-typeset on each page. (A static frame stores its
+are re-typeset on each page. (A static frame stores its
contents in a savebox, whereas a dynamic frame stores its
contents in a macro).
@@ -146,14 +129,14 @@ This is column~\thedisplayedframe.
\chapter{Frame Attributes}
\label{sec:modattr}
-Once you have defined the {flow frames}, {static frames} and
-{dynamic frames}, their attributes can be changed.
-The three types of frame mostly have the
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
same set of attributes, but some are specific to a certain type.
The available attributes are as follows
(\textsuperscript{\textbf{F}} indicates the key is
-only available for {flow frames},
-\textsuperscript{\textbf{S}} indicates the key is only available
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
for {static frames}
and \textsuperscript{\textbf{D}} indicates the key
is only available for {dynamic frames}):
@@ -167,40 +150,40 @@ is only available for {dynamic frames}):
\item[y=\meta{length}]\mbox{}\par The y-coordinate of the frame.
-\item[border=\meta{style}]\mbox{}\par The style of the border around the
+\item[border=\meta{style}]\mbox{}\par The style of the border around the
frame, this can take the values: \texttt{none} (no border),
-\texttt{plain} (plain border) or the name of a \LaTeX\
-frame making command without the preceding backslash.
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
The value \texttt{fbox} is equivalent to \texttt{plain}.
-\item[offset=\meta{offset}]\mbox{}\par The border offset, if it is a
+\item[offset=\meta{offset}]\mbox{}\par The border offset, if it is a
user-defined border. This is the distance from the outer
edge of the left hand border to the left edge of the
bounding box of the text inside the border. The \textsl{flowfram}
-package is able to compute the border for
-known frame making commands.
-If you define your own frame making command, you may need to
-specify the offset explicitly, or the frames
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
may end up shifted to the right or left.
\item[bordercolor=\meta{colour}]\mbox{}\par The colour of the border
if you are using a standard frame making command.
The colour can either be specified as, e.g.\ \texttt{green},
-or including the colour model, for example
+or including the colour model, for example
\verb/[rgb]{0,1,0}/.
-\item[textcolor=\meta{colour}]\mbox{}\par The text colour for that
-frame. Again, the colour can either be specified as,
-e.g.\ \texttt{green}, or including the colour model,
+\item[textcolor=\meta{colour}]\mbox{}\par The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
for example \verb/[rgb]{0,1,0}/.
-\item[pages=\meta{page list}]\mbox{}\par The {list of
+\item[pages=\meta{page list}]\mbox{}\par The {list of
pages} for which the frame
should appear. This can either have the values: \texttt{all},
-\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
removes the frame from that point on---useful if you
-have multiple pages with the same number), or it can be a
-comma-separated list of single pages, or
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
{page ranges}.
\item[margin=\meta{side}\textsuperscript{F}]\mbox{}\par The side of
@@ -212,13 +195,13 @@ is set, the static frame will be cleared at the start of the
next page.
\item[style=\meta{cmd}\textsuperscript{D}]\mbox{}\par This should be
-the name of a command \emph{without} the preceding backslash,
-to be applied to the contents of the specified dynamic frame.
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
The command may either be a declaration, for example \verb/style=large/
which will set the contents of all the dynamic frames in a
large font, or it can be a command that takes a single argument,
for example \verb/style=textbf/
-which will make the text for all the dynamic frames come out in
+which will make the text for all the dynamic frames come out in
bold. To unset a style, do \verb/style=none/.
\end{description}
@@ -230,17 +213,17 @@ bold. To unset a style, do \verb/style=none/.
The \textsl{flowfram} package has the package option \texttt{draft}
which will draw the {bounding boxes} for
each frame defined. At the bottom right of each
-bounding box (except for the bounding box denoting the
+bounding box (except for the bounding box denoting the
typeblock), a marker will be shown to indictate the type
of frame, its IDN and its IDL.
You can see the layout for the current page (irrespective of
whether or not the \texttt{draft} option has been set) using
-the command:\newline
+the command:\newline
\cmdname{flowframeshowlayout}
The headers and footers will appear as usual (but will not
-be shown in draft mode), according to the format given by
+be shown in draft mode), according to the format given by
\cmdname{pagestyle}.
\section*{Frame Stacking Order}
@@ -262,43 +245,43 @@ package option has been used.
\end{enumerate}
This ordering can be used to determine if you want something
-to overlay or underlay everything else on the page.
+to overlay or underlay everything else on the page.
\section*{Prematurely Ending a Flow Frame}
You can force text to move immediately to the next defined
flow frame using one of the standard \LaTeX\ page breaking commands
which work in an analogous way to the way they
-work in standard two column mode.
+work in standard two column mode.
The command \cmdname{framebreak} is provided for situations
where a paragraph spans two flow frames
-of different widths, as \TeX's output routine does not
-adjust to the new value of \cmdname{hsize} until the last
-paragraph of the previous frame has ended. As a
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
result, the end of the paragraph at the beginning of the new
flow frame retains the width of the previous flow frame.
-If you want to start a new page, rather than simply move to the
+If you want to start a new page, rather than simply move to the
next frame, use the command\newline
\cmdname{finishthispage}.
\section*{Floats}
\labelflow{flow:floats}
-Since floats (such as figures and tables) can only go in
+Since floats (such as figures and tables) can only go in
{flow frames}, this package provides
-the additional environments:
-\env{staticfigure} and
+the additional environments:
+\env{staticfigure} and
\env{statictable} which can be used in static frames
and dynamic frames. Unlike their \env{figure} and
\env{table} counterparts, they are fixed in place, and
-so do not take an optional placement specifier. The
-\cmdname{caption} and \cmdname{label} commands can
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
be used within \env{staticfigure} and \env{statictable} as
usual.
-The standard \env{figure} and \env{table} commands will
+The standard \env{figure} and \env{table} commands will
behave as usual in the flow frames, but their starred versions,
\env{figure*} and \env{table*} behave no differently
from \env{figure} and \env{table}.
@@ -308,13 +291,13 @@ from \env{figure} and \env{table}.
The following macros can be changed using\linebreak \cmdname{renewcommand}:
\begin{itemize}
-\item \cmdname{setffdraftcolor}
+\item \cmdname{setffdraftcolor}
This sets the colour of the bounding box
when it is displayed in draft mode.
-\item
-\cmdname{setffdrafttypeblockcolor}
+\item
+\cmdname{setffdrafttypeblockcolor}
This sets the colour of
the bounding box of the typeblock when it is displayed
@@ -322,7 +305,7 @@ in draft mode.
\item \cmdname{fflabelfont}
-This sets the font size for the bounding box markers in
+This sets the font size for the bounding box markers in
draft mode.
\end{itemize}
@@ -339,7 +322,7 @@ bounding box at which to place the bounding box marker.
\item \cmdname{flowframesep}
This is the gap between the text of the frame and
-its border, for the standard border types.
+its border, for the standard border types.
\item \cmdname{flowframerule}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-news.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news.pdf
new file mode 100644
index 00000000000..bfbd33ee0d2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/news.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news.tex
index a8ff83b3922..d3f98184ff9 100644
--- a/Master/texmf-dist/doc/latex/flowfram/samples/news.tex
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news.tex
@@ -1,3 +1,5 @@
+ % This file is public domain.
+
\documentclass{article}
\usepackage{color}
@@ -5,7 +7,6 @@
\usepackage[a5paper,top=10mm,bottom=10mm,margin=10mm]{geometry}
\usepackage{graphicx}
-% define lengths to help compute positions
\newlength\leftX
\newlength\leftY
\newlength\leftH
@@ -16,14 +17,12 @@
\newlength\rightH
\newlength\rightW
-% Create a static frame to put title in
\setlength{\leftH}{2cm}
\setlength{\leftY}{\textheight}
\addtolength{\leftY}{-\leftH}
\newstaticframe[1]{\textwidth}{\leftH}{0pt}{\leftY}[title]
-% First flow frame.
\setlength{\leftH}{7cm}
\adjustheight{\leftH}
@@ -35,7 +34,6 @@
\setlength{\rightH}{\leftH}
\setlength{\rightY}{\leftY}
-% Second flow frame
\setlength{\leftH}{3.5cm}
\adjustheight{\leftH}
@@ -43,7 +41,6 @@
\newflowframe[1]{\textwidth}{\leftH}{0pt}{\leftY}
-% Right hand flow frame
\setlength{\rightX}{\leftW}
\addtolength{\rightX}{\columnsep}
@@ -52,19 +49,14 @@
\newflowframe[1]{\rightW}{\rightH}{\rightX}{\rightY}
-% insert vertical line between left and right flow frames
\insertvrule{flow}{1}{flow}{3}
-% insert horizontal line between flow frames 2 and 3
-% don't want it to go under frame 1 so shift the starting
-% position
\addtolength{\rightX}{-0.5\columnsep}
\addtolength{\rightX}{-0.5\columnseprule}
\inserthrule[-\rightX]{flow}{3}{flow}{2}
-% egg picture
\addtolength{\rightY}{\rightH}
\addtolength{\rightY}{-10mm}
@@ -75,20 +67,16 @@
\addtolength{\rightX}{-\rightW}
\newstaticframe[1]{\rightW}{\rightH}{\rightX}{\rightY}[egg]
-% set contents
\setstaticcontents*{egg}{\includegraphics[scale=0.75]{egg}}
-% middle heading
\setlength{\leftH}{2cm}
\addtolength{\leftY}{-\leftH}
\newstaticframe[1]{\textwidth}{\leftH}{0pt}{\leftY}[midhead]
-% insert horizontal line
\inserthrule*{flow}{2}{static}{midhead}
-% bottom left flow frame
\setlength{\leftH}{\leftY}
\adjustheight{\leftH}
@@ -96,7 +84,6 @@
\newflowframe[1]{\leftW}{\leftH}{0pt}{0pt}
-% bottom right flow frame
\setlength{\rightX}{\leftW}
\addtolength{\rightX}{\columnsep}
@@ -105,11 +92,9 @@
\newflowframe[1]{\rightW}{\leftH}{\rightX}{0pt}
-% static frame for sheep picture
\newstaticframe[1]{0.8in}{0.8in}{0pt}{0pt}[sheep]
-% set contents
\setstaticcontents*{sheep}{\includegraphics[scale=0.75]{sheep}}
\onecolumn[>1] % for any text that falls off the last page
@@ -159,7 +144,7 @@ people to keep their doors securely fastened at all times.
{\parshape=6 0pt 13em 0pt 13em 0pt 11em 0pt 11em 0pt 13em
0pt 17em
-An egg person tragically fell from a six foot wall yesterday
+An egg person tragically fell from a six foot wall yesterday
afternoon and was smash\-ed to pieces. The king's cavalry rushed
to the scene, but regretted that they were unable to help him.
\par}
@@ -189,12 +174,12 @@ as they did indeed come home. Eye witnesses reported that their
tails were wagging behind them.
``I'm just so happy they've come home,'' Little Bo Peep said
in a press conference yesterday\framebreak}afternoon.
-The sheep themselves made no comment, and police are still
+The sheep themselves made no comment, and police are still
trying to determine what happened to them.
\noindent\hrulefill
-This is a sample document illustrating the
+This is a sample document illustrating the
flowfram package. It uses \TeX's \verb|\parshape| command
to create irregularly shaped paragraphs.
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.pdf
new file mode 100644
index 00000000000..792b51492a1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/news2.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.tex
index 125d5d3cd58..8752e95a771 100644
--- a/Master/texmf-dist/doc/latex/flowfram/samples/news2.tex
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-news2.tex
@@ -1,3 +1,5 @@
+ % This file is public domain.
+
\documentclass[12pt]{article}
\usepackage{graphicx}
@@ -5,25 +7,22 @@
\usepackage{flowfram}
\usepackage[a4paper,margin=20mm]{geometry}
-% define lengths to help compute positions
\newlength\leftX
\newlength\leftY
\newlength\leftH
\newlength\leftW
-
+
\newlength\rightX
\newlength\rightY
\newlength\rightH
\newlength\rightW
-% Create a static frame to put title in
\setlength{\leftH}{3cm}
\setlength{\leftY}{\textheight}
\addtolength{\leftY}{-\leftH}
-
+
\newstaticframe[1]{\textwidth}{\leftH}{0pt}{\leftY}[title]
-% Create left hand frame. This will have an L shape
\setlength{\leftH}{13cm}
\adjustheight{\leftH}
@@ -57,7 +56,6 @@
0pt \linewidth
}}
-% egg picture
\addtolength{\rightY}{\leftY}
\addtolength{\rightY}{73mm}
@@ -67,10 +65,8 @@
\addtolength{\rightX}{-\rightW}
\newstaticframe[1]{\rightW}{\rightH}{\rightX}{\rightY}[egg]
-% set contents
\setstaticcontents*{egg}{\includegraphics[scale=0.9]{egg}}
-% Right hand static frame
\setlength{\rightX}{0.5\textwidth}
\addtolength{\rightX}{\columnsep}
@@ -101,32 +97,24 @@
0pt \linewidth
}}
-% insert vertical and horizontal rules, can't use
-% \insertrule as left hand
-% frame is actually the width of the typeblock
\addtolength{\rightX}{-0.5\columnsep}
\newstaticframe[1]{0pt}{\rightH}{\rightX}{\rightY}[Lrule]
\setstaticcontents*{Lrule}{\makebox[0pt][l]{%
\rule{\columnseprule}{\rightH}\rule{\rightW}{\columnseprule}}}
-% middle heading
\setlength{\leftH}{2cm}
\addtolength{\leftY}{-\leftH}
\newstaticframe[1]{\textwidth}{\leftH}{0pt}{\leftY}[midhead]
-% insert horizontal rule
\inserthrule*{static}{L}{static}{midhead}
-% flow frames
\twocolumninarea{\textwidth}{\leftY}{0pt}{0pt}
-% static frame for sheep picture
\newstaticframe[1]{1.6in}{1.6in}{0pt}{0pt}[sheep]
-% set contents
\setstaticcontents*{sheep}{\includegraphics[scale=1.2]{sheep}}
\setcounter{secnumdepth}{0}
@@ -143,12 +131,12 @@ Fairy Tale Times
\begin{staticcontents*}{L}
\section{Killer Wolf on the Loose}
-
+
The authorites are warning of a killer wolf on the
loose. He has so far devoured an old grandmother and
two pig brothers. He is described as being furry with
big eyes and big teeth.
-
+
On Monday this week he broke into a house, and devoured
an old lady. He then disguised himself as the old lady
in order to deceive her granddaughter. Luckily for the little
@@ -161,9 +149,9 @@ pig brothers who had most incautiously made their dwellings
on the cheap using inadequate materials. The wolf also made
an attempt on the third pig brother, but was unable to break
into his house.
-
+
Police are appealing to the public for witnesses and remind
-people to keep their doors securely fastened at all times.
+people to keep their doors securely fastened at all times.
``Always ask to see identification,'' said one police advisor,
``and invest in improving the general security of your property.''
\end{staticcontents*}
@@ -181,8 +169,6 @@ those vulnerable members of the population suffering from
eggshell syndrome.
\small\em
-%Wall related incidents this year: page 3
-%
Exclusive interview with one of the King's men on page 6
\end{staticcontents*}
@@ -196,7 +182,7 @@ for more than a week.
``I just didn't know where to find them,'' the shepherdess
stated, ``but I was told to leave them alone and they'd come
-home.''
+home.''
\parshape=8
0pt \linewidth
@@ -219,7 +205,7 @@ The big bad wolf is reportedly helping them with their inquiries.
\noindent\hrulefill
-This is a sample document illustrating the
+This is a sample document illustrating the
flowfram package. It uses \TeX's \verb|\parshape| command
to create irregularly shaped paragraphs. This can be a complicated
and somewhat tiresome task, and is generally not recommended.
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.pdf
new file mode 100644
index 00000000000..4e8532796e9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.tex
new file mode 100644
index 00000000000..38e52856a4c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-pages.tex
@@ -0,0 +1,104 @@
+ % This file is public domain.
+
+\documentclass{book}
+
+\usepackage[demo]{graphicx}
+\usepackage{lipsum}
+\usepackage{color}
+\usepackage[
+ draft,
+ verbose,
+ pages=absolute
+ ]{flowfram}
+
+\onecolumn
+
+\setflowframe{1}{label=single}
+
+\twocolumnDtop[none]{2in}
+
+\setdynamicframe{1}{label=title}
+\setflowframe{2}{label=shortleft}
+\setflowframe{3}{label=shortright}
+
+\twocolumn[none]
+
+\setflowframe{4}{label=left}
+\setflowframe{5}{label=right}
+
+\newdynamicframe[none]{\textwidth}{\textheight}{0pt}{0pt}[image]
+
+\setdynamicframe*{image}{valign=c}
+
+\title{Sample Document}
+\author{A.N. Other}
+
+\begin{document}\raggedright
+\maketitle
+
+\frontmatter
+\tableofcontents
+\chapter{Acknowledgements}
+
+\lipsum[1]
+
+\flowswitchoffnextodd*{single}%
+\flowswitchonnextoddonly*{shortleft,shortright}%
+\dynamicswitchonnextoddonly*{title}%
+\dfchaphead*{title}
+
+\mainmatter
+\chapter{Sample}
+
+\flowswitchonnext*{left,right}%
+\renewcommand{\ffprechapterhook}{%
+ \flowswitchoffnextoddonly*{left,right}%
+ \flowswitchonnextoddonly*{shortleft,shortright}%
+ \dynamicswitchonnextoddonly*{title}%
+}
+
+\lipsum
+
+\lipsum
+
+\chapter{Another Sample Chapter}
+
+\lipsum[1-20]
+
+
+\flowswitchoffnextonly*{left,right}
+\flowswitchonnextonly*{single}
+
+\clearpage
+
+\begin{figure}[p]
+\centering
+ \includegraphics{image1}
+\caption{A Sample Figure}
+\label{fig:sample}
+\end{figure}
+
+\clearpage
+
+\lipsum[21-30]
+
+\chapter{Here's Another Chapter}
+
+\lipsum[1-20]
+
+
+\flowswitchoffnextonly*{left,right}
+\dynamicswitchonnextonly*{image}
+
+\setdynamiccontents*{image}{%
+ \begin{staticfigure}
+ \centering
+ \includegraphics{image2}
+ \caption{Another Sample Figure}
+ \label{fig:sample2}
+ \end{staticfigure}
+}
+
+\lipsum[21-40]
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.pdf
new file mode 100644
index 00000000000..9097577037b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/poster.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.tex
index 05fe2131f7d..c8d2784525e 100644
--- a/Master/texmf-dist/doc/latex/flowfram/samples/poster.tex
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-poster.tex
@@ -1,34 +1,28 @@
+ % This file is public domain.
+
\documentclass[a0]{a0poster}
\usepackage{color}
-\usepackage{times}
+\usepackage{mathptmx}
\usepackage{courier}
-\usepackage{helvet}
+\usepackage[scaled=0.92]{helvet}
+\usepackage{url}
\usepackage{flowfram}
-% set up frames
\setlength{\columnsep}{2cm}
-% Base the page layout on 4 column with static header.
-% The static frame has height = 0.2\textheight
\NcolumnStop{4}{0.2\textheight}
-% give the static frame a label to make it easier to keep track of
\setstaticframe{\value{maxstatic}}{label={title},backcolor=[cmyk]{0.64,0,0.95,0.40},textcolor=white}
-% Insert a vertical line between flow frames 2 and 3:
\insertvrule{flow}{2}{flow}{3}
-% On the first page, replace last two columns with
-% 2 columns and a static underneath
\setflowframe{3,4}{pages={>1}}
\computeflowframearea{3,4}
\twocolumnSbottominarea[1]{0.5\ffareaheight}{\ffareawidth}{\ffareaheight}{\ffareax}{\ffareay}
\setstaticframe{\value{maxstatic}}{label={info},backcolor=[cmyk]{0.26,0,0.76,0},clear}
-% insert a horizontal rule between flow frame 5 and static
-% frame 5
\inserthrule*[0.5\columnsep]{flow}{5}{static}{info}
\setallflowframes{backcolor=[cmyk]{0.15,0,0.69,0}}
@@ -38,8 +32,6 @@
\newcommand{\cmdname}[1]{\texttt{\symbol{92}#1}}
\newcommand{\meta}[1]{\textnormal{\textless\textit{#1}\textgreater}}
-%\raggedright
-%\setlength{\parindent}{15pt}
\begin{document}
\begin{staticcontents*}{title}
@@ -48,7 +40,7 @@
\vskip1cm
\huge Nicola L. C. Talbot
\vskip2ex
-\normalsize \verb"http://theoval.cmp.uea.ac.uk/~nlct/"
+\normalsize \url{http://www.dickimaw-books.com/}
\end{center}
\end{staticcontents*}
@@ -74,7 +66,7 @@
% The area taken up by the 3rd and 4th columns is given by
\computeflowframearea{3,4}
-
+
% Set up new frames in this area
\twocolumnSbottominarea[1]{0.5}{\ffareawidth}{\ffareaheight}{\ffareax}{\ffareay}
@@ -90,8 +82,8 @@
\end{staticfigure}
\end{staticcontents*}
-This is a modified version of the manual for the \sty{flowfram}
-package. It is intended to illustrated what can be done. See the
+This is a modified version of the manual for the \sty{flowfram}
+package. It is intended to illustrated what can be done. See the
full manual (ffuserguide.pdf) for
a comprehensive description, as this may now be out of date. The commands used to define the frames for
this document are shown in Figure~\ref{fig:thisdoc}.
@@ -102,25 +94,25 @@ problem working out the line breaks.
\section{Introduction}
The \sty{flowfram} package is designed to enable you to create
-frames in a document such that the
-contents of the \env{document} environment flow from one
-frame to the next in the order that they were defined.
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
This is useful for creating posters
-or magazines or any other form of document that does not
+or magazines or any other form of document that does not
conform to the standard one or two column layout.
\section{Setting up Frames}
The \sty{flowfram} package provides three types of frame:
-{flow frames}, {static
+{flow frames}, {static
frames} and {dynamic frames}.
\subsection{Flow Frames}
The flow frame is the principle type of frame.
-The text of the \env{document} environment will flow from
-one frame to the next in order of definition. Each
-flow frame has an associated width, height,
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
position on the page, and optionally a border.
It is recommended that all the flow frames in a document
@@ -128,7 +120,7 @@ have the same width, otherwise problems may occur
when a paragraph spans to flow frames of unequal
widths. This is because \TeX's output routine does not
register the change in \cmdname{hsize} until it reaches
-a paragraph break. If it is absolutely necessary for
+a paragraph break. If it is absolutely necessary for
flow frames to have unequal widths, judicious use of
\cmdname{framebreak} is required.
@@ -137,28 +129,28 @@ flow frames to have unequal widths, judicious use of
A static frame is a rectangular area in which text neither
flows into, nor flows out of. The contents must be set
explicitly, and once set, the contents of the static frame will
-remain the same on each page until it is explicitly
-changed. Thus, a static frame can be used, for example, to make
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
a company logo appear in the same place on every page.
\subsection{Dynamic Frames}
A dynamic frame is similar to a static frame, but its contents
-are re-typeset on each page. (A static frame stores its
+are re-typeset on each page. (A static frame stores its
contents in a savebox, whereas a dynamic frame stores its
contents in a macro).
\section{Frame Attributes}
\label{sec:modattr}
-Once you have defined the {flow frames}, {static frames} and
-{dynamic frames}, their attributes can be changed.
-The three types of frame mostly have the
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
same set of attributes, but some are specific to a certain type.
The available attributes are as follows
(\textsuperscript{\textbf{F}} indicates the key is
-only available for {flow frames},
-\textsuperscript{\textbf{S}} indicates the key is only available
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
for {static frames}
and \textsuperscript{\textbf{D}} indicates the key
is only available for {dynamic frames}):
@@ -172,20 +164,20 @@ is only available for {dynamic frames}):
\item[y=\meta{length}] The y-coordinate of the frame.
-\item[border=\meta{style}] The style of the border around the
+\item[border=\meta{style}] The style of the border around the
frame, this can take the values: \texttt{none} (no border),
-\texttt{plain} (plain border) or the name of a \LaTeX\
-frame making command without the preceding backslash.
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
The value \texttt{fbox} is equivalent to \texttt{plain}.
-\item[offset=\meta{offset}] The border offset, if it is a
+\item[offset=\meta{offset}] The border offset, if it is a
user-defined border. This is the distance from the outer
edge of the left hand border to the left edge of the
bounding box of the text inside the border. The \sty{flowfram}
-package is able to compute the border for
-known frame making commands.
-If you define your own frame making command, you may need to
-specify the offset explicitly, or the frames
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
may end up shifted to the right or left.
\item[bordercolor=\meta{colour}] The colour of the border
@@ -193,18 +185,18 @@ if you are using a standard frame making command.
The colour can either be specified as, e.g.\ \texttt{green},
or including the colour model, e.g. \verb/[rgb]{0,1,0}/.
-\item[textcolor=\meta{colour}] The text colour for that
-frame. Again, the colour can either be specified as,
-e.g.\ \texttt{green}, or including the colour model,
+\item[textcolor=\meta{colour}] The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
e.g. \verb/[rgb]{0,1,0}/.
-\item[pages=\meta{page list}] The {list of
+\item[pages=\meta{page list}] The {list of
pages} for which the frame
should appear. This can either have the values: \texttt{all},
-\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
removes the frame from that point on---useful if you
-have multiple pages with the same number), or it can be a
-comma-separated list of single pages, or
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
{page ranges}.
\item[margin=\meta{side}\textsuperscript{F}] The side of
@@ -216,13 +208,13 @@ is set, the static frame will be cleared at the start of the
next page.
\item[style=\meta{cmd}\textsuperscript{D}] This should be
-the name of a command \emph{without} the preceding backslash,
-to be applied to the contents of the specified dynamic frame.
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
The command may either be a declaration, for example \verb/style=large/
which will set the contents of all the dynamic frames in a
large font, or it can be a command that takes a single argument,
for example \verb/style=textbf/
-which will make the text for all the dynamic frames come out in
+which will make the text for all the dynamic frames come out in
bold. To unset a style, do \verb/style=none/.
\end{description}
@@ -234,17 +226,17 @@ bold. To unset a style, do \verb/style=none/.
The \sty{flowfram} package has the package option \texttt{draft}
which will draw the {bounding boxes} for
each frame defined. At the bottom right of each
-bounding box (except for the bounding box denoting the
+bounding box (except for the bounding box denoting the
typeblock), a marker will be shown to indictate the type
of frame, its IDN and its IDL.
You can see the layout for the current page (irrespective of
whether or not the \texttt{draft} option has been set) using
-the command:\newline
+the command:\newline
\cmdname{flowframeshowlayout}
The headers and footers will appear as usual (but will not
-be shown in draft mode), according to the format given by
+be shown in draft mode), according to the format given by
\cmdname{pagestyle}.
\subsection{Frame Stacking Order}
@@ -265,42 +257,42 @@ package option has been used.
\end{enumerate}
This ordering can be used to determine if you want something
-to overlay or underlay everything else on the page.
+to overlay or underlay everything else on the page.
\subsection{Prematurely Ending a Flow Frame}
You can force text to move immediately to the next defined
flow frame using one of the standard \LaTeX\ page breaking commands
which work in an analogous way to the way they
-work in standard two column mode.
+work in standard two column mode.
The command \cmdname{framebreak} is provided for situations
where a paragraph spans two flow frames
-of different widths, as \TeX's output routine does not
-adjust to the new value of \cmdname{hsize} until the last
-paragraph of the previous frame has ended. As a
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
result, the end of the paragraph at the beginning of the new
flow frame retains the width of the previous flow frame.
-If you want to start a new page, rather than simply move to the
+If you want to start a new page, rather than simply move to the
next frame, use the command\newline
\cmdname{finishthispage}.
\subsection{Floats}
-Since floats (such as figures and tables) can only go in
+Since floats (such as figures and tables) can only go in
{flow frames}, this package provides
-the additional environments:
-\env{staticfigure} and
+the additional environments:
+\env{staticfigure} and
\env{statictable} which can be used in static frames
and dynamic frames. Unlike their \env{figure} and
\env{table} counterparts, they are fixed in place, and
-so do not take an optional placement specifier. The
-\cmdname{caption} and \cmdname{label} commands can
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
be used within \env{staticfigure} and \env{statictable} as
usual.
-The standard \env{figure} and \env{table} commands will
+The standard \env{figure} and \env{table} commands will
behave as usual in the flow frames, but their starred versions,
\env{figure*} and \env{table*} behave no differently
from \env{figure} and \env{table}.
@@ -310,13 +302,13 @@ from \env{figure} and \env{table}.
The following macros can be changed using \cmdname{renewcommand}:
\begin{itemize}
-\item \cmdname{setffdraftcolor}
+\item \cmdname{setffdraftcolor}
This sets the colour of the bounding box
when it is displayed in draft mode.
-\item
-\cmdname{setffdrafttypeblockcolor}
+\item
+\cmdname{setffdrafttypeblockcolor}
This sets the colour of
the bounding box of the typeblock when it is displayed
@@ -324,7 +316,7 @@ in draft mode.
\item \cmdname{fflabelfont}
-This sets the font size for the bounding box markers in
+This sets the font size for the bounding box markers in
draft mode.
\end{itemize}
@@ -341,7 +333,7 @@ bounding box at which to place the bounding box marker.
\item \cmdname{flowframesep}
This is the gap between the text of the frame and
-its border, for the standard border types.
+its border, for the standard border types.
\item \cmdname{flowframerule}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.pdf
new file mode 100644
index 00000000000..88dc5e0b92e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.tex
new file mode 100644
index 00000000000..f62944db3ae
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample-rot.tex
@@ -0,0 +1,49 @@
+ % This file is public domain.
+
+\documentclass[a4paper]{article}
+
+\usepackage[draft]{flowfram}
+\usepackage{supertabular}
+
+\newflowframe{0.3\textwidth}{0.25\textheight}{0.5\textwidth}{0.5\textheight}
+
+\newflowframe{0.3\textwidth}{0.2\textheight}{0pt}{0.1\textheight}
+
+\newflowframe{0.3\textwidth}{0.2\textheight}{0.5\textwidth}{0.1\textheight}
+
+\setflowframe{1}{angle=45}
+\setflowframe{3}{angle=90}
+
+\begin{document}
+
+This is a sample document illustrating the use of the
+flowfram package. The first flow frame has been rotated
+by an angle of 45 degrees. There is an asterisk in the
+margin\marginpar{*}. There is also a
+footnote\footnote{down here.}.
+
+\framebreak
+\begin{supertabular}{rl}
+1 & A\\
+2 & B\\
+3 & C\\
+4 & D\\
+5 & E\\
+6 & F\\
+7 & G\\
+8 & H\\
+9 & I\\
+10 & J\\
+11 & K\\
+12 & L\\
+13 & M\\
+14 & N\\
+15 & O\\
+16 & P\\
+17 & Q\\
+18 & R\\
+19 & S\\
+20 & T\\
+\end{supertabular}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample.pdf
new file mode 100644
index 00000000000..4a47a3bedb5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample.tex
new file mode 100644
index 00000000000..1bf6ccf6293
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample.tex
@@ -0,0 +1,379 @@
+ % This file is public domain.
+
+\documentclass[a4paper,twoside]{book}
+
+\usepackage{times}
+\usepackage{courier}
+\usepackage{helvet}
+\usepackage[margin=1in,top=1in,bottom=1in]{geometry}
+\usepackage[colorlinks,
+ linkcolor=black,
+ urlcolor=black,
+ plainpages=false,
+ pdfpagelabels=true]{hyperref}
+\usepackage{fancybox}
+\usepackage{color}
+\usepackage{flowfram}
+
+\newcommand{\sty}[1]{\textsf{#1}}
+\newcommand{\env}[1]{\textsf{#1}}
+\newcommand{\cmdname}[1]{\texttt{\symbol{92}#1}}
+\newcommand{\meta}[1]{\textnormal{\textless\textit{#1}\textgreater}}
+
+\newlength{\leftwidth}
+\newlength{\rightwidth}
+
+\computeleftedgeodd{\leftwidth}
+\setlength{\leftwidth}{-\leftwidth}
+\addtolength{\leftwidth}{0.4\textwidth}
+\setlength{\rightwidth}{\paperwidth}
+\addtolength{\rightwidth}{-\leftwidth}
+\vtwotone[1]{\leftwidth}{magenta}{backleft}{\rightwidth}{[cmyk]{0,0.48,0,0}}{backright}
+
+\vtwotone[none]{\rightwidth}{[cmyk]{0,0.48,0,0}}{lastbackright}{\leftwidth}{magenta}{lastbackleft}
+
+\vtwotonetop[odd]{1cm}{\leftwidth}{magenta}{oddtopleft}{\rightwidth}{[cmyk]{0,0.48,0,0}}{oddtopright}
+\vtwotonetop[even]{1cm}{\rightwidth}{[cmyk]{0,0.48,0,0}}{eventopleft}{\leftwidth}{magenta}{eventopright}
+
+\setlength{\marginparwidth}{2cm}
+
+\newflowframe{0.6\textwidth}{\textheight}{0pt}{0pt}[main]
+\newdynamicframe{0.38\textwidth}{\textheight}{0.62\textwidth}{0pt}[chaphead]
+
+\setflowframe*{main}{evenx=0.4\textwidth}
+\setdynamicframe*{chaphead}{evenx=0pt}
+
+\setflowframe*{main}{margin=inner}
+
+\dfchaphead*{chaphead}
+
+\appenddfminitoc*{chaphead}
+
+
+\renewcommand{\DFchapterstyle}[1]{%
+\raggedright\sffamily\bfseries\Huge\color{blue}#1\par
+}
+
+\renewcommand{\DFschapterstyle}[1]{\raggedright\sffamily\bfseries\Huge\color{blue} #1\par
+}
+
+
+\makethumbtabs{2in}
+\enableminitoc
+
+\setthumbtab{1}{backcolor=[rgb]{0.15,0.15,1}}
+\setthumbtab{2}{backcolor=[rgb]{0.2,0.2,1}}
+\setthumbtab{3}{backcolor=[rgb]{0.25,0.25,1}}
+\setthumbtab{4}{backcolor=[rgb]{0.3,0.3,1}}
+
+\newcommand{\thumbtabstyle}[1]{\textsc{\sffamily #1}}
+\setthumbtab{all}{style=thumbtabstyle,textcolor=white}
+
+
+\pagestyle{plain}
+
+\makedfheaderfooter
+
+\newlength{\xoffset}
+\computerightedgeodd{\xoffset}
+\addtolength{\xoffset}{-2cm}
+\newlength{\yoffset}
+\computebottomedge{\yoffset}
+
+\newcommand{\footstyle}[1]{\bfseries\LARGE #1}
+
+
+\setdynamicframe*{footer}{oddx=\xoffset,y=\yoffset,width=2cm,height=2cm,
+backcolor=blue,textcolor=white,style=footstyle,pages=none}
+
+
+\computeleftedgeeven{\xoffset}
+\setdynamicframe*{footer}{evenx=\xoffset}
+
+\begin{document}
+\ffswapoddeven*{main}% swap odd and even position of frame for the title page
+\dfswapoddeven*{chaphead}
+\title{Creating Flow Frames for Posters or Magazines}
+\author{Nicola L. C. Talbot\\[1cm]\url{http://www.dickimaw-books.com/}}
+\date{}
+\pagenumbering{alph}
+\maketitle
+
+\cleardoublepage
+\setstaticframe*{backleft}{pages=none}
+\setstaticframe*{backright}{pages=none}
+
+\frontmatter
+\tocandthumbtabindex
+\setdynamicframe*{footer}{pages=all}
+
+\clearpage
+\dfswapoddeven*{chaphead}
+\ffswapoddeven*{main}% swap back again
+
+\mainmatter
+\chapter{Introduction}
+\enablethumbtabs
+\pagenumbering{arabic}
+
+The \sty{flowfram} package is designed to enable you to create
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
+This is useful for creating posters\marginpar{A marginal note}
+or magazines or any other form of document that does not
+conform to the standard one or two column layout.
+
+This document has \themaxflow\ flow
+\ifthenelse{\value{maxflow}=1}{frame}{frames}, \themaxstatic\ static
+\ifthenelse{\value{maxstatic}=1}{frame}{frames} and
+\themaxdynamic\ dynamic \ifthenelse{\value{maxdynamic}=1}{frame}{frames}.
+
+\chapter{Setting up Frames}
+
+The \sty{flowfram} package provides three types of frame:
+{flow frames}, {static
+frames} and {dynamic frames}.
+
+\section{Flow Frames}
+
+The flow frame is the principle type of frame.
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
+position on the page, and optionally a border\footnote{A
+footnote!}.
+
+\section{Static Frames}
+
+A static frame is a rectangular area in which text neither
+flows into, nor flows out of. The contents must be set
+explicitly, and once set, the contents of the static frame will
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
+a company logo appear in the same place on every page.
+
+\section{Dynamic Frames}
+
+A dynamic frame is similar to a static frame, but its contents
+are re-typeset on each page. (A static frame stores its
+contents in a savebox, whereas a dynamic frame stores its
+contents in a macro).
+
+\chapter{Frame Attributes}
+\label{sec:modattr}
+
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
+same set of attributes, but some are specific to a certain type.
+The available attributes are as follows
+(\textsuperscript{\textbf{F}} indicates the key is
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
+for {static frames}
+and \textsuperscript{\textbf{D}} indicates the key
+is only available for {dynamic frames}):
+
+\begin{description}
+\item[width=\meta{length}] The width of the frame.
+
+\item[height=\meta{length}] The height of the frame.
+
+\item[x=\meta{length}] The x-coordinate of the frame.
+
+\item[y=\meta{length}] The y-coordinate of the frame.
+
+\item[border=\meta{style}] The style of the border around the
+frame, this can take the values: \texttt{none} (no border),
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
+The value \texttt{fbox} is equivalent to \texttt{plain}.
+
+\item[offset=\meta{offset}] The border offset, if it is a
+user-defined border. This is the distance from the outer
+edge of the left hand border to the left edge of the
+bounding box of the text inside the border. The \sty{flowfram}
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
+may end up shifted to the right or left.
+
+\item[bordercolor=\meta{colour}] The colour of the border
+if you are using a standard frame making command.
+The colour can either be specified as, e.g.\ \texttt{green},
+or including the colour model, e.g. \verb/[rgb]{0,1,0}/.
+
+\item[textcolor=\meta{colour}] The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
+e.g. \verb/[rgb]{0,1,0}/.
+
+\item[pages=\meta{page list}] The {list of
+pages} for which the frame
+should appear. This can either have the values: \texttt{all},
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+removes the frame from that point on---useful if you
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
+{page ranges}.
+
+\item[margin=\meta{side}\textsuperscript{F}] The side of
+the flow frame that its corresponding margin should go on. This
+can take the values \texttt{left} or \texttt{right}.
+
+\item[clear=\meta{boolean}\textsuperscript{S}] If this value
+is set, the static frame will be cleared at the start of the
+next page.
+
+\item[style=\meta{cmd}\textsuperscript{D}] This should be
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
+The command may either be a declaration, for example \verb/style=large/
+which will set the contents of all the dynamic frames in a
+large font, or it can be a command that takes a single argument,
+for example \verb/style=textbf/
+which will make the text for all the dynamic frames come out in
+bold. To unset a style, do \verb/style=none/.
+
+\end{description}
+
+\chapter{Miscellaneous}
+
+\section{Page Layout}
+
+The \sty{flowfram} package has the package option \texttt{draft}
+which will draw the {bounding boxes} for
+each frame defined. At the bottom right of each
+bounding box (except for the bounding box denoting the
+typeblock), a marker will be shown to indictate the type
+of frame, its IDN and its IDL.
+
+You can see the layout for the current page (irrespective of
+whether or not the \texttt{draft} option has been set) using
+the command:\newline
+\cmdname{flowframeshowlayout}
+
+The headers and footers will appear as usual (but will not
+be shown in draft mode), according to the format given by
+\cmdname{pagestyle}.
+
+\section{Frame Stacking Order}
+
+The material on each page is placed in the following order:
+\begin{enumerate}
+\item Each static frame defined for that page in ascending
+order of IDN.
+
+\item Each flow frame defined for that page in ascending
+order of IDN.
+
+\item Each dynamic frame defined for that page in ascending
+order of IDN.
+
+\item {Bounding boxes} if the \texttt{draft}
+package option has been used.
+\end{enumerate}
+
+This ordering can be used to determine if you want something
+to overlay or underlay everything else on the page.
+
+\section{Prematurely Ending a Flow Frame}
+
+You can force text to move immediately to the next defined
+flow frame using one of the standard \LaTeX\ page breaking commands
+which work in an analogous way to the way they
+work in standard two column mode.
+
+The command \cmdname{framebreak} is provided for situations
+where a paragraph spans two flow frames
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
+result, the end of the paragraph at the beginning of the new
+flow frame retains the width of the previous flow frame.
+
+If you want to start a new page, rather than simply move to the
+next frame, use the command\newline
+\cmdname{finishthispage}.
+
+\section{Floats}
+
+Since floats (such as figures and tables) can only go in
+{flow frames}, this package provides
+the additional environments:
+\env{staticfigure} and
+\env{statictable} which can be used in static frames
+and dynamic frames. Unlike their \env{figure} and
+\env{table} counterparts, they are fixed in place, and
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
+be used within \env{staticfigure} and \env{statictable} as
+usual.
+
+The standard \env{figure} and \env{table} commands will
+behave as usual in the flow frames, but their starred versions,
+\env{figure*} and \env{table*} behave no differently
+from \env{figure} and \env{table}.
+
+\section{Global Values}
+
+The following macros can be changed using \cmdname{renewcommand}:
+
+\begin{itemize}
+\item \cmdname{setffdraftcolor}
+
+This sets the colour of the bounding box
+when it is displayed in draft mode.
+
+\item
+\cmdname{setffdrafttypeblockcolor}
+
+This sets the colour of
+the bounding box of the typeblock when it is displayed
+in draft mode.
+
+\item \cmdname{fflabelfont}
+
+This sets the font size for the bounding box markers in
+draft mode.
+
+\end{itemize}
+
+The following are lengths, which can be changed using
+\cmdname{setlength}:
+\marginpar{Another marginal note}
+
+\begin{itemize}
+\item \cmdname{fflabelsep}
+
+This is the distance from the right hand side of the
+bounding box at which to place the bounding box marker.
+
+\item \cmdname{flowframesep}
+
+This is the gap between the text of the frame and
+its border, for the standard border types.
+
+\item \cmdname{flowframerule}
+
+This is the width of the frame's border, if using
+a border given by a frame making command that uses \cmdname{fboxsep}
+to set its border width.
+\end{itemize}
+
+\chapter*{Contact Details}
+\disablethumbtabs
+
+Dr Nicola Talbot\\
+School of Computing Sciences\\
+University of East Anglia\\
+Norwich. Norfolk. NR4 7TJ. UK\\
+\url{http://theoval.cmp.uea.ac.uk/~nlct/}
+
+\finishthispage\mbox{}
+\setdynamiccontents*{chaphead}{}
+\setdynamicframe*{footer}{pages=none}
+\setstaticframe*{lastbackleft,lastbackright}{pages=even}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample1.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample1.pdf
new file mode 100644
index 00000000000..f1798b9c6a6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample1.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample1.tex
new file mode 100644
index 00000000000..6fd4d999fc4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample1.tex
@@ -0,0 +1,305 @@
+ % This file is public domain.
+
+\documentclass[a4paper]{article}
+
+\usepackage[a4paper,landscape,margin=1in]{geometry}
+\usepackage{fancybox}
+\usepackage{color}
+\usepackage{flowfram}
+
+\showframebboxtrue
+\showtypeblocktrue
+
+
+\NcolumnStop{4}{1in}
+
+\setflowframe{3,4}{pages={>1}}
+\twocolumnSbottominarea[1]{1in}{0.5\textwidth}{\flowframeheight{3}}{0.5\textwidth}{0pt}
+
+\begin{staticcontents}{2}
+The page layout for this document was obtained with
+the following commands:
+\begin{verbatim}
+\NcolumnStop{4}{1in}
+\setflowframe{3,4}{pages={>1}}
+\twocolumnSbottominarea[1]{1in}{0.5\textwidth}{flowframeheight{3}}
+{0.5\textwidth}{0pt}
+\end{verbatim}
+\end{staticcontents}
+
+\newcommand{\sty}[1]{\textsf{#1}}
+\newcommand{\env}[1]{\textsf{#1}}
+\newcommand{\cmdname}[1]{\texttt{\symbol{92}#1}}
+\newcommand{\meta}[1]{\textnormal{\textless\textit{#1}\textgreater}}
+
+\raggedright
+
+\begin{document}
+
+\begin{staticcontents}{1}
+\title{Creating Flow Frames for Posters or Magazines}
+\author{Nicola L. C. Talbot}
+\date{}
+\maketitle
+\end{staticcontents}
+
+This is a modified version of the manual for the \sty{flowfram} package.
+It is intended to illustrated what can be done. See the full manual for
+a comprehensive description.
+
+If the columns are very narrow, it may be better to
+use \cmdname{raggedright}, otherwise \TeX\ may have a
+problem working out the line breaks.
+
+\section{Introduction}
+
+The \sty{flowfram} package is designed to enable you to create
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
+This is useful for creating posters
+or magazines or any other form of document that does not
+conform to the standard one or two column layout.
+
+\section{Setting up Frames}
+
+The \sty{flowfram} package provides three types of frame:
+{flow frames}, {static
+frames} and {dynamic frames}.
+
+\subsection{Flow Frames}
+
+The flow frame is the principle type of frame.
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
+position on the page, and optionally a border.
+
+It is recommended that all the flow frames in a document
+have the same width, otherwise problems may occur
+when a paragraph spans to flow frames of unequal
+widths. This is because \TeX's output routine does not
+register the change in \cmdname{hsize} until it reaches
+a paragraph break. If it is absolutely necessary for
+flow frames to have unequal widths, judicious use of
+\cmdname{framebreak} is required.
+
+\subsection{Static Frames}
+
+A static frame is a rectangular area in which text neither
+flows into, nor flows out of. The contents must be set
+explicitly, and once set, the contents of the static frame will
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
+a company logo appear in the same place on every page.
+
+\subsection{Dynamic Frames}
+
+A dynamic frame is similar to a static frame, but its contents
+are re-typeset on each page. (A static frame stores its
+contents in a savebox, whereas a dynamic frame stores its
+contents in a macro).
+
+\section{Frame Attributes}
+\label{sec:modattr}
+
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
+same set of attributes, but some are specific to a certain type.
+The available attributes are as follows
+(\textsuperscript{\textbf{F}} indicates the key is
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
+for {static frames}
+and \textsuperscript{\textbf{D}} indicates the key
+is only available for {dynamic frames}):
+
+\begin{description}
+\item[width=\meta{length}] The width of the frame.
+
+\item[height=\meta{length}] The height of the frame.
+
+\item[x=\meta{length}] The x-coordinate of the frame.
+
+\item[y=\meta{length}] The y-coordinate of the frame.
+
+\item[border=\meta{style}] The style of the border around the
+frame, this can take the values: \texttt{none} (no border),
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
+The value \texttt{fbox} is equivalent to \texttt{plain}.
+
+\item[offset=\meta{offset}] The border offset, if it is a
+user-defined border. This is the distance from the outer
+edge of the left hand border to the left edge of the
+bounding box of the text inside the border. The \sty{flowfram}
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
+may end up shifted to the right or left.
+
+\item[bordercolor=\meta{colour}] The colour of the border
+if you are using a standard frame making command.
+The colour can either be specified as, e.g.\ \texttt{green},
+or including the colour model, e.g. \verb/[rgb]{0,1,0}/.
+
+\item[textcolor=\meta{colour}] The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
+e.g. \verb/[rgb]{0,1,0}/.
+
+\item[pages=\meta{page list}] The {list of
+pages} for which the frame
+should appear. This can either have the values: \texttt{all},
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+removes the frame from that point on---useful if you
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
+{page ranges}.
+
+\item[margin=\meta{side}\textsuperscript{F}] The side of
+the flow frame that its corresponding margin should go on. This
+can take the values \texttt{left} or \texttt{right}.
+
+\item[clear=\meta{boolean}\textsuperscript{S}] If this value
+is set, the static frame will be cleared at the start of the
+next page.
+
+\item[style=\meta{cmd}\textsuperscript{D}] This should be
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
+The command may either be a declaration, for example \verb/style=large/
+which will set the contents of all the dynamic frames in a
+large font, or it can be a command that takes a single argument,
+for example \verb/style=textbf/
+which will make the text for all the dynamic frames come out in
+bold. To unset a style, do \verb/style=none/.
+
+\end{description}
+
+\section{Miscellaneous}
+
+\subsection{Page Layout}
+
+The \sty{flowfram} package has the package option \texttt{draft}
+which will draw the {bounding boxes} for
+each frame defined. At the bottom right of each
+bounding box (except for the bounding box denoting the
+typeblock), a marker will be shown to indictate the type
+of frame, its IDN and its IDL.
+
+You can see the layout for the current page (irrespective of
+whether or not the \texttt{draft} option has been set) using
+the command:\newline
+\cmdname{flowframeshowlayout}
+
+The headers and footers will appear as usual (but will not
+be shown in draft mode), according to the format given by
+\cmdname{pagestyle}.
+
+\subsection{Frame Stacking Order}
+
+The material on each page is placed in the following order:
+\begin{enumerate}
+\item Each static frame defined for that page in ascending
+order of IDN.
+
+\item Each flow frame defined for that page in ascending
+order of IDN.
+
+\item Each dynamic frame defined for that page in ascending
+order of IDN.
+
+\item {Bounding boxes} if the \texttt{draft}
+package option has been used.
+\end{enumerate}
+
+This ordering can be used to determine if you want something
+to overlay or underlay everything else on the page.
+
+\subsection{Prematurely Ending a Flow Frame}
+
+You can force text to move immediately to the next defined
+flow frame using one of the standard \LaTeX\ page breaking commands
+which work in an analogous way to the way they
+work in standard two column mode.
+
+The command \cmdname{framebreak} is provided for situations
+where a paragraph spans two flow frames
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
+result, the end of the paragraph at the beginning of the new
+flow frame retains the width of the previous flow frame.
+
+If you want to start a new page, rather than simply move to the
+next frame, use the command\newline
+\cmdname{finishthispage}.
+
+\subsection{Floats}
+
+Since floats (such as figures and tables) can only go in
+{flow frames}, this package provides
+the additional environments:
+\env{staticfigure} and
+\env{statictable} which can be used in static frames
+and dynamic frames. Unlike their \env{figure} and
+\env{table} counterparts, they are fixed in place, and
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
+be used within \env{staticfigure} and \env{statictable} as
+usual.
+
+The standard \env{figure} and \env{table} commands will
+behave as usual in the flow frames, but their starred versions,
+\env{figure*} and \env{table*} behave no differently
+from \env{figure} and \env{table}.
+
+\subsection{Global Values}
+
+The following macros can be changed using \cmdname{renewcommand}:
+
+\begin{itemize}
+\item \cmdname{setffdraftcolor}
+
+This sets the colour of the bounding box
+when it is displayed in draft mode.
+
+\item
+\cmdname{setffdrafttypeblockcolor}
+
+This sets the colour of
+the bounding box of the typeblock when it is displayed
+in draft mode.
+
+\item \cmdname{fflabelfont}
+
+This sets the font size for the bounding box markers in
+draft mode.
+
+\end{itemize}
+
+The following are lengths, which can be changed using
+\cmdname{setlength}:
+
+\begin{itemize}
+\item \cmdname{fflabelsep}
+
+This is the distance from the right hand side of the
+bounding box at which to place the bounding box marker.
+
+\item \cmdname{flowframesep}
+
+This is the gap between the text of the frame and
+its border, for the standard border types.
+
+\item \cmdname{flowframerule}
+
+This is the width of the frame's border, if using
+a border given by a frame making command that uses \cmdname{fboxsep}
+to set its border width.
+\end{itemize}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample2.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample2.pdf
new file mode 100644
index 00000000000..06633932a57
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample2.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample2.tex
new file mode 100644
index 00000000000..d1ca0992234
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample2.tex
@@ -0,0 +1,272 @@
+ % This file is public domain.
+
+\documentclass[a4paper,twoside]{report}
+
+\usepackage{url}
+
+\newcommand{\cmdname}[1]{\texttt{\char`\\#1}}
+\newcommand{\sty}[1]{\texttt{#1}}
+\newcommand{\env}[1]{\texttt{#1}}
+\newcommand{\meta}[1]{$\langle$\emph{#1}$\rangle$}
+
+\begin{document}
+
+\title{Creating Flow Frames for Posters or Magazines}
+\author{Nicola L. C. Talbot\\[1cm]\url{http://www.dickimaw-books.com/}}
+\date{}
+\pagenumbering{alph}
+\maketitle
+
+\pagenumbering{roman}
+\tableofcontents
+
+\chapter{Introduction}
+\pagenumbering{arabic}
+
+The \sty{flowfram} package is designed to enable you to create
+frames in a document such that the
+contents of the \env{document} environment flow from one
+frame to the next in the order that they were defined.
+This is useful for creating posters
+or magazines or any other form of document that does not
+conform to the standard one or two column layout.
+
+\chapter{Setting up Frames}
+
+The \sty{flowfram} package provides three types of frame:
+{flow frames}, {static
+frames} and {dynamic frames}.
+
+\section{Flow Frames}
+
+The flow frame is the principle type of frame.
+The text of the \env{document} environment will flow from
+one frame to the next in order of definition. Each
+flow frame has an associated width, height,
+position on the page, and optionally a border.
+
+\section{Static Frames}
+
+A static frame is a rectangular area in which text neither
+flows into, nor flows out of. The contents must be set
+explicitly, and once set, the contents of the static frame will
+remain the same on each page until it is explicitly
+changed. Thus, a static frame can be used, for example, to make
+a company logo appear in the same place on every page.
+
+\section{Dynamic Frames}
+
+A dynamic frame is similar to a static frame, but its contents
+are re-typeset on each page. (A static frame stores its
+contents in a savebox, whereas a dynamic frame stores its
+contents in a macro).
+
+\chapter{Frame Attributes}
+\label{sec:modattr}
+
+Once you have defined the {flow frames}, {static frames} and
+{dynamic frames}, their attributes can be changed.
+The three types of frame mostly have the
+same set of attributes, but some are specific to a certain type.
+The available attributes are as follows
+(\textsuperscript{\textbf{F}} indicates the key is
+only available for {flow frames},
+\textsuperscript{\textbf{S}} indicates the key is only available
+for {static frames}
+and \textsuperscript{\textbf{D}} indicates the key
+is only available for {dynamic frames}):
+
+\begin{description}
+\item[width=\meta{length}] The width of the frame.
+
+\item[height=\meta{length}] The height of the frame.
+
+\item[x=\meta{length}] The x-coordinate of the frame.
+
+\item[y=\meta{length}] The y-coordinate of the frame.
+
+\item[border=\meta{style}] The style of the border around the
+frame, this can take the values: \texttt{none} (no border),
+\texttt{plain} (plain border) or the name of a \LaTeX\
+frame making command without the preceding backslash.
+The value \texttt{fbox} is equivalent to \texttt{plain}.
+
+\item[offset=\meta{offset}] The border offset, if it is a
+user-defined border. This is the distance from the outer
+edge of the left hand border to the left edge of the
+bounding box of the text inside the border. The \sty{flowfram}
+package is able to compute the border for
+known frame making commands.
+If you define your own frame making command, you may need to
+specify the offset explicitly, or the frames
+may end up shifted to the right or left.
+
+\item[bordercolor=\meta{colour}] The colour of the border
+if you are using a standard frame making command.
+The colour can either be specified as, e.g.\ \texttt{green},
+or including the colour model, e.g. \verb/[rgb]{0,1,0}/.
+
+\item[textcolor=\meta{colour}] The text colour for that
+frame. Again, the colour can either be specified as,
+e.g.\ \texttt{green}, or including the colour model,
+e.g. \verb/[rgb]{0,1,0}/.
+
+\item[pages=\meta{page list}] The {list of
+pages} for which the frame
+should appear. This can either have the values: \texttt{all},
+\texttt{even}, \texttt{odd} or \texttt{none} (the latter
+removes the frame from that point on---useful if you
+have multiple pages with the same number), or it can be a
+comma-separated list of single pages, or
+{page ranges}.
+
+\item[margin=\meta{side}\textsuperscript{F}] The side of
+the flow frame that its corresponding margin should go on. This
+can take the values \texttt{left} or \texttt{right}.
+
+\item[clear=\meta{boolean}\textsuperscript{S}] If this value
+is set, the static frame will be cleared at the start of the
+next page.
+
+\item[style=\meta{cmd}\textsuperscript{D}] This should be
+the name of a command \emph{without} the preceding backslash,
+to be applied to the contents of the specified dynamic frame.
+The command may either be a declaration, for example \verb/style=large/
+which will set the contents of all the dynamic frames in a
+large font, or it can be a command that takes a single argument,
+for example \verb/style=textbf/
+which will make the text for all the dynamic frames come out in
+bold. To unset a style, do \verb/style=none/.
+
+\end{description}
+
+\chapter{Miscellaneous}
+
+\section{Page Layout}
+
+The \sty{flowfram} package has the package option \texttt{draft}
+which will draw the {bounding boxes} for
+each frame defined. At the bottom right of each
+bounding box (except for the bounding box denoting the
+typeblock), a marker will be shown to indictate the type
+of frame, its IDN and its IDL.
+
+You can see the layout for the current page (irrespective of
+whether or not the \texttt{draft} option has been set) using
+the command:\newline
+\cmdname{flowframeshowlayout}
+
+The headers and footers will appear as usual (but will not
+be shown in draft mode), according to the format given by
+\cmdname{pagestyle}.
+
+\section{Frame Stacking Order}
+
+The material on each page is placed in the following order:
+\begin{enumerate}
+\item Each static frame defined for that page in ascending
+order of IDN.
+
+\item Each flow frame defined for that page in ascending
+order of IDN.
+
+\item Each dynamic frame defined for that page in ascending
+order of IDN.
+
+\item {Bounding boxes} if the \texttt{draft}
+package option has been used.
+\end{enumerate}
+
+This ordering can be used to determine if you want something
+to overlay or underlay everything else on the page.
+
+\section{Prematurely Ending a Flow Frame}
+
+You can force text to move immediately to the next defined
+flow frame using one of the standard \LaTeX\ page breaking commands
+which work in an analogous way to the way they
+work in standard two column mode.
+
+The command \cmdname{framebreak} is provided for situations
+where a paragraph spans two flow frames
+of different widths, as \TeX's output routine does not
+adjust to the new value of \cmdname{hsize} until the last
+paragraph of the previous frame has ended. As a
+result, the end of the paragraph at the beginning of the new
+flow frame retains the width of the previous flow frame.
+
+If you want to start a new page, rather than simply move to the
+next frame, use the command\newline
+\cmdname{finishthispage}.
+
+\section{Floats}
+
+Since floats (such as figures and tables) can only go in
+{flow frames}, this package provides
+the additional environments:
+\env{staticfigure} and
+\env{statictable} which can be used in static frames
+and dynamic frames. Unlike their \env{figure} and
+\env{table} counterparts, they are fixed in place, and
+so do not take an optional placement specifier. The
+\cmdname{caption} and \cmdname{label} commands can
+be used within \env{staticfigure} and \env{statictable} as
+usual.
+
+The standard \env{figure} and \env{table} commands will
+behave as usual in the flow frames, but their starred versions,
+\env{figure*} and \env{table*} behave no differently
+from \env{figure} and \env{table}.
+
+\section{Global Values}
+
+The following macros can be changed using \cmdname{renewcommand}:
+
+\begin{itemize}
+\item \cmdname{setffdraftcolor}
+
+This sets the colour of the bounding box
+when it is displayed in draft mode.
+
+\item
+\cmdname{setffdrafttypeblockcolor}
+
+This sets the colour of
+the bounding box of the typeblock when it is displayed
+in draft mode.
+
+\item \cmdname{fflabelfont}
+
+This sets the font size for the bounding box markers in
+draft mode.
+
+\end{itemize}
+
+The following are lengths, which can be changed using
+\cmdname{setlength}:
+
+\begin{itemize}
+\item \cmdname{fflabelsep}
+
+This is the distance from the right hand side of the
+bounding box at which to place the bounding box marker.
+
+\item \cmdname{flowframesep}
+
+This is the gap between the text of the frame and
+its border, for the standard border types.
+
+\item \cmdname{flowframerule}
+
+This is the width of the frame's border, if using
+a border given by a frame making command that uses \cmdname{fboxsep}
+to set its border width.
+\end{itemize}
+
+\chapter*{Contact Details}
+
+Dr Nicola Talbot\\
+Dickimaw Books\\
+\url{http://www.dickimaw-books.com/}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample3.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sample3.pdf
new file mode 100644
index 00000000000..f22dd7c2af4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample3.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sample3.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sample3.tex
new file mode 100644
index 00000000000..56bfcf79813
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sample3.tex
@@ -0,0 +1,65 @@
+ % This file is public domain.
+
+\documentclass{article}
+
+\usepackage{color}
+\usepackage[draft]{flowfram}
+\usepackage{tikz}
+\usetikzlibrary{snakes}
+
+\newstaticframe[1,2]{3in}{3in}{0pt}{0pt}[sf1]
+\newdynamicframe[1,3]{2in}{3in}{0.5\textwidth}{0.5\textheight}[df1]
+
+\newstaticframe[2]{3in}{3in}{0.5\textwidth}{0.5\textheight}[sf2]
+
+\newdynamicframe[3]{2in}{2in}{0.5\textwidth}{0pt}[df2]
+
+\setlength{\sdfparindent}{\parindent}
+
+\onecolumn
+
+\newlength\fancywidth
+\newlength\fancyheight
+\newlength\fancydepth
+
+\newcommand{\fancyframe}[1]{%
+\settowidth{\fancywidth}{#1}%
+\settoheight{\fancyheight}{#1}%
+\settodepth{\fancydepth}{#1}%
+\addtolength{\fancyheight}{\fancydepth}%
+\hspace{-\flowframesep}%
+\tikz[baseline=0pt]{%
+\draw[snake=bumps,raise snake=\flowframesep,line width=\flowframerule]
+ (0pt,0pt)
+ rectangle (\fancywidth,\fancyheight);
+}}
+
+\begin{document}
+\setstaticframe{1,2}{valign=t}
+\setstaticframe{1}{border=fancyframe}
+\setstaticcontents{1}{Top\par
+\vfill
+Bottom}
+
+
+\mbox{}
+
+\newpage\mbox{}
+
+\begin{staticcontents*}{sf1}
+Some text on the left static frame.
+\continueonframe[continued \relativeframelocation{static}{2}{static}{1}]{sf2}
+Some more text on the right static frame, and
+some more text to pad it out a bit.
+\end{staticcontents*}
+
+\newpage\mbox{}
+
+\begin{dynamiccontents}{1}
+Some text in the first dynamic frame.
+\continueonframe[continued \reldynamicloc*{df2}{df1}]{2}
+Some more text in the second dynamic frame, and
+some more text to pad it out a bit.
+\end{dynamiccontents}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.pdf b/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.pdf
new file mode 100644
index 00000000000..079ae70299e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.tex b/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.tex
new file mode 100644
index 00000000000..48f4f5e615d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/flowfram/samples/sampleRL.tex
@@ -0,0 +1,16 @@
+ % This file is public domain.
+
+\documentclass{article}
+
+\usepackage{lipsum}
+\usepackage[RL,draft]{flowfram}
+
+\twocolumn
+
+\begin{document}
+This is the start of the text.
+
+\lipsum
+
+This is the end of the text.
+\end{document}