new latex package turnthepage (1jan11)

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

7 files changed, 222 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/turnthepage/README b/Master/texmf-dist/doc/latex/turnthepage/README
new file mode 100755
index 00000000000..6765a10eed9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/README
@@ -0,0 +1,13 @@
+This is the README file of the turnthepage package v1.0 by Merciadri Luca
+and Marc van Dongen.
+
+To use the turnthepage package correctly, please install the .sty
+file in your LaTeX distribution, or use it in the directories of your
+files which use turnthepage.
+
+This material is subject to the LaTeX project Public License. See
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for
+the details of that license.
+
+You can have more info on this at
+http://www.student.montefiore.ulg.ac.be/~merciadri/#turnthepagepckg.
diff --git a/Master/texmf-dist/doc/latex/turnthepage/perso.ist b/Master/texmf-dist/doc/latex/turnthepage/perso.ist
new file mode 100755
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/perso.ist
diff --git a/Master/texmf-dist/doc/latex/turnthepage/turnthepage-bib.bib b/Master/texmf-dist/doc/latex/turnthepage/turnthepage-bib.bib
new file mode 100755
index 00000000000..bc264715a0d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/turnthepage-bib.bib
@@ -0,0 +1,5 @@
+@misc{mvd1,
+author = {Van Dongen, Marc and Merciadri, Luca},
+title = {{Turn the Page, comp.text.tex}},
+year = 2011,
+}
diff --git a/Master/texmf-dist/doc/latex/turnthepage/turnthepage.forlisting b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.forlisting
new file mode 100755
index 00000000000..244828145a5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.forlisting
@@ -0,0 +1,38 @@
+%% This is file `turnthepage.sty' v1.0 by Merciadri Luca.

+% Thanks to Marc van Dongen for his help.

+

+\NeedsTeXFormat{LaTeX2e}

+\ProvidesPackage{turnthepage}[2011/01/01 Indicating to turn the page]

+\PackageInfo{turnthepage}{This is turnthepage.}

+\RequirePackage{atbegshi}

+\RequirePackage{refcount}

+\RequirePackage{picture}

+\RequirePackage{lastpage}

+

+\DeclareOption{short}{%

+\providecommand{\turnthepage}{/\ldots}

+}

+

+\DeclareOption{long}{%

+\providecommand{\turnthepage}{\textit{Turn the page.}}

+}

+

+\AtBeginShipout{%

+\AtBeginShipoutUpperLeft{%

+    \ifodd\thepage%

+    \ifnum\getpagerefnumber{LastPage}>\thepage%

+        \dimen1=1in

+        \advance\dimen1 by \textwidth

+        \advance\dimen1 by \oddsidemargin

+        \dimen3=1in

+        \advance\dimen3 by \topmargin

+        \advance\dimen3 by \headheight

+        \advance\dimen3 by \headsep

+        \advance\dimen3 by \textheight

+        \advance\dimen3 by \footskip

+        \put(\dimen1,-\dimen3){\llap{\turnthepage}}%

+    \fi\fi%

+}}

+

+\ProcessOptions

+\relax
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/turnthepage/turnthepage.pdf b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.pdf
new file mode 100644
index 00000000000..d671b23e7b7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.pdf
diff --git a/Master/texmf-dist/doc/latex/turnthepage/turnthepage.tex b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.tex
new file mode 100755
index 00000000000..8a57f4c8fe2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/turnthepage/turnthepage.tex
@@ -0,0 +1,128 @@
+\documentclass[10pt,a4paper,final,makeidx,twosides]{article}
+
+\usepackage{atbegshi,refcount}
+\usepackage{picture}
+
+\usepackage{listings}
+
+\usepackage{caption,lastpage}
+%\captionsetup{figurename=Figure, tablename=Table}
+
+\renewcommand{\captionfont}{\small}
+\renewcommand{\captionlabelfont}{\bfseries}
+
+\usepackage[protrusion=true,draft=false,final,verbose=true,babel=true]{microtype}
+
+\providecommand{\turnthepage}{\textit{Turn the page.}}
+
+\AtBeginShipout{%
+\AtBeginShipoutUpperLeft{%
+     \ifodd\thepage%
+        \ifnum\getpagerefnumber{LastPage}>\thepage%
+        \dimen1=1in
+        \advance\dimen1 by \textwidth
+        \advance\dimen1 by \oddsidemargin
+        \dimen3=1in
+        \advance\dimen3 by \topmargin
+        \advance\dimen3 by \headheight
+        \advance\dimen3 by \headsep
+        \advance\dimen3 by \textheight
+        \advance\dimen3 by \footskip
+        \put(\dimen1,-\dimen3){\llap{\turnthepage}}%
+     \fi\fi%
+}}
+
+\title{The \textbf{turnthepage} package}
+\author{Merciadri Luca, Marc van Dongen}
+\date{\today}
+
+\usepackage{makeidx}
+
+%% - HYPERREF PACKAGE - ** MUST be LAST ONE **
+\usepackage[a4paper,bookmarks=true,bookmarksnumbered=true,bookmarksopen=true,bookmarksopenlevel=1,breaklinks=true,colorlinks=true,final,menucolor=red,pdfauthor={Merciadri Luca},pdfcreator={Merciadri Luca},pdfkeywords={math},pdftitle={The turnthepage package},pdfsubject={(La)TeX},pdftoolbar=true]{hyperref}
+\hypersetup{urlcolor=red,linkcolor=blue,citecolor=blue,colorlinks=true}
+
+\usepackage{breakurl}
+
+
+%% -- INDEX GENERATION ACTIVATION --
+
+\makeindex
+
+%% -- INDEX GENERATION ACTIVATION --
+
+\begin{document}
+
+
+\maketitle
+
+\tableofcontents
+
+\newpage
+\section{Introduction}
+On some exams' sheets, some professors or lecturers like to indicate to the reader that the `page' can be turned. That avoids oversights to the student, thereby avoiding them cold sweat at the end of the exam, realizing that there were other questions they needed to answer. One might implement a \LaTeX{} mechanism so that each odd page (except the last one, if any) displays a message to turn the page. This mechanism can also be useful for different kinds of documents.
+
+This package should thus be used for exams, or special documents printed `twoside.'
+
+\section{Use}
+\subsection{Loading the Package}
+To \textit{load the package}, please use
+\begin{center}
+\begin{verbatim}
+\usepackage[options]{turnthepage}
+\end{verbatim}
+\end{center}
+\subsection{Available Options}
+Without any option, the package will not be really useful, as it will not perform anything that will be nice for you. Consequently, the \textit{following options are available}:
+\begin{itemize}
+\item \verb|short|: will display `/\ldots' at the bottom of each odd page, in its right corner, \index{\texttt{short}}
+\item \verb|long|: will display `\textit{Turn the page.}' at the bottom of each odd page, in its right corner. \index{\texttt{long}}
+\end{itemize}
+As the package calls \verb|\turnthepage| where it needs to be placed, you can define \verb|\turnthepage| as you want. For example, if you want a more polite way to say it, you can use
+\begin{verbatim}
+\renewcommand{\turnthepage}{\itshape Turn the page please.}
+\end{verbatim}
+after the preamble.
+
+\section{Implementation}
+Here is the code of \verb|turnthepage.sty|:
+\lstset{language=TEX, basicstyle=\normalsize, keywordstyle=\bfseries, commentstyle=\itshape, keywords={}, emph={}, emphstyle=\bfseries, numbers=left, stringstyle=\ttseries, showstringspaces=false, stepnumber=2, numbersep=5pt, showspaces=false, showtabs=false, backgroundcolor=\color{white}}
+
+%\begin{lstlisting}[frame=single]
+\lstinputlisting[lastline=80]{turnthepage.forlisting}
+%\end{lstlisting}
+
+\section{Bugs}
+There is currently only one `bug:'
+\begin{itemize}
+ \item Using a \verb|\setcounter| command will produce a missing number error.
+\end{itemize}
+
+
+\section{Version History}
+\begin{enumerate}
+ \item \verb v1.0 : package is introduced to the \LaTeX{} world (happy new 2011 year!),
+\end{enumerate}
+
+\section{Thanks}
+Many thanks go to Marc van Dongen for his help at \cite{mvd1}.
+
+\section{Contact}
+If you have any question concerning this package (limitations, bugs, \ldots), please contact me at \href{mailto:Luca.Merciadri@student.ulg.ac.be}{Luca.Merciadri@student.ulg.ac.be}.
+
+\newpage
+
+\phantomsection
+\printindex
+% 
+\newpage
+\section{References}
+\nocite{*}
+\bibliographystyle{siam}
+%\bibliographystyle{frplain}
+%\bibliographystyle{alpha}
+\label{biblio}
+%\begin{multicols}{2}
+\bibliography{turnthepage-bib}
+
+\end{document}
\ No newline at end of file
diff --git a/Master/texmf-dist/tex/latex/turnthepage/turnthepage.sty b/Master/texmf-dist/tex/latex/turnthepage/turnthepage.sty
new file mode 100755
index 00000000000..dae7cec1d86
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/turnthepage/turnthepage.sty
@@ -0,0 +1,38 @@
+%% This is file `turnthepage.sty' v1.0 by Merciadri Luca.
+% Thanks to Marc van Dongen for his help.
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{turnthepage}[2011/01/01 Indicating to turn the page]
+\PackageInfo{turnthepage}{This is turnthepage.}
+\RequirePackage{atbegshi}
+\RequirePackage{refcount}
+\RequirePackage{picture}
+\RequirePackage{lastpage}
+
+\DeclareOption{short}{%
+\providecommand{\turnthepage}{/\ldots}
+}
+
+\DeclareOption{long}{%
+\providecommand{\turnthepage}{\textit{Turn the page.}}
+}
+
+\AtBeginShipout{%
+\AtBeginShipoutUpperLeft{%
+    \ifodd\thepage%
+    \ifnum\getpagerefnumber{LastPage}>\thepage%
+        \dimen1=1in
+        \advance\dimen1 by \textwidth
+        \advance\dimen1 by \oddsidemargin
+        \dimen3=1in
+        \advance\dimen3 by \topmargin
+        \advance\dimen3 by \headheight
+        \advance\dimen3 by \headsep
+        \advance\dimen3 by \textheight
+        \advance\dimen3 by \footskip
+        \put(\dimen1,-\dimen3){\llap{\turnthepage}}%
+    \fi\fi%
+}}
+
+\ProcessOptions
+\relax
\ No newline at end of file