From 833afaf242cf7d87069d192c9859848a7a16620d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 12 Aug 2011 15:38:41 +0000 Subject: missed pagecolor commit git-svn-id: svn://tug.org/texlive/trunk@23513 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pagecolor/README | 146 +++++++++++++++++++++ .../doc/latex/pagecolor/pagecolor-example.pdf | Bin 0 -> 58148 bytes .../doc/latex/pagecolor/pagecolor-example.tex | 97 ++++++++++++++ .../texmf-dist/doc/latex/pagecolor/pagecolor.pdf | Bin 0 -> 291274 bytes 4 files changed, 243 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/pagecolor/README create mode 100644 Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf create mode 100644 Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex create mode 100644 Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf (limited to 'Master/texmf-dist/doc/latex/pagecolor') 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 + + + +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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf 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 +%% +%% 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf differ -- cgit v1.2.3