diff options
author | Karl Berry <karl@freefriends.org> | 2015-06-23 18:18:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-06-23 18:18:51 +0000 |
commit | 2a28908e80aaca3ef066f84e9d219cd68b8b54aa (patch) | |
tree | 867ce588251bfa2cf452f250ae152f14f6218214 /Master/texmf-dist/doc | |
parent | c4d53b195d165e5e3b159ce5610dc66098eae735 (diff) |
pagecolor (21jun15)
git-svn-id: svn://tug.org/texlive/trunk@37646 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/README | 71 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf | bin | 85390 -> 85717 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex | 42 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf | bin | 306361 -> 315840 bytes |
4 files changed, 61 insertions, 52 deletions
diff --git a/Master/texmf-dist/doc/latex/pagecolor/README b/Master/texmf-dist/doc/latex/pagecolor/README index 7254fc63cd9..fbf61c8540f 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, 2012/02/23, v1.0e +README for pagecolor package, 2015/06/22, v1.0g TABLE OF CONTENTS @@ -23,40 +23,36 @@ 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. +When \nopagecolor is unknown (e.g. Xe(La)TeX) or broken (crop package) +this package provides a replacement. 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. + +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 +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. 2 DOWNLOAD ========== `pagecolor' is available on CTAN: - CTAN:macros/latex/contrib/pagecolor/ - -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 +https://www.ctan.org/pkg/pagecolor -`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/ +Also a ZIP file is provided that contains the files: +the manual (pagecolor.pdf), the example (pagecolor-example.tex), +the compiled example (pagecolor-example.pdf), +driver (pagecolor.drv), pagecolor.dtx, +installation file (pagecolor.ins), +the style file (pagecolor.sty), +and this README, already sorted in a TDS tree: +http://mirrors.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip 3 INSTALLATION @@ -67,7 +63,8 @@ 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.) +See https://www.ctan.org/TDS-guidelines for an explanation +of TDS. Example: cd /...somewhere.../texmf unzip /...downloadpath.../pagecolor.tds.zip @@ -82,11 +79,11 @@ a) Download the pagecolor files from CTAN. If necessary, unpack them. b) Generate the package and driver files: tex pagecolor.dtx -c) Install the file `*.sty' in your TDS tree: - cp *.sty TDS:tex/latex/pagecolor/ +c) Install the file `pagecolor.sty' in your TDS tree: + cp pagecolor.sty TDS:tex/latex/pagecolor/ Replace `TDS:' by the prefix of your TDS tree (texmf directory). -d) Create the documentation (if necessary), e.g. +d) Create the documentation, if necessary, e.g. pdflatex pagecolor.dtx makeindex -s gind.ist pagecolor.idx pdflatex pagecolor.dtx @@ -94,7 +91,7 @@ d) Create the documentation (if necessary), e.g. 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. +f) Create the pagecolor-example.pdf, if necessary, e.g. pdflatex pagecolor-example.tex pdflatex pagecolor-example.tex pdflatex pagecolor-example.tex @@ -108,11 +105,8 @@ g) Copy the documentation files to ===================== 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. - +kvoptions, xcolor (if the color package has not been loaded +before pagecolor), ifpdf, and ifluatex, which again load other packages (see the result of the \listfiles command in the log-file of the example). @@ -126,13 +120,14 @@ pagecolor should be loaded quite early, i. e. before (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). +at all). If the xcolor or the color package shall be used, +they also should be loaded before pagecolor. 6 AUTHOR/MAINTAINER ===================== -* H.-Martin Münch +H.-Martin Münch 7 BUG REPORTS diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf Binary files differindex 2932eda285c..3f27205606a 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 b9864ee665e..b47a922f53f 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex @@ -9,9 +9,9 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2012/02/23 v1.0e +%% Version: 2015/06/22 v1.0g %% -%% Copyright (C) 2011 - 2012 by +%% Copyright (C) 2011 - 2015 by %% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> %% %% The usual disclaimer applies: @@ -39,7 +39,12 @@ %% pagecolor.ins, pagecolor.drv, %% pagecolor-example.tex, pagecolor-example.pdf. %% -\documentclass[british]{article}[2007/10/19]% v1.4h +%% In memoriam +%% Claudia Simone Barth + 1996/01/30 +%% Tommy Muench + 2014/01/02 +%% Hans-Klaus Muench + 2014/08/24 +%% +\documentclass[british]{article}[2014/09/29]% v1.4h %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \usepackage[% extension=pdf,% @@ -54,21 +59,26 @@ H.-Martin Muench},% pdfview=Fit,pdfstartview=Fit,% pdfpagelayout=SinglePage% -]{hyperref}[2012/02/06]% v6.82o +]{hyperref}[2012/11/06]% v6.83m \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}[2012/02/23]% v1.0e +\usepackage[pagecolor={LightGoldenrod1},% + nopagecolor={none}]{pagecolor}[2015/06/22]% v1.0g -\usepackage{afterpage}[1995/10/27]% v1.08 +\usepackage{afterpage}[2014/10/28]% 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 +\usepackage{lipsum}[2014/07/27]% v1.3 % The lipsum package is generally not needed, % but some blind text is needed for the example. +\usepackage{hologo}[2012/04/26]% v1.10 + % The hologo package is only needed to write + % \hologo{pdfTeX}, \hologo{LuaTeX}, and \hologo{XeTeX}. + \gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% \listfiles \begin{document} @@ -76,17 +86,19 @@ \section*{Example for pagecolor} This example demonstrates the use of package\newline -\textsf{pagecolor}, v1.0e as of 2012/02/23 (HMM).\newline -The used option was \verb|pagecolor={LightGoldenrod1}|.\newline -\verb|pagecolor={none}| would be the default.\newline +\textsf{pagecolor}, v1.0g as of 2015/06/22 (HMM).\newline +The used options were\newline +\verb|pagecolor={LightGoldenrod1}| (\verb|pagecolor={none}| +would be the default), and +\verb|pagecolor={none}| (which is the default).\newline -For more details please see the documentation!\newline +\noindent 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 +\noindent The current page (background) colour is\newline \verb|\thepagecolor|\ =\ \thepagecolor \newline (and \verb|\thepagecolornone|\ =\ \thepagecolornone , which would only be different from \verb|\thepagecolor|, @@ -119,8 +131,10 @@ the page colour to the value it had before the red page.} \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|: +command is known (\hologo{pdfTeX} and \hologo{LuaTeX}; not yet for +dvips, dvipdfm(x) or \hologo{XeTeX}), the page colour is now +\verb|none| (because option \verb|nopagecolor={none}|), otherwise +\verb|white| (or the colour given with option \verb|nopagecolor={...}|): \verb|\thepagecolor|\ =\ \thepagecolor\ and \verb|\thepagecolornone|\ =\ \thepagecolornone . diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf Binary files differindex f729de8dde7..65706ee4914 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf |