summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-02-04 00:54:24 +0000
committerKarl Berry <karl@freefriends.org>2012-02-04 00:54:24 +0000
commit370b075ef6c7f53a7303af7b3d1e40fd7bfe5e20 (patch)
tree4ef115a842be13c52313ec0d00d63faa413183be /Master/texmf-dist/doc
parente5ef52124ad078285133094925a787ff19172c5e (diff)
pagecolor (1feb12)
git-svn-id: svn://tug.org/texlive/trunk@25284 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/README58
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdfbin57923 -> 85390 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex93
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdfbin291452 -> 304734 bytes
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
Binary files differ
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
Binary files differ