summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xcolor
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/xcolor
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xcolor')
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/ChangeLog266
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/README57
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor.lox56
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor.pdfbin0 -> 606645 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor1.tex182
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor2.pdfbin0 -> 95240 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor2.tex157
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor3.tex131
-rw-r--r--Master/texmf-dist/doc/latex/xcolor/xcolor4.tex131
9 files changed, 980 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/xcolor/ChangeLog b/Master/texmf-dist/doc/latex/xcolor/ChangeLog
new file mode 100644
index 00000000000..0434350886b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/ChangeLog
@@ -0,0 +1,266 @@
+Package `xcolor' by Dr. Uwe Kern
+(xcolor at ukern dot de)
+
+History
+=======
+
+2005/10/15 v2.06
+* New features:
+ - color model `wave' for (approximate) visualisation of light
+ wavelengths, still somewhat experimental;
+ - pseudo-model `ps' for colors defined by literal PostScript code
+ in conjunction with `pstricks and `dvips'; an illustrative
+ example for a gamma-correction approach is given in xcolor2.tex;
+ - \substitutecolormodel command for replacement of missing or
+ faulty driver-specific color models;
+ - improved detection and handling of driver-specific color models;
+ - `dvipdfmx' and `xetex' options to support these drivers;
+ - generic driver test file xcolor4.tex.
+* Changes:
+ - \XC@strip@comma doesn't generate a trailing space anymore, which
+ improves also the output of the `testcolors' environment.
+
+2005/09/30 v2.05
+* New features:
+ - `testcolors' environment helps to test colors in different models,
+ showing both the visual result and the model-specific parameters;
+ - \extractcolorspecs puts model/color specification into two
+ separate commands, as opposed to \extractcolorspec;
+ - color names `pink' and `olive' added to the set of predefined
+ colors.
+* Bugfixes:
+ - \definecolor{foo}{named}{bar} did not work in v2.04.
+
+2005/09/23 v2.04
+* New features:
+ - preparation for usage of additional - driver-provided - color
+ models;
+ - `pstricks' users may now specify explicit color parameters within
+ \psset and related commands, e.g., \psset{linecolor=[rgb]{1,0,0}};
+ an illustrative example is given in xcolor2.tex.
+* Changes:
+ - color model names sanitized (i.e., turned to catcode 12)
+ throughout the package;
+ - \@namelet command deprecated because of name clash with
+ `memoir' - please use \XC@let@cc instead
+ (more \XC@let@.. commands are available as well);
+ - simplified color conversion code by using the new \XC@ifxcase
+ command;
+ - some minor changes to internal macros.
+
+2005/06/06 v2.03
+* New features:
+ - `fixpdftex' option loads `pdfcolmk' package in order to improve
+ pdfTeX's color behaviour during page breaks.
+* Changes:
+ - some minor changes to internal macros.
+* Bugfixes:
+ - due to an incorrect \if statement within \XC@info, \colorlet
+ caused trouble whenever its second argument started with two
+ identical letters, e.g., \colorlet{rab}{oof};
+ - argument processing of \XC@getcolor caused incompatibility with
+ `msc' package;
+ - `prologue' option caused incompatibility with `preview' package.
+
+2005/03/24 v2.02
+* New features:
+ - \aftergroupedef command to reproduce \aftergroupdef's behaviour
+ prior to v2.01;
+ - xcolor's homepage www.ukern.de/tex/xcolor.html now provides also
+ a ready-to-run TDS-compliant archive containing all required
+ files.
+* Changes:
+ - \rowcolors and friends are solely enabled by the `table' option;
+ - \@ifxempty changed back to more robust variant of v2.00.
+* Bugfixes:
+ - \psset{linecolor=\ifcase\foo red\or green\or blue\fi} did not work
+ with `pstricks' (error introduced in v2.01).
+
+2005/03/15 v2.01
+* New features:
+ - `prologue' option for comprehensive `named' color support in
+ conjunction with `dvips': on-the-fly generation of PostScript
+ prologue files with all color definitions, ready for dvips
+ inclusion and/or post-processing with device-specific parameters
+ (e.g., spot colors);
+ - dvips prologue file xcolor.pro to support additional `named'
+ colors;
+ - \colorlet may now also be used to create named colors from
+ arbitrary color expressions;
+ - enhanced color definition syntax to allow for target-model
+ specific color parameters, e.g.,
+ \definecolor{red}{rgb/cmyk}{1,0,0/0,1,1,0}, facilitating the
+ usage of tailor-made colors both for displays and printers;
+ - `deferred definition' of colors: \preparecolor and
+ \definecolors enable decoupling of color specification and control
+ sequence generation, especially useful (= memory saving) for large
+ lists of colors, of which only a few names are actually used;
+ - `dvipsnames*' and `svgnames*' options to support deferred
+ definition.
+* Changes:
+ - higher accuracy: most complement calculations are now exact for
+ all 5-digit decimals;
+ - \rangeRGB and similar variables may now be changed at any point
+ in a document;
+ - \aftergroupdef now performs only a first-level expansion of its
+ code argument;
+ - \XCfileversion and similar internal constants removed from .sty
+ and .def files;
+ - improved memory management (reduced generation of `multiletter
+ control sequences' by \@ifundefined tests);
+ - several internal macros improved and/or renamed.
+* Bugfixes:
+ - \XC@getcolor could cause unwanted spaces when \psset was used
+ inside |pspicture| environments (`pstricks');
+ - arithmetic overflow could happen when too many decimal digits
+ were used within color parameters, e.g., as a result of `fp'
+ calculations.
+
+2004/07/04 v2.00
+* New features:
+ - extended functionality for color expressions: mix colors like a
+ painter;
+ - support for color blending: specify color mix expressions that
+ are being blended with every displayed color;
+ - \xglobal command for selective control of globality for color
+ definitions, blends, and masks;
+ - multiple step operations (e.g., \color{foo!!+++}) and access to
+ individual members (e.g., \color{foo!![7]}) in color series;
+ - \providecolor command to define only non-existent colors;
+ - \definecolorset and \providecolorset commands to facilitate the
+ construction of color sets with common underlying color model;
+ - additional 147 predefined color names according to SVG 1.1
+ specification;
+ - `xpdfborder' key for setting the width of hyperlink borders in a
+ more driver-independent way if `dvips' is used.
+* Changes:
+ - `color' package now completely integrated within `xcolor';
+ - `override', `usenames', `nodvipsnames' options and \xdefinecolor
+ command no longer needed;
+ - `dvips' and `dvipsnames' options now independent of each other;
+ - \tracingcolors's behaviour changed to make it more versatile and
+ reduce log file size in standard cases;
+ - \rdivide's syntax made more flexible (divide by numbers and/or
+ dimensions);
+ - code restructured, some internal commands renamed;
+ - documentation rearranged and enhanced.
+* Bugfixes:
+ - \definecolor{foo}{named}{bar} did not work (error introduced in
+ v1.11);
+ - more robust behaviour of conditionals within `pstricks'
+ key-values.
+
+2004/05/09 v1.11
+* New features:
+ - switch \ifglobalcolors to control whether color definitions are
+ global or local;
+ - option `hyperref' provides color expression support for the
+ border colors of hyperlinks, e.g.,
+ \hypersetup{xurlbordercolor=red!50!yellow};
+ - internal hooks \XC@bcolor, \XC@mcolor, and \XC@ecolor for
+ additional code that has to be executed immediately before/after
+ the current color is being displayed.
+* Changes:
+ - \XC@logcolor renamed to \XC@display, which is now the core color
+ display command;
+ - improved interface to `pstricks'.
+
+2004/03/27 v1.10
+* New features:
+ - support for `named' model;
+ - support for `dvips' colors
+ (may now be used within color expressions);
+ - internal representation of `ordinary' and `named' colors merged
+ into unified data structure;
+ - allow multiple `-' signs at the beginning of color expressions.
+* Bugfixes:
+ - commands like \color[named]{foo} caused errors when color masking
+ or target model conversion were active;
+ - incompatibility with `soul' package: commands \hl, \ul, etc.
+ could yield unexpected results.
+* Documentation:
+ - added formula for general color expressions;
+ - enhanced text and index;
+ - removed dependence of index generation on local configuration
+ file.
+
+2004/02/16 v1.09
+* New features:
+ - color model `HTML', a 24-bit hexadecimal `RGB' variant;
+ allows to specify colors like \color[HTML]{AFFE90};
+ - color names `orange', `violet', `purple', and `brown' added to
+ the set of predefined colors.
+* New xcolor homepage: www.ukern.de/tex/xcolor.html
+* Bugfix: \xdefinecolor sometimes did not normalise its parameters.
+* Changes:
+ - slight improvements of the documentation;
+ - example file xcolor1.tex reorganised and abridged.
+
+2004/02/04 v1.08
+* New commands/features:
+ - \selectcolormodel to change the target model within a document;
+ - \adjustUCRBG to fine-tune undercolor-removal and
+ black-generation during conversion to `cmyk'.
+* Bugfix: color expressions did not work correctly in connection with
+ active `!' character, e.g., in case of \usepackage[frenchb]{babel}.
+* Code re-organisation:
+ - \XC@xdefinecolor merged into \xdefinecolor, making the first
+ command obsolete;
+ - several internal commands improved/streamlined.
+
+2004/01/20 v1.07
+* New feature: support for color masking and color separation.
+* New commands:
+ - \rmultiply to multiply a dimension register by a real number;
+ - \xcolorcmd to pass commands that are to be executed at the end
+ of the package.
+* Changes:
+ - more consistent color handling: extended colors now always take
+ precedence over standard colors;
+ - several commands improved by using code from the LaTeX kernel.
+* Documentation: some minor changes.
+* Example files: additional `pstricks' examples (file xcolor2.tex).
+
+2003/12/15 v1.06
+* New feature: extended color expressions, allowing for cascaded mix
+ operations, e.g., \color{red!30!green!40!blue}.
+* Documentation: new section on color expressions.
+* Bugfix: color series stepping did not work correctly within
+ non-displaying commands like \extractcolorspec{foo!!+}
+ (this bug was introduced in v1.05).
+* Renamed commands: \ukfileversion and similar internal constants
+ renamed to \XCfileversion etc.
+* Removed commands: \ifXCpst and \ifXCtable made obsolete by a simple
+ trick.
+
+2003/11/21 v1.05
+* Bugfixes:
+ - package option `hideerrors' should now work as expected;
+ - usage of `.' in the first color expression in a document caused
+ an error due to incorrect initialisation.
+* Code re-organisation: \extractcolorspec now uses \XC@splitcolor,
+ making \XC@extract obsolete.
+
+2003/11/09 v1.04
+* New feature: easy access to current color within color expressions.
+* New option: `override' to replace \definecolor by \xdefinecolor.
+* New command: \tracingcolors for logging color-specific information.
+
+2003/09/21 v1.03
+* Change: bypass strange behaviour of some drivers.
+* New feature: driver-sharing with `hyperref'.
+
+2003/09/19 v1.02
+* Change: \extractcolorspec and \colorlet now also accept color series
+ as arguments.
+
+2003/09/15 v1.01
+* New feature: \definecolorseries and friends.
+* Documentation: removed some `doc'-related side-effects.
+* Code re-organisation: all calculation-related tools put to one place.
+* Bugfixes:
+ - \@rdivide: added \relax to fix problem with negative numerators;
+ - \rowc@l@rs: replaced \@ifempty by \@ifxempty.
+
+2003/09/09 v1.00
+* First published release.
diff --git a/Master/texmf-dist/doc/latex/xcolor/README b/Master/texmf-dist/doc/latex/xcolor/README
new file mode 100644
index 00000000000..155040a75f4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/README
@@ -0,0 +1,57 @@
+Package `xcolor' by Dr. Uwe Kern
+(xcolor at ukern dot de)
+
+v2.06 (2005/10/15)
+
+`xcolor' provides easy driver-independent access to several kinds of
+colors, tints, shades, tones, and mixes of arbitrary colors by means of
+color expressions like \color{red!50!green!20!blue}.
+It allows to select a document-wide target color model and offers tools
+for automatic color schemes, conversion between nine color models,
+alternating table row colors, color blending and masking, and color
+separation.
+
+Installation instructions
+=========================
+
+Extract all package files:
+ `latex xcolor.ins'
+
+Put the generated files to their respective locations
+within the TeX installation:
+ *.sty -> /tex/latex/xcolor/
+ *.def -> /tex/latex/xcolor/
+ *.pro -> /dvips/xcolor/
+
+Create the documentation:
+ `latex xcolor.dtx'
+ `latex xcolor.dtx'
+ `makeindex -s gind.ist xcolor.idx'
+ `latex xcolor.dtx'
+ `latex xcolor.dtx'
+
+Run the test files (N=1,2,...):
+ `latex xcolorN.tex'
+ `latex xcolorN.tex'
+
+Notes
+=====
+
+- `xcolor1.tex' should run with both LaTeX and pdfLaTeX, it yields a
+ 50-page document with several systematic color conversion examples
+- `xcolor2.tex' is a 3-page `pstricks' example document that won't run
+ with pdfLaTeX
+- `xcolor3.tex' is a 1-page example for demonstrating the logging
+ facilities
+- `xcolor4.tex' is a 1-page driver test file;
+ uncomment the relevant code line in the header and run it with the
+ appropriate program, e.g., `latex xcolor4' or any other processor;
+ apply any desired post-processing like dvips, dvipdfm, etc.
+- If the file `xcolor.ins' is missing, run `latex xcolor.dtx' once
+ and quit the LaTeX compiler as soon as the first error message
+ appears.
+
+History
+=======
+
+See file `ChangeLog'.
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor.lox b/Master/texmf-dist/doc/latex/xcolor/xcolor.lox
new file mode 100644
index 00000000000..adccdddbf87
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor.lox
@@ -0,0 +1,56 @@
+%%
+%% This is file `xcolor.lox',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% xcolor.dtx (with options: `extract')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from xcolor.lox.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file xcolor.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%
+%% ----------------------------------------------------------------
+%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de>
+%% ----------------------------------------------------------------
+%%
+\def\XCfileversion{v2.06}%
+\def\XCfiledate{2005/10/15}%
+\def\ukfile#1#2#3#4%
+ {\def\ukhead
+ {\ifnum#1>2 \perCent!^^J\fi
+ \defaultpreamble^^J\MetaPrefix^^J%
+ \ifcase#1
+ \string\ProvidesPackage{#2}^^J\or
+ \string\ProvidesFile{#2}^^J\or
+ \string\ProvidesFile{#2.def}^^J\or
+ \MetaPrefix\space #2.pro (PostScript/dvips header file)^^J\MetaPrefix\space
+ \fi
+ \space[\XCfiledate\space\XCfileversion\space#4\space(UK)]}
+ \usepreamble\ukhead
+ \file{#2.\ifcase#1sty\or tex\or def\or pro\fi}{\from{xcolor.dtx}{#3}}}
+\generate{
+\ukfile0{xcolor}{package}{LaTeX color extensions}
+\ukfile2{svgnam}{svgnames}{Predefined colors according to SVG 1.1}
+\ukfile1{xcolor1}{test1}{Color conversion test}
+\ukfile1{xcolor2}{test2}{Pstricks color test}
+\ukfile1{xcolor3}{test3}{Color logging test}
+\ukfile1{xcolor4}{test4}{Color driver test}
+\def\PStail{\MetaPrefix\space End of file `\outFileName'.}
+\usepostamble\PStail
+\ukfile3{xcolor}{dvips}{LaTeX color extensions}
+}
+\endinput
+%%
+%% End of file `xcolor.lox'.
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf b/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf
new file mode 100644
index 00000000000..e1806f83fa2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex
new file mode 100644
index 00000000000..74215b2d4bb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex
@@ -0,0 +1,182 @@
+%%
+%% This is file `xcolor1.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% xcolor.dtx (with options: `test1')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from xcolor1.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file xcolor.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%
+\ProvidesFile{xcolor1}
+ [2005/10/15 v2.06 Color conversion test (UK)]
+%%
+%% ----------------------------------------------------------------
+%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de>
+%% ----------------------------------------------------------------
+%%
+\def\XCfileversion{v2.06}%
+\def\XCfiledate{2005/10/15}%
+\documentclass[a4paper]{article}
+
+\usepackage{array,multicol,multido,textcomp}
+\usepackage{xcolor}[2005/03/24]
+\usepackage[hmargin={1.25cm,.75cm},vmargin=1.25cm,footskip=.5cm,nohead]{geometry}
+
+\newdimen\Argwd
+\newdimen\Errsum
+\newdimen\Errmax
+\newcount\Colors
+\newcount\Errors
+\newcount\Loops
+\newif\ifColor
+
+\makeatletter
+
+\def\DisplayColor#1#2#3%
+ {\global\advance\Loops\@ne
+ \@tempdima=#1\p@ \edef\@tempa{\the\@tempdima}%
+ \edef\Colori{\strip@pt\@tempdima}%
+ \ifColor
+ \@tempdimb=#2\p@ \edef\@tempb{\the\@tempdimb}%
+ \@tempdimc=#3\p@ \edef\@tempc{\the\@tempdimc}%
+ \edef\Colori{\Colori,\strip@pt\@tempdimb,\strip@pt\@tempdimc}%
+ \fi
+ \Make12\Make23\Make34\Make45\Make56\Make67%
+ \begin{tabular}{@{}ll*4{@{ }p{\Argwd}}@{}}
+ \Row1\Row2\Row3\Row4\Row5\Row6\noalign{\medskip}
+ \end{tabular}
+ \global\advance\Colors1 \relax\ifnum\Colors=30 \newpage\global\Colors=0 \fi}
+
+\def\Make#1#2%
+ {\edef\@@tmp
+ {\noexpand\definecolor{Color\romannumeral#1}%
+ {\@nameuse{Model\romannumeral#1}}{\@nameuse{Color\romannumeral#1}}%
+ }\@@tmp
+ \relax\ifnum#1<6
+ \convertcolorspec
+ {\@nameuse{Model\romannumeral#1}}{\@nameuse{Color\romannumeral#1}}%
+ {\@nameuse{Model\romannumeral#2}}\@@tmp
+ \XC@let@cN{Color\romannumeral#2}\@@tmp
+ \fi}
+\def\Row#1%
+ {\edef\@@tmp{\@nameuse{Color\romannumeral#1}\@nameuse{Row\romannumeral#1}}%
+ \expandafter\@Row\@@tmp}
+
+\def\@Row#1,#2,#3,#4,#5#6%
+ {\fcolorbox{black}{Color\romannumeral#5}{\phantom{000}}&
+ \csname Model\romannumeral#5\endcsname &
+ \ifodd#6 \@Error{#1}\@tempa \else #1\fi &
+ \ifColor\ifodd#6 \@Error{#2}\@tempb \else #2\fi\else #2\fi &
+ \ifColor\ifodd#6 \@Error{#3}\@tempc \else #3\fi\else #3\fi &
+ #4\\}
+
+\def\defModel#1#2#3#4% number, name, commas, check
+ {\@namedef{Model\romannumeral#1}{#2}\@namedef{Row\romannumeral#1}{#3#1#4}}
+
+\def\@Error#1#2%
+ {\ifdim#1\p@=#2\relax #1\else
+ \textcolor{red}{#1}\global\advance\Errors\@ne
+ \dimen@#2\advance\dimen@-#1\p@ \ifdim\dimen@<\z@\dimen@-\dimen@\fi
+ \global\advance\Errsum\dimen@
+ \ifdim\dimen@>\Errmax \global\Errmax\dimen@
+ \dimen@\@tempa \edef\@@tempa{\strip@pt\dimen@}%
+ \ifColor
+ \dimen@\@tempb \edef\@@tempb{\strip@pt\dimen@}%
+ \dimen@\@tempc \edef\@@tempc{\strip@pt\dimen@}%
+ \xdef\Errcase{\@@tempa\noexpand~\@@tempb\noexpand~\@@tempc}%
+ \else
+ \xdef\Errcase{\@@tempa}%
+ \fi
+ \fi
+ \fi}
+
+\newenvironment{ColorTest}[1]%
+ {\addcontentsline{toc}{section}{Color conversion chain: #1}
+ \Colors\z@ \Errors\z@ \Loops\z@ \Errsum\z@ \Errmax\z@
+ \begin{multicols}{3}\centering}%
+ {\end{multicols}\bigskip
+ \begin{tabular}{@{}l@{ = }l@{}}
+ \multicolumn2{@{}l@{}}{Rounding error statistics of color conversion test}\\
+ \multicolumn2{@{}l@{}}%
+ {$\textbf\Modeli\rightarrow \textbf\Modelii\rightarrow \textbf\Modeliii\rightarrow
+ \textbf\Modeliv\rightarrow \textbf\Modelv\rightarrow \textbf\Modelvi$:}\\[1ex]
+ number of examples& \number\Loops\\
+ number of errors& \number\Errors\\
+ sum of absolute errors& \strip@pt\Errsum\\
+ \ifnum\Errors>\z@
+ average error& \Errsum100\Errsum \dimen@\Errors\p@ \divide\dimen@\@m
+ \rdivide\Errsum\dimen@ \strip@pt\Errsum\textperiodcentered10\textsuperscript{-5}\\
+ maximum error& \strip@pt\Errmax{} @ \Modeli~\Errcase\\
+ \fi
+ \end{tabular}\newpage}
+
+\def\thepage{\sffamily\footnotesize\@nameuse{@arabic}\c@page}
+
+\makeatother
+
+\parindent0pt
+\setcounter{secnumdepth}{-1}
+
+\begin{document}
+
+\title{Color conversion with the \textsf{xcolor} package --- Examples}
+\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}}
+\date{\XCfileversion{} (\XCfiledate)}
+\maketitle
+
+\begin{center}
+\begin{minipage}{.75\textwidth}
+\tableofcontents
+\end{minipage}
+\end{center}
+\newpage
+
+\sffamily\footnotesize
+\fboxrule.25pt
+\settowidth\Argwd{0.00000}
+
+\defModel1{rgb}{,,}0
+\defModel2{cmy}{,,}0
+\defModel3{cmyk}{,}0
+\defModel4{hsb}{,,}0
+\defModel5{rgb}{,,}1
+\defModel6{gray}{,,,,}0
+\Colortrue
+
+\begin{ColorTest}{rgb, cmy, cmyk, hsb, rgb, gray}
+\multido{\nR=1+-.1}{11}%
+ {\multido{\nG=1+-.1}{11}%
+ {\multido{\nB=1+-.1}{11}%
+ {\DisplayColor{\nR}{\nG}{\nB}}}}%
+\end{ColorTest}
+
+\defModel1{gray}{,,,,}0
+\defModel2{rgb}{,,}0
+\defModel3{cmy}{,,}0
+\defModel4{cmyk}{,}0
+\defModel5{hsb}{,,}0
+\defModel6{gray}{,,,,}1
+\Colorfalse
+
+\begin{ColorTest}{gray, rgb, cmy, cmyk, hsb, gray}
+\multido{\nG=1+-.01}{101}{\DisplayColor{\nG}{}{}}%
+\end{ColorTest}
+
+\end{document}
+\endinput
+%%
+%% End of file `xcolor1.tex'.
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf b/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf
new file mode 100644
index 00000000000..a71b77c8ca5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex
new file mode 100644
index 00000000000..38f04d8a5d4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex
@@ -0,0 +1,157 @@
+%%
+%% This is file `xcolor2.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% xcolor.dtx (with options: `test2')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from xcolor2.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file xcolor.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%
+\ProvidesFile{xcolor2}
+ [2005/10/15 v2.06 Pstricks color test (UK)]
+%%
+%% ----------------------------------------------------------------
+%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de>
+%% ----------------------------------------------------------------
+%%
+\def\XCfileversion{v2.06}%
+\def\XCfiledate{2005/10/15}%
+\listfiles
+\documentclass{article}
+
+\usepackage{pstricks,pst-tree,pst-slpe,multido}
+\makeatletter
+\@ifpackagelater{pstricks}{2004/05/12}{}{\usepackage[pst]{xcolor}}
+\makeatother
+\usepackage{fvrb-ex}
+
+\def\textfraction{0.01}
+\def\topfraction{0.99}
+\def\bottomfraction{0.99}
+\def\floatpagefraction{0.70}
+\setlength\abovecaptionskip{12pt}
+\setlength\belowcaptionskip{10pt}
+\parindent0pt
+
+\begin{document}
+\title{Color extensions with the \textsf{xcolor} package --- \textsf{pstricks} examples}
+\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}}
+\date{\XCfileversion{} (\XCfiledate)}
+\maketitle
+
+\centerline{\fcolorbox{red}{yellow!50}{This document is not suitable for pdf\LaTeX! Please use \LaTeX{} + \texttt{dvips} etc.}}
+
+\begin{figure}[htb]\caption{Modified version of an example from the \textsf{pstricks} manual; requires \textsf{pst-tree}}
+\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth]
+ \begin{pspicture}[.5](-0.5,-2)(3,2)
+ \cnode(0,0){.5cm}{root}
+ \cnode*[linecolor=red](3,1.5){4pt}{A}
+ \cnode*[linecolor=red!72.5375!blue](3,0){4pt}{B}
+ \cnode*[linecolor=-red](3,-1.5){4pt}{C}
+ \psset{nodesep=3pt}
+ \ncline[linecolor=green!50!red]{root}{A}
+ \ncline[linecolor=blue]{root}{B}
+ \ncline[linecolor=-green!50!red]{root}{C}
+ \end{pspicture}
+\end{SideBySideExample}
+\end{figure}
+
+\begin{figure}[htb]\caption{Moving from one color to its complement; requires \textsf{pst-slpe}}
+\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth]
+ \begin{pspicture}(4,1)
+ \psframe[fillstyle=slope,
+ slopeangle=30,
+ slopebegin=red!72.5375!blue,
+ slopeend=-red!72.5375!blue](4,1)
+ \end{pspicture}
+\end{SideBySideExample}
+\end{figure}
+
+\begin{figure}[htb]\caption{Explicit color specification via a loop command; requires \textsf{multido}}
+\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth]
+ \psset{unit=1.75}%
+ \begin{pspicture}(0,-1)(2,1)
+ \multido{\rHue=0.00+0.01}{100}%
+ {\pscircle[linewidth=0.01,
+ linecolor={[hsb]{\rHue,1,1}}](1,0){\rHue}}
+ \end{pspicture}
+\end{SideBySideExample}
+\end{figure}
+
+\begin{figure}[htb]\caption{Color series --- modified version of an example from the \textsf{pst-fill} manual; note that the \texttt{\string\multirput} command does not give the desired result here}
+\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth]
+ \newcommand*\Sheep
+ {\begin{pspicture}(3,1.5)
+ \pscustom[liftpen=2,fillstyle=solid,fillcolor=sheep!!+]%
+ {\pscurve(0.5,-0.2)(0.6,0.5)(0.2,1.3)(0,1.5)(0,1.5)
+ (0.4,1.3)(0.8,1.5)(2.2,1.9)(3,1.5)(3,1.5)(3.2,1.3)
+ (3.6,0.5)(3.4,-0.3)(3,0)(2.2,0.4)(0.5,-0.2)}
+ \pscircle*(2.65,1.25){0.12\psunit}% Eye
+ \psccurve*(3.5,0.3)(3.35,0.45)(3.5,0.6)(3.6,0.4)% Muzzle
+ \pscurve(3,0.35)(3.3,0.1)(3.6,0.05)% Mouth
+ \pscurve(2.3,1.3)(2.1,1.5)(2.15,1.7)
+ \pscurve(2.1,1.7)(2.35,1.6)(2.45,1.4)% Ear
+ \end{pspicture}}
+ \definecolorseries
+ {sheep}{rgb}{step}[rgb]{.95,.85,.55}{.17,.47,.37}
+ \resetcolorseries{sheep}
+ \psset{unit=0.4}
+ \begin{pspicture}(-3,-6)(0,7.5)
+ \Multido{\ry=6.0+-1.5}{5}%
+ {\rput(0,\ry){\Multido{}{5}{\Sheep}}}
+ \resetcolorseries{sheep}%
+ \multirput(-6,-6)(3,0)5{\Sheep}
+ \end{pspicture}
+\end{SideBySideExample}
+\end{figure}
+
+\begin{figure}[htb]\caption{Interaction with native PostScript code --- $\gamma$-corrected wavelengths}
+\begin{Example}[fontsize=\footnotesize,xrightmargin=.45\textwidth]
+ \newcount\WL \unitlength.75pt
+ \def\WaveToPS#1%
+ {\definecolor{tmp}{wave}{#1}\extractcolorspec{tmp}\tmp
+ \expandafter\convertcolorspec\tmp{rgb}\tmp \expandafter\WaveToPSi\tmp,}
+ \def\WaveToPSi#1,#2,#3,{\pstVerb{/Red{#1}def /Green{#2}def /Blue{#3}def}}
+ \def\DisplayBar#1#2%
+ {\linethickness{1.25\unitlength}\WL=360
+ \pstVerb{/Gamma{#1}def}%
+ \multiput(360,#2)(1,0){456}%
+ {\WaveToPS{\the\WL}{\color{lambda}\line(0,1){50}}\global\advance\WL1}%
+ \linethickness{0.25\unitlength}\WL=360
+ \multiput(360,#2)(20,0){23}%
+ {\picture(0,0)
+ \line(0,-1){5}\multiput(5,0)(5,0){3}{\line(0,-1){2.5}}%
+ \put(0,-10){\makebox(0,0){\the\WL}}\global\advance\WL20
+ \endpicture}%
+ \put(350,#2){\makebox(0,50)[r]{\small$\gamma$\,=\,#1}}}
+ \pstVerb{/Corr{dup 0 gt {Gamma exp}if}def}
+ \definecolor[ps]{lambda}{rgb}{Red Corr Green Corr Blue Corr}%
+ \begin{picture}(510,345)(310,-10)
+ \sffamily\tiny
+ \DisplayBar{0.4}{0}%
+ \DisplayBar{0.6}{70}%
+ \DisplayBar{0.8}{140}%
+ \DisplayBar{1.0}{210}%
+ \DisplayBar{1.2}{280}%
+ \end{picture}
+\end{Example}
+\end{figure}
+
+\end{document}
+\endinput
+%%
+%% End of file `xcolor2.tex'.
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex
new file mode 100644
index 00000000000..a9e6dc0613b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex
@@ -0,0 +1,131 @@
+%%
+%% This is file `xcolor3.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% xcolor.dtx (with options: `test3')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from xcolor3.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file xcolor.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%
+\ProvidesFile{xcolor3}
+ [2005/10/15 v2.06 Color logging test (UK)]
+%%
+%% ----------------------------------------------------------------
+%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de>
+%% ----------------------------------------------------------------
+%%
+\def\XCfileversion{v2.06}%
+\def\XCfiledate{2005/10/15}%
+\listfiles
+\documentclass{article}
+\usepackage[table,dvipsnames]{xcolor}[2005/03/24]
+
+\tracingcolors=4
+%%\tracingcolors=3
+%%\tracingcolors=2
+%%\tracingcolors=1
+%%\tracingcolors=0
+
+\parindent0pt
+\pagecolor{gray!25}
+
+\begin{document}
+\title{Color extensions with the \textsf{xcolor} package --- log file example}
+\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}}
+\date{\XCfileversion{} (\XCfiledate)}
+\maketitle
+
+The purpose of this file is to demonstrate the logging facilities of the \textsf{xcolor} package.
+By playing around with different values of \texttt{\string\tracingcolors}, one can observe the different behavior in the \texttt{log} file.
+
+\bigskip
+Table example:
+\rowcolors[\hline]{1}{green!25}{yellow!50}
+\begin{tabular}{ll}
+test & row \number\rownum\\
+test & row \number\rownum\\
+\rowcolor{blue!25}
+test & row \number\rownum\\
+test & row \number\rownum\\
+\hiderowcolors
+test & row \number\rownum\\
+test & row \number\rownum\\
+\showrowcolors
+test & row \number\rownum\\
+test & row \number\rownum\\
+\multicolumn{1}%
+ {>{\columncolor{red!12}}l}{test} & row \number\rownum\\
+\end{tabular}
+
+\bigskip
+\providecolor{dummy}{rgb}{.6,.5,.4}
+\definecolor{dummy}{rgb}{.6,.5,.4}
+\providecolor{dummy}{rgb}{.6,.5,.4}
+\hbox{\textcolor{dummy}{Test with \texttt{\string\definecolor}}}
+
+{\color[rgb]{.4,.5,.6}Test with \texttt{\string\color}}
+
+\bigskip
+Current color application:\par
+\def\test{current, \textcolor{.!50}{50\%}, \textcolor{-.}{complement},
+ \textcolor{yellow!50!.}{mix}}
+\textcolor{blue}{\test} and \textcolor{red}{\test},\par
+\def\Test{\color{.!80}Test}
+\textcolor{blue}{\Test\Test\Test\Test\Test} and
+\textcolor{red}{\Test\Test\Test\Test\Test}.
+
+\bigskip
+Current color test with \texttt{\string\definecolorseries}:\par
+\begingroup
+\color{blue}
+\definecolorseries{foo}{rgb}{last}{.}{-.}
+\resetcolorseries[5]{foo}
+\def\test{\hbox to 1em{{\color{foo!!+}\vrule width 1em height 1.5ex}}}
+Test\test\test\test\test\test\test Test
+
+\resetcolorseries[5]{foo}
+\def\test{\hbox to 1em{{\color{foo!!++}\vrule width 1em height 1.5ex}}}
+Test\test\test\test\test\test\test Test
+
+\resetcolorseries[5]{foo}
+\def\test{\hbox to 1em{{\color{foo!![2]}\vrule width 1em height 1.5ex}}}
+Test\test\test\test\test\test\test Test
+
+\bigskip
+\color{black}
+Test with named colors:\par
+\color{blue}
+Test: \textcolor[named]{JungleGreen}{JungleGreen};
+Test: \textcolor{JungleGreen}{JungleGreen};
+Test: \textcolor{JungleGreen!50!DarkOrchid}{JungleGreen!50!DarkOrchid};
+Test: \textcolor{green!50!red}{green!50!red}.
+\endgroup
+
+Type test:
+\makeatletter
+\@namedef{\string\color@foo1}{foo1{}{}{}{}}\edef\tempa{\XC@type{foo1}}\tempa
+\@namedef{\string\color@foo2}{\xcolor@{foo2}{}{}{}}\edef\tempb{\XC@type{foo2}}\tempb
+\@namedef{\string\color@foo3}{\xcolor@{}{foo3}{}{}}\edef\tempc{\XC@type{foo3}}\tempc
+\@namedef{\string\color@foo4}{\xcolor@{}{}{foo4}{}}\edef\tempd{\XC@type{foo4}}\tempd
+\makeatother
+
+\textcolor{rgb:red!50,4;green!25,2}{Extended color expression (rgb:red!50,4;green!25,2)}.
+
+\end{document}
+\endinput
+%%
+%% End of file `xcolor3.tex'.
diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex
new file mode 100644
index 00000000000..17d14c18a4a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex
@@ -0,0 +1,131 @@
+%%
+%% This is file `xcolor4.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% xcolor.dtx (with options: `test4')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from xcolor4.tex.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file xcolor.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%
+\ProvidesFile{xcolor4}
+ [2005/10/15 v2.06 Color driver test (UK)]
+%%
+%% ----------------------------------------------------------------
+%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de>
+%% ----------------------------------------------------------------
+%%
+\def\XCfileversion{v2.06}%
+\def\XCfiledate{2005/10/15}%
+\listfiles
+\documentclass[a4paper]{article}
+\usepackage{xcolor}
+%%\usepackage[dvipdf]{xcolor}
+%%\usepackage[dvipdfm]{xcolor}
+%%\usepackage[dvipdfmx]{xcolor}
+%%\usepackage[dvips]{xcolor}
+%%\usepackage[dvipsone]{xcolor}
+%%\usepackage[dviwin]{xcolor}
+%%\usepackage[emtex]{xcolor}
+%%\usepackage[pctex32]{xcolor}
+%%\usepackage[pctexhp]{xcolor}
+%%\usepackage[pctexps]{xcolor}
+%%\usepackage[pctexwin]{xcolor}
+%%\usepackage[pdftex]{xcolor}
+%%\usepackage[tcidvi]{xcolor}
+%%\usepackage[textures]{xcolor}
+%%\usepackage[truetex]{xcolor}
+%%\usepackage[vtex]{xcolor}
+%%\usepackage[xetex]{xcolor}
+%%\usepackage[dviwindo]{xcolor}
+%%\usepackage[oztex]{xcolor}
+%%\usepackage[xdvi]{xcolor}
+\usepackage[margin=1.25cm,noheadfoot]{geometry}
+\pagestyle{empty}
+\parindent0pt
+\nofiles
+\let\familydefault\sfdefault
+\begin{document}
+\vbox to\textheight{\vss\centering
+{\Large\textbf{xcolor} driver test: `\csname XC@@drv\endcsname'}
+\vskip0.5cm
+\begin{testcolors}[rgb,hsb,cmyk,gray,HTML]
+\testcolor{magenta}
+\testcolor[rgb]{1,0,1}
+\testcolor[hsb]{0.83333,1,1}
+\testcolor[cmyk]{0,1,0,0}
+\testcolor[gray]{0.41}
+\noalign{\medskip}
+\testcolor{blue}
+\testcolor[rgb]{0,0,1}
+\testcolor[hsb]{0.66667,1,1}
+\testcolor[cmyk]{1,1,0,0}
+\testcolor[gray]{0.11}
+\testcolor[wave]{440}
+\noalign{\medskip}
+\testcolor{cyan}
+\testcolor[rgb]{0,1,1}
+\testcolor[hsb]{0.5,1,1}
+\testcolor[cmyk]{1,0,0,0}
+\testcolor[gray]{0.7}
+\testcolor[wave]{490}
+\noalign{\medskip}
+\testcolor{green}
+\testcolor[rgb]{0,1,0}
+\testcolor[hsb]{0.33333,1,1}
+\testcolor[cmyk]{1,0,1,0}
+\testcolor[gray]{0.59}
+\testcolor[wave]{510}
+\noalign{\medskip}
+\testcolor{yellow}
+\testcolor[rgb]{1,1,0}
+\testcolor[hsb]{0.16667,1,1}
+\testcolor[cmyk]{0,0,1,0}
+\testcolor[gray]{0.89}
+\testcolor[wave]{580}
+\noalign{\medskip}
+\testcolor{red}
+\testcolor[rgb]{1,0,0}
+\testcolor[hsb]{0,1,1}
+\testcolor[cmyk]{0,1,1,0}
+\testcolor[gray]{0.3}
+\testcolor[wave]{645}
+\noalign{\medskip}
+\testcolor{black}
+\testcolor[rgb]{0,0,0}
+\testcolor[hsb]{0,0,0}
+\testcolor[cmyk]{0,0,0,1}
+\testcolor[gray]{0}
+\noalign{\medskip}
+\testcolor{gray}
+\testcolor[rgb]{0.5,0.5,0.5}
+\testcolor[hsb]{0,0,0.5}
+\testcolor[cmyk]{0,0,0,0.5}
+\testcolor[gray]{0.5}
+\noalign{\medskip}
+\testcolor{white}
+\testcolor[rgb]{1,1,1}
+\testcolor[hsb]{0,0,1}
+\testcolor[cmyk]{0,0,0,0}
+\testcolor[gray]{1}
+\end{testcolors}
+\vskip0.5cm
+{\footnotesize This table was generated with \textbf{xcolor4.tex} which is part of the \textbf{xcolor} package \XCfileversion{} (\XCfiledate) by Uwe Kern.}
+\vss}
+\end{document}
+\endinput
+%%
+%% End of file `xcolor4.tex'.