pagecolor (1feb12)

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

4 files changed, 115 insertions, 36 deletions

diff --git a/Master/texmf-dist/doc/latex/pagecolor/README b/Master/texmf-dist/doc/latex/pagecolor/README
index df751cfc9c7..5d9bb71b6b6 100644
--- a/Master/texmf-dist/doc/latex/pagecolor/README
+++ b/Master/texmf-dist/doc/latex/pagecolor/README
@@ -1,4 +1,4 @@
-README for pagecolor package, 2011/08/08, v1.0c
+README for pagecolor package, 2012/02/01, v1.0d
 
 
 TABLE OF CONTENTS
@@ -23,6 +23,8 @@ the most recent call of \pagecolor{...}.
 The command \thepagecolornone gives the same colour as
 \thepagecolor, except when the page background colour is "none".
 In that case \thepagecolor is white and \thepagecolornone is none.
+Similar to \newgeometry and \restoregeometry of the geometry
+package \newpagecolor{...} and \restorepagecolor are provided.
 This material is subject to the LaTeX Project Public License
 (LPPL). See http://www.ctan.org/tex-archive/help/Catalogue/
 licenses.lppl.html for the details of that license.
@@ -34,7 +36,15 @@ licenses.lppl.html for the details of that license.
 `pagecolor' is available on CTAN:
   CTAN:macros/latex/contrib/pagecolor/
 
-Also a ZIP file is provided that contains the files, already
+Running
+tex pagecolor.dtx
+generates the files
+pagecolor.ins, pagecolor.drv, pagecolor.sty,
+and pagecolor-example.tex.
+
+Also a ZIP file is provided that contains these files,
+the manual (pagecolor.pdf), the compiled example
+(pagecolor-example.pdf), and this README, already
 sorted in a TDS tree:
   CTAN:install/macros/latex/contrib/pagecolor.tds.zip
 
@@ -54,9 +64,9 @@ corresponds to
 
 Installation with ZIP file in TDS format
 ----------------------------------------
-The ZIP file `pagecolor.tds.zip' contains the files sorted
-in a TDS tree. Thus you can directly unpack the ZIP file
-inside a TDS tree.
+The ZIP file `pagecolor.tds.zip' contains the files
+sorted in a TDS tree. Thus you can directly unpack the
+ZIP file inside a TDS tree.
 (See CTAN:tds.zip for an explanation of TDS.)
 Example:
   cd /...somewhere.../texmf
@@ -68,20 +78,30 @@ Example:
 
 Manual installation
 -------------------
-a) Download the pagecolor files from CTAN or the TUG server.
+a) Download the pagecolor files from CTAN.
    If necessary, unpack them.
 b) Generate the package and driver files:
-     tex pagecolor.ins
+     tex pagecolor.dtx
 c) Install the file `*.sty' in your TDS tree:
      cp *.sty TDS:tex/latex/pagecolor/
    Replace `TDS:' by the prefix of your TDS tree
    (texmf directory).
-d) Copy the documentation files to
+d) Create the documentation (if necessary), e.g.
+     pdflatex pagecolor.dtx
+     makeindex -s gind.ist pagecolor.idx
+     pdflatex pagecolor.dtx
+     makeindex -s gind.ist pagecolor.idx
+     pdflatex pagecolor.dtx
+e) Update the databases if necessary, e.g. for teTeX:
+     mktexlsr .../texmf
+f) Create the pagecolor-example.pdf (if necessary), e.g.
+     pdflatex pagecolor-example.tex
+     pdflatex pagecolor-example.tex
+     pdflatex pagecolor-example.tex
+g) Copy the documentation files to
    "TDS:doc/latex/pagecolor/":
    README, pagecolor.pdf, pagecolor-example.tex,
    pagecolor-example.pdf.
-e) Update the databases if necessary, e.g. for teTeX:
-     mktexlsr .../texmf
 
 
 4 ADDITIONAL PACKAGES
@@ -101,7 +121,7 @@ which again load other packages
 5 PACKAGE COMPATIBILITY
 =======================
 
-pagecolor should be loaded quite early, i.e. before
+pagecolor should be loaded quite early, i. e. before
 \pagecolor{...} is used by some other package
 (but can be loaded later using the pagecolor={...} option
 with accordingly chosen value), but must be loaded after
@@ -112,7 +132,7 @@ at all).
 6 AUTHOR/MAINTAINER
 =====================
 
-* H.-Martin Münch
+* H.-Martin Münch
 
 
 7 BUG REPORTS
@@ -121,15 +141,15 @@ at all).
 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.
+* \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". Then
-    a list of version information is printed at the end
-    of the LaTeX run.
+* If you are using LaTeX, then add "\listfiles". 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.
@@ -138,11 +158,11 @@ A bug report should contain:
 Bug address
 -----------
 Bug reports can be send to the maintainer:
-  H.-Martin Münch
+  H.-Martin Münch
   <Martin [dot] Muench [at] Uni-Bonn [dot] de>
 
 
 8 KNOWN PROBLEMS
 =================
 
-* as yet: none...
\ No newline at end of file
+* as yet: none.
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf
index 11e8a4abaae..0fbe9179eb4 100644
--- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf
+++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf
diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex
index aa095260c5d..0ed479b3d22 100644
--- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex
+++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex
@@ -9,12 +9,12 @@
 %% This is a generated file.
 %% 
 %% Project: pagecolor
-%% Version: 2011/08/08 v1.0c
+%% Version: 2012/02/01 v1.0d
 %% 
-%% Copyright (C) 2011 by
+%% Copyright (C) 2011 - 2012 by
 %%     H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
 %% 
-%% The usual disclaimer applys:
+%% The usual disclaimer applies:
 %% If it doesn't work right that's your problem.
 %% (Nevertheless, send an e-mail to the maintainer
 %%  when you find an error in this package.)
@@ -33,30 +33,42 @@
 %% 
 %% The Current Maintainer of this work is H.-Martin Muench.
 %% 
-%% This work consists of the main source file pagecolor.dtx
-%% and the derived files
-%%    pagecolor.sty, pagecolor.pdf, pagecolor.ins, pagecolor.drv,
-%%    pagecolor-example.tex.
+%% This work consists of the main source file pagecolor.dtx,
+%% the README, and the derived files
+%%    pagecolor.sty, pagecolor.pdf,
+%%    pagecolor.ins, pagecolor.drv,
+%%    pagecolor-example.tex, pagecolor-example.pdf.
 %% 
 \documentclass[british]{article}[2007/10/19]% v1.4h
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\usepackage{hyperref}[2011/04/17]% v6.82g
-\hypersetup{extension=pdf,%
+\usepackage[%
+ extension=pdf,%
  plainpages=false,%
  pdfpagelabels=true,%
  hyperindex=false,%
  pdflang={en},%
  pdftitle={pagecolor package example},%
- pdfauthor={Hans-Martin Muench},%
+ pdfauthor={H.-Martin Muench},%
  pdfsubject={Example for the pagecolor package},%
- pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour, Hans-Martin Muench},%
+ pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour,%
+  H.-Martin Muench},%
  pdfview=Fit,pdfstartview=Fit,%
  pdfpagelayout=SinglePage%
-}
+]{hyperref}[2011/12/04]% v6.82m
 \usepackage[x11names]{xcolor}[2007/01/21]% v2.11
- % The xcolor package would not be needed for just using the base colours.
- % The color package would be sufficient for that.
-\usepackage[pagecolor={LightGoldenrod1}]{pagecolor}[2011/08/08]% v1.0c
+ % The xcolor package would not be needed for just using
+ % the base colours. The color package would be sufficient for that.
+\usepackage[pagecolor={LightGoldenrod1}]{pagecolor}[2012/02/01]% v1.0d
+
+\usepackage{afterpage}[1995/10/27]% v1.08
+ % The afterpage package is generally not needed,
+ % but the |\newpagecolor{somecolour}\afterpage{\restorepagecolor}|
+ % construct shall be demonstrated.
+
+\usepackage{lipsum}[2011/04/14]% v1.2
+ % The lipsum package is generally not needed,
+ % but some blind text is needed for the example.
+
 \gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
 \listfiles
 \begin{document}
@@ -64,7 +76,7 @@
 \section*{Example for pagecolor}
 
 This example demonstrates the use of package\newline
-\textsf{pagecolor}, v1.0c as of 2011/08/08 (HMM).\newline
+\textsf{pagecolor}, v1.0d as of 2012/02/01 (HMM).\newline
 The used option was \verb|pagecolor={LightGoldenrod1}|.\newline
 \verb|pagecolor={none}| would be the default.\newline
 
@@ -89,7 +101,54 @@ when the page colour would be \verb|none|).
 {\color{\thepagecolor} And that makes this text practically invisible.
 \newline}
 
-Which made the preceding line of text practically invisible.
+{\color{white} Which made the preceding line of text practically
+invisible.}
+
+\pagebreak
+\newpagecolor{red}
+
+This page uses \verb|\newpagecolor{red}|.
+
+\pagebreak
+\restorepagecolor
+
+{\color{white}And this page uses \verb|\restorepagecolor| to restore
+the page colour to the value it had before the red page.}
+
+\pagebreak
+\pagecolor{none}
+
+This page uses \verb|\pagecolor{none}|. If the \verb|\nopagecolor|
+command is known (pdf\TeX and Lua\TeX; not yet for dvips, dvipdfm(x)
+or Xe\TeX), the page colour is now \verb|none|, otherwise \verb|white|:
+\verb|\thepagecolor|\ =\ \thepagecolor\ and
+\verb|\thepagecolornone|\ =\ \thepagecolornone .
+
+\pagebreak
+\restorepagecolor
+
+{\color{white}\verb|\restorepagecolor| restored the page colour again.}
+
+\pagebreak
+\pagecolor{green}
+
+This page is green due to \verb|\pagecolor{green}|.
+
+\pagebreak
+\newpagecolor{blue}\afterpage{\restorepagecolor}
+
+{\color{white}\verb|\newpagecolor{blue}\afterpage{\restorepagecolor}|%
+\newline
+was used here, i.\,e.~this page is blue, and the next one will
+automatically have the same page colour before it was changed to blue
+here (i.\,e. green).}
+
+\smallskip
+{\color{red}\textbf{\lipsum[1-11]}}
+\bigskip
+
+The page colour was changed back at the end of the page -
+in mid-sentence!
 
 \end{document}
 \endinput
diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf
index 03267664120..e320c292ba4 100644
--- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf
+++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf