README for turnthepage package, 2024-11-15, v2.0a


TABLE OF CONTENTS
=================

1 Introduction
2 Download
3 Installation
4 Additional Packages
5 Authors/Maintainer
6 Bug Reports


1 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 the last page is odd) displays a
message to turn the page. This mechanism can also be useful for different kinds
of documents.
This package can thus be used for exams, or special documents printed
‘twoside.’

This material is published under the LPPL 1.3c: This work may be
distributed and/or modified under the conditions of the LaTeX Project
Public License, either version 1.3c of this license or (at your option)
any later version. This version of this license is in
https://www.latex-project.org/lppl/lppl-1-3c.txt
and the latest version of this license is in
https://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of
LaTeX version 2005-12-01 or later.


2 DOWNLOAD
==========

"turnthepage" is available on CTAN:
https://ctan.org/pkg/turnthepage


3 INSTALLATION
==============

a) Download the turnthepage files from CTAN.
   If necessary, unpack them.
b) Install the files "*.sty" in your TDS tree:
     cp turnthepage.sty TDS:tex/latex/turnthepage/
     cp turnpageetex.sty TDS:tex/latex/turnthepage/
     cp turnpagewoetex.sty TDS:tex/latex/turnthepage/
   Replace "TDS:" by the prefix of your TDS tree
   (texmf directory).
c) Update the databases if necessary, e.g. for TeXLive
     texhash or mktexlsr.
d) Create the documentation, if necessary, e.g.
     pdflatex turnthepage.tex
     pdflatex turnthepage.tex
     makeindex turnthepage.idx
     bibtex turnthepage
     pdflatex turnthepage.tex
     pdflatex turnthepage.tex
e) Copy the documentation files to
   "TDS:doc/latex/turnthepage/":
   README, turnthepage.pdf,
   turnthepage.tex, turnthepage-bib.bib.
f) Update the databases if necessary, e.g. for TeXLive
     texhash or mktexlsr.


4 ADDITIONAL PACKAGES
=====================

The turnthepage package requires the picture package.
If used with old LaTeX formats, additionally needed are:
atbegshi, everyshi and atveryend.


5 AUTHORS/MAINTAINER
====================

Author of the package and current maintainer: Luca Merciadri
with help from: Marc van Dongen, H.-Martin Münch


6 BUG REPORTS
=============

A bug report should contain:
* Comprehensive problem description. This includes error or
  warning messages.
* \errorcontextlines=\maxdimen can be added in the
  TeX code to get more information in TeX error messages.
* Minimal test file that shows the problem,
  but does not contain any unnecessary packages and code.
* Used drivers/programs.
* Version information about used packages and programs.
* If you are using LaTeX, then add "\listfiles" to the document.
  Then a list of version information is printed at the end
  of the LaTeX run.
* Please no other files than the minimal test file.
  The other files .log, .dvi, .ps, .pdf are seldom
  necessary, so send them only on request.
* Please .zip or .tar.gz your file(s) before sending them!

Bug address
-----------
Bug reports can be send to the maintainer:
Luca Merciadri <Luca [dot] Merciadri [at] student [dot] ulg [dot] ac [dot] be>
If Luca Merciadri is not reachable, try
Marc van Dongen at <dongen [at] cs [dot] ucc [dot] ie>
or
H.-Martin Münch at <Martin [dot] Muench [at] Uni-Bonn [dot] de>