flippdf (13oct20)

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

2 files changed, 163 insertions, 84 deletions

diff --git a/Master/texmf-dist/source/latex/flippdf/flippdf.dtx b/Master/texmf-dist/source/latex/flippdf/flippdf.dtx
index a285e1b097b..cc775ee1137 100644
--- a/Master/texmf-dist/source/latex/flippdf/flippdf.dtx
+++ b/Master/texmf-dist/source/latex/flippdf/flippdf.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright 2006
+% Copyright 2006, 2020
 % Sergio Callegari <sergio.callegari@gmail.com>
 %
 % ---------------------------------------------
@@ -9,9 +9,8 @@
 % ---------------------------------------------
 %
 % It may be distributed and/or modified under the conditions of the
-% LaTeX Project Public License, either version 1.3 of this licence, or
-% any later version. The latest version of this license is at
-% http://www.latex-project.org/lppl.txt and version 1.3 is part
+% LaTeX Project Public License, version 1.3c of this licence.
+% This license is at http://www.latex-project.org/lppl.txt and is part
 % of all distributions of LaTeX version 2003/06/01 or later.
 %
 % This work has the LPPL maintenance status "author-maintained".
@@ -21,12 +20,12 @@
 %
 %<*driver>
 \documentclass{ltxdoc}
-\usepackage{mathptmx, helvet, courier}
+\usepackage{mathptmx}
+\usepackage{helvet}
+\usepackage{hologo}
+\usepackage[T1]{fontenc}
+\usepackage{hypdoc}
 \EnableCrossrefs
-\DoNotIndex{\NeedsTeXFormat,\ProcessOptions}
-\DoNotIndex{\def,\gdef,\let,\newcommand}
-\DoNotIndex{\ProvidesPackage,\RequirePackage,\DeclareOption,\endinput}
-\DoNotIndex{\ifx,\fi,\paperwidth,\space,\strip@pt,\newif}
 \CodelineIndex
 \RecordChanges
 \begin{document}
@@ -36,12 +35,21 @@
 %
 % \fi
 %
-% \CheckSum{23}
+% \DoNotIndex{\NeedsTeXFormat, \documentclass}
+% \DoNotIndex{\begin, \end}
+% \DoNotIndex{\def, \gdef, \let, \newcommand}
+% \DoNotIndex{\ProvidesPackage, \RequirePackage, \usepackage}
+% \DoNotIndex{\DeclareOption, \ProcessOptions}
+% \DoNotIndex{\ifx, \fi, \newif}
+% \DoNotIndex{\paperwidth, \space, \strip@pt}
+% \DoNotIndex{\maketitle, \title, \lipsum}
+%
+% \CheckSum{22}
 %
 % \def\filename{flippdf.dtx}
-% \def\fileversion{1.0}
-% \def\filedate{2006/06/30}
-% \def\docdate{2006/06/30}
+% \def\fileversion{1.0b}
+% \def\filedate{2020/10/11}
+% \def\docdate{2020/10/11}
 %
 % \newcommand*{\Lpack}[1]{\textsf {#1}}           ^^A typeset a package
 % \newcommand*{\Lopt}[1]{\textsf {#1}}            ^^A typeset an option
@@ -63,30 +71,30 @@
 % \maketitle
 %
 % \begin{abstract}
-%   The \Lpack{pdfflip} package extends pdf\LaTeX\ making it possible
-%   to typeset a ``mirrored'' version of the document. This is
-%   sometimes required by publishers who want ``camera-ready''
-%   documents to be printable on transparent films, so that one reads
-%   the pages correctly by looking \emph{through} the film (i.e., with
-%   the \emph{unprinted} side of the film towards his eyes. This
-%   package requires \Lpack{everypage} by the same author and works
-%   with pdf\LaTeX\ only.
+%   The \Lpack{pdfflip} package extends \hologo{pdfLaTeX} making it
+%   possible to typeset a ``mirrored'' version of the document. This is
+%   sometimes required by publishers who use photographic printing
+%   processes that need ``camera-ready'' documents to be printable on
+%   transparent films, so that one reads the pages correctly by looking
+%   \emph{through} the film with the \emph{unprinted} side of the film
+%   towards his eyes. This package requires \Lpack{everypage} by the same
+%   author and works with \hologo{pdfLaTeX} only.
 % \end{abstract}
 % 
 % \section{Introduction}
 % 
-% This \LaTeX\ package makes it possible to typeset a document
-% horizontally flipping its pages. This is sometimes required by
-% publishers who want ``camera-ready'' documents to be printable on
-% transparent films, so that one reads the pages correctly by looking
-% \emph{through} the film (i.e., with the \emph{unprinted} side of the
-% film towards his eyes.
+% This \LaTeX\ package makes it possible to typeset a document flipping
+% its pages horizontally. This is sometimes required by publishers who use
+% photographic printing process that need ``camera-ready'' documents to be
+% printable on transparent films, so that one reads the pages correctly by
+% looking \emph{through} the film (i.e., with the \emph{unprinted} side of
+% the film towards his eyes).
 %
 % It is also possible to activate the mirroring capability on a page
 % by page basis.
 %
 % This package requires \Lpack{everypage} by the same author and works
-% with pdf\LaTeX\ only.
+% with \hologo{pdfLaTeX} only.
 %
 % \section{User interface}
 % By default, once loaded as:
@@ -101,29 +109,99 @@
 % \end{quote}
 % The package is loaded but remains inactive.
 %
-% \DescribeMacro{\FlipPDF}\DescribeMacro{\UnFlipPDF}
-% The |\FlipPDF| command lets one switch on page flipping. Conversely,
-% |\UnFlipPDF| switches off page flipping.
-% 
+% \DescribeMacro{\FlipPDF} The |\FlipPDF| command lets one switch on page
+% flipping. Conversely, \DescribeMacro{\UnFlipPDF}|\UnFlipPDF| switches
+% off page flipping.
+%
+%
+% \section{Examples}
+% \subsection{Plain case}
+% In this example, every page of the document is flipped, relying on the
+% automatic operation mode of the package.
+% \iffalse
+%<*test-1>
+% \fi
+%    \begin{macrocode}
+\documentclass[a4paper]{article}
+\usepackage{flippdf}
+\usepackage{lipsum}
+
+\title{Test document for the flippdf package}
+
+\begin{document}
+\maketitle
+\lipsum[1-5]
+\end{document}
+%    \end{macrocode}
+% \iffalse
+%</test-1>
+% \fi
+%
+% \subsection{Case with activation and deactivation}
+% In this example, the page flipping is manually activated and deactivated.
+% \iffalse
+%<*test-2>
+% \fi
+%    \begin{macrocode}
+\documentclass[a4paper]{article}
+\usepackage[off]{flippdf}
+\usepackage{lipsum}
+
+\title{Test document for the flippdf package}
+
+\begin{document}
+
+\thispagestyle{empty}
+{\Large Some non-mirrored initial info}
+
+\bigskip
+
+\lipsum[1]
+
+\maketitle
+\setcounter{page}{1}
+\FlipPDF
+\lipsum[2-6]
+
+\clearpage
+\UnFlipPDF
+\thispagestyle{empty}
+{\Large Some non-mirrored final info}
+
+\bigskip
+
+\lipsum[7]
+\end{document}
+%    \end{macrocode}
+% \iffalse
+%</test-2>
+% \fi
+%
 % \StopEventually {}
 % 
 % \section{Implementation}
 %
-% Announce the name and version of the package, which requires
-% \LaTeXe (actually pdfLaTeX).
+% \iffalse
+%<*flippdf>
+% \fi
+% Announce the name and version of the package, that requires
+% \hologo{LaTeX2e} (actually \hologo{pdfLaTeX}).
+% \changes{R1.0b}{2020/10/11}{%
+%  Require \Lpack{everypage} package to be at least at its 2007/06/20 (R1.1)
+%  release.}
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{flippdf}%
-  [2006/06/30 1.0 Horizontal flipping of pages with pdfLaTeX]
+  [2020/10/11 1.0b Horizontal flipping of pages with pdfLaTeX]
 %    \end{macrocode}
 %
-% Reminds the dependence on \Lpack{everypage}.
+% Assure that the dependence on \Lpack{everypage} is satisfied.
 %    \begin{macrocode}
-\RequirePackage{everypage}
+\RequirePackage{everypage}[2007/06/20]
 %    \end{macrocode}
 % \begin{macro}{\if@sc@flippdf}
 %
-% Defines a boolean variable to remember if pages are to be flipped or
+% Define a boolean variable to remember if pages are to be flipped or
 % not.
 %    \begin{macrocode}
 \newif\if@sc@flippdf
@@ -157,30 +235,33 @@
   \if@sc@flippdf
   \pdfliteral direct {-1 0 0 1 \strip@pt\paperwidth\space 0 cm}
   \fi}
-\endinput
 %    \end{macrocode}
+% \iffalse
+%</flippdf>
+% \fi
 %
 % \Finale
+% \PrintChanges
 % \PrintIndex
 %
-%% \CharacterTable
-%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
-%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
-%%   Digits        \0\1\2\3\4\5\6\7\8\9
-%%   Exclamation   \!     Double quote  \"     Hash (number) \#
-%%   Dollar        \$     Percent       \%     Ampersand     \&
-%%   Acute accent  \'     Left paren    \(     Right paren   \)
-%%   Asterisk      \*     Plus          \+     Comma         \,
-%%   Minus         \-     Point         \.     Solidus       \/
-%%   Colon         \:     Semicolon     \;     Less than     \<
-%%   Equals        \=     Greater than  \>     Question mark \?
-%%   Commercial at \@     Left bracket  \[     Backslash     \\
-%%   Right bracket \]     Circumflex    \^     Underscore    \_
-%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
-%%   Right brace   \}     Tilde         \~}
+% \CharacterTable
+%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%   Digits        \0\1\2\3\4\5\6\7\8\9
+%   Exclamation   \!     Double quote  \"     Hash (number) \#
+%   Dollar        \$     Percent       \%     Ampersand     \&
+%   Acute accent  \'     Left paren    \(     Right paren   \)
+%   Asterisk      \*     Plus          \+     Comma         \,
+%   Minus         \-     Point         \.     Solidus       \/
+%   Colon         \:     Semicolon     \;     Less than     \<
+%   Equals        \=     Greater than  \>     Question mark \?
+%   Commercial at \@     Left bracket  \[     Backslash     \\
+%   Right bracket \]     Circumflex    \^     Underscore    \_
+%   Grave accent  \`     Left brace    \{     Vertical bar  \|
+%   Right brace   \}     Tilde         \~}
 \endinput
 
-%%% Local Variables: 
-%%% mode: doctex
-%%% TeX-master: t
-%%% End: 
+% %% Local Variables: 
+% %% mode: doctex
+% %% TeX-master: t
+% %% End: 
diff --git a/Master/texmf-dist/source/latex/flippdf/flippdf.ins b/Master/texmf-dist/source/latex/flippdf/flippdf.ins
index 97cd63c3ff7..0b917030470 100644
--- a/Master/texmf-dist/source/latex/flippdf/flippdf.ins
+++ b/Master/texmf-dist/source/latex/flippdf/flippdf.ins
@@ -1,5 +1,5 @@
 %% flippdf.ins
-%% Copyright 2006
+%% Copyright 2006, 2020
 %% Sergio Callegari <sergio.callegari@gmail.com>
 %%
 %% ---------------------------------------------
@@ -8,9 +8,8 @@
 %% ---------------------------------------------
 %%
 %% It may be distributed and/or modified under the conditions of the
-%% LaTeX Project Public License, either version 1.3 of this licence, or
-%% any later version. The latest version of this license is at
-%% http://www.latex-project.org/lppl.txt and version 1.3 is part
+%% LaTeX Project Public License, version 1.3c. This version of the
+%% license is at http://www.latex-project.org/lppl.txt and is part
 %% of all distributions of LaTeX version 2003/06/01 or later.
 %%
 %% This work has the LPPL maintenance status "author-maintained".
@@ -25,17 +24,12 @@
 %% --------------- start of docstrip commands ------------------
 %%
 \input docstrip.tex
-\preamble
-This is file `flippdf.sty',
-generated with the docstrip utility.
-
-The original source files were:
 
-flippdf.dtx
+\preamble
 
  IMPORTANT NOTICE:
 
-Copyright 2006
+Copyright 2006, 2020
 Sergio Callegari <sergio.callegari@gmail.com>
 
 ---------------------------------------------
@@ -47,21 +41,25 @@ This program consists of the files listed in the README file included
 in the package.
 
 Any modified versions of this file must be renamed with new filenames
-distinct from flippdf.sty.
+distinct from \outFileName.
 
-For distribution of the original source see the terms
-for copying and modification in the file flippdf.dtx.
+For distribution of the original source see the terms for copying and
+modification in the file \inFileName.
 
-This generated file may be distributed as long as the
-original source files, as listed above, are part of the
-same distribution. (The sources need not necessarily be
-in the same archive or directory.)
+This generated file may be distributed as long as the original source files, as
+listed above, are part of the same distribution. (The sources need not
+necessarily be in the same archive or directory.)
 
 \endpreamble
 
 \keepsilent
 \Msg{*** Generating the LaTeX2e package files ***}
-\generate{\file{flippdf.sty}{\from{flippdf.dtx}{}}}
+\usedir{tex/latex/flippdf}
+\generate{\file{flippdf.sty}{\from{flippdf.dtx}{flippdf}}}
+\usedir{doc/latex/flippdf/examples}
+\generate{\file{test-flippdf-1}{\from{flippdf.dtx}{test-1}}}
+\generate{\file{test-flippdf-2}{\from{flippdf.dtx}{test-2}}}
+
 \ReportTotals
 
 \Msg{***********************************************************}
@@ -72,13 +70,13 @@ in the same archive or directory.)
 \Msg{* \space\space flippdf.sty}
 \Msg{*}
 \Msg{*}
-\Msg{* To produce the documentation run the files ending with}
-\Msg{* `.dtx' through LaTeX (or maybe pdfLaTeX).}
-\Msg{* Process any name.idx file by:}
-\Msg{* \space\space\space\space makeindex -s gind.ist name}
-\Msg{* Process any name.glo file by:}
-\Msg{* \space\space\space\space makeindex -s gglo.ist -o name.gls name.glo}
-\Msg{* Re run through LaTeX the .dtx files as necessary}
+\Msg{* To produce the documentation:}
+\Msg{*  - run flippdf.dtx through LaTeX}
+\Msg{*  - process flippdf.idx by:}
+\Msg{* \space\space\space\space makeindex -s gind.ist flippdf}
+\Msg{* Process flippdf.glo by:}
+\Msg{* \space\space\space\space makeindex -s gglo.ist -o flippdf.gls flippdf.glo}
+\Msg{* Re run through LaTeX the flippdf.dtx as necessary}
 \Msg{*}
 \Msg{***********************************************************}