summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-10-13 20:52:40 +0000
committerKarl Berry <karl@freefriends.org>2020-10-13 20:52:40 +0000
commitfaf01bf38b7c442d8acc93d3ea124c6eeaecf882 (patch)
treee11eb3847bb805a25f45a4d304700d51b7ab678d /Master/texmf-dist/source
parentbe5b1768f4f6169a51c0b7357f5bd2a0710e507f (diff)
flippdf (13oct20)
git-svn-id: svn://tug.org/texlive/trunk@56652 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source')
-rw-r--r--Master/texmf-dist/source/latex/flippdf/flippdf.dtx197
-rw-r--r--Master/texmf-dist/source/latex/flippdf/flippdf.ins50
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{***********************************************************}