summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pagecolor
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-12 15:38:41 +0000
committerKarl Berry <karl@freefriends.org>2011-08-12 15:38:41 +0000
commit833afaf242cf7d87069d192c9859848a7a16620d (patch)
tree6ebe270a1066e42cde34681a2a53d09bea6c79e2 /Master/texmf-dist/doc/latex/pagecolor
parent2cea258fda0365adce50be5a29fcd9d87fb6868f (diff)
missed pagecolor commit
git-svn-id: svn://tug.org/texlive/trunk@23513 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pagecolor')
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/README146
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdfbin0 -> 58148 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex97
-rw-r--r--Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdfbin0 -> 291274 bytes
4 files changed, 243 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/pagecolor/README b/Master/texmf-dist/doc/latex/pagecolor/README
new file mode 100644
index 00000000000..44289d5c048
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pagecolor/README
@@ -0,0 +1,146 @@
+README for pagecolor package, 2011/08/06, v1.0b
+
+
+TABLE OF CONTENTS
+=================
+
+1 Introduction
+2 Download
+3 Installation
+4 Additional Packages
+5 Package Compatibility
+6 Authors/Maintainers
+7 Bug Reports
+8 Known Problems
+
+
+1 INTRODUCTION
+==============
+
+This LaTeX package provides the command \thepagecolor, which gives
+the current page (background) colour, i. e. the argument used with
+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.
+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.
+
+
+2 DOWNLOAD
+==========
+
+`pagecolor' should become available on CTAN soon:
+ CTAN:macros/latex/contrib/pagecolor/
+
+Also a ZIP file is provided that contains the files, already
+sorted in a TDS tree (should become available on CTAN soon):
+ CTAN:install/macros/latex/contrib/pagecolor.tds.zip
+
+`CTAN:' means one of the `Comprehensive TeX Archive Network'
+nodes or one of its mirrors. This is explained in
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives
+
+The CTAN stuff will be mirrored automatically from the
+ftp server, so
+ ftp://ftp.tug.org/pub/tex/pagecolor/
+corresponds to
+ CTAN:macros/latex/contrib/pagecolor/
+
+
+3 INSTALLATION
+==============
+
+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.
+(See CTAN:tds.zip for an explanation of TDS.)
+Example:
+ cd /...somewhere.../texmf
+ unzip /...downloadpath.../pagecolor.tds.zip
+Do not forget to refresh the file name database of this
+TDS tree.
+Example:
+ texhash /...somewhere.../texmf
+
+Manual installation
+-------------------
+a) Download the pagecolor files from CTAN or the TUG server.
+ If necessary, unpack them.
+b) Generate the package and driver files:
+ tex pagecolor.ins
+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
+ "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
+=====================
+
+pagecolor loads other packages:
+
+* kvoptions, CTAN:macros/latex/contrib/oberdiek/kvoptions.dtx
+* xcolor, CTAN:macros/latex/contrib/xcolor/xcolor.dtx
+ if the color package has not been loaded before pagecolor.
+
+which again load other packages
+(see the result of the \listfiles command in the log-file
+ of the example).
+
+5 PACKAGE COMPATIBILITY
+=======================
+
+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
+\nopagecolor is defined (if that is defined in the document
+at all).
+
+6 AUTHOR/MAINTAINER
+=====================
+
+* Hans-Martin Münch
+
+
+7 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". 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:
+ Hans-Martin Münch
+ <Martin [dot] Muench [at] Uni-Bonn [dot] de>
+
+
+8 KNOWN PROBLEMS
+=================
+
+* 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
new file mode 100644
index 00000000000..8786d32afea
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..da31c2c8661
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex
@@ -0,0 +1,97 @@
+%%
+%% This is file `pagecolor-example.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pagecolor.dtx (with options: `example')
+%%
+%% This is a generated file.
+%%
+%% Project: pagecolor
+%% Version: 2011/08/06 v1.0b
+%%
+%% Copyright (C) 2011 by
+%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
+%%
+%% The usual disclaimer applys:
+%% 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.)
+%%
+%% 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
+%% http://www.latex-project.org/lppl/lppl-1-3c.txt
+%% and the latest version of this license is in
+%% http://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.
+%%
+%% This work has the LPPL maintenance status "maintained".
+%%
+%% 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.
+%%
+\documentclass[british]{article}[2007/10/19]% v1.4h
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage{hyperref}[2011/04/17]% v6.82g
+\hypersetup{extension=pdf,%
+ plainpages=false,%
+ pdfpagelabels=true,%
+ hyperindex=false,%
+ pdflang={en},%
+ pdftitle={pagecolor package example},%
+ pdfauthor={Hans-Martin Muench},%
+ pdfsubject={Example for the pagecolor package},%
+ pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour, Hans-Martin Muench},%
+ pdfview=Fit,pdfstartview=Fit,%
+ pdfpagelayout=SinglePage%
+}
+\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/06]% v1.0b
+\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
+\listfiles
+\begin{document}
+\pagenumbering{arabic}
+\section*{Example for pagecolor}
+
+This example demonstrates the use of package\newline
+\textsf{pagecolor}, v1.0b as of 2011/08/06 (HMM).\newline
+The used option was \verb|pagecolor={LightGoldenrod1}|.\newline
+\verb|pagecolor={none}| would be the default.\newline
+
+For more details please see the documentation!\newline
+
+\noindent {\color{teal} Save per page about $200\unit{ml}$ water,
+$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline
+Therefore please print only if this is really necessary.}\newline
+
+The current page (background) colour is\newline
+\verb|\thepagecolor|\ =\ \thepagecolor \newline
+(and \verb|\thepagecolornone|\ =\ \thepagecolornone ,
+which would only be different from \verb|\thepagecolor|,
+when the page colour would be \verb|none|).
+
+\pagebreak
+\pagecolor{rgb:-green!40!yellow,3;green!40!yellow,2;red,1}
+
+{\color{white} The current page (background) colour is\newline
+\verb|\thepagecolor|\ =\ \thepagecolor . \newline}
+
+{\color{\thepagecolor} And that makes this text practically invisible.
+\newline}
+
+Which made the preceding line of text practically invisible.
+
+\end{document}
+\endinput
+%%
+%% End of file `pagecolor-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf
new file mode 100644
index 00000000000..484e863c545
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf
Binary files differ