painful pgfplots update (14jun08)

git-svn-id: svn://tug.org/texlive/trunk@8751 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 14 insertions, 26 deletions

diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex
index 0761f12be9c..13bb6c9afdd 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex
@@ -19,33 +19,14 @@ doc/latex/pgfplots/gpl-3.0.txt
 You may also visit~\url{http://www.gnu.org/licenses}.
 
 \subsection{Prerequisites}
-\PGFPlots\ requires \PGF\ version $\ge 1.18$ and package \texttt{xkeyval}.
-
-\subsection{Files in the \PGFPlots-Bundle}
-The \PGFPlots\ package consists of the files
-\begin{lstlisting}
-latex/pgfplots/pgfplots.sty
-generic/pgfmathlog/pgfmathlog.sty
-generic/liststructure/liststructure.sty
-generic/sciformat/sciformat.sty
-generic/pgfplotshelpers/pgfplotshelpers.sty
-doc/latex/pgfplots/pgfplots.bib
-doc/latex/pgfplots/pgfplots.*tex
-doc/latex/pgfplots/pgfplots.pdf
-doc/latex/pgfplots/todo.txt
-doc/latex/pgfplots/changelog.txt
-test/liststructuretest/liststructuretest.tex
-test/pgfplotstest/pgfplotstest.tex
-test/pgfmathlogtest/pgfmathlogtest.tex
-ext_scripts/pgf2pdf.sh
-ext_scripts/matlab2pgfplots.m
-ext_scripts/matlab2pgfplots.sh
-\end{lstlisting}
-If is used with
+\PGFPlots\ requires \PGF\ with \textbf{at least version~$2.0$}. It is used with
 \begin{lstlisting}
 \usepackage{pgfplots}
 \end{lstlisting}
-in your preamble. There are several ways how to teach \LaTeX\ where to find the files. Choose the option which fits your needs best.
+in your preamble (see section~\ref{sec:tex:dialects} for information about how to use it with Con{\TeX}t and plain \TeX). There are several ways how to teach \TeX\ where to find the files. Choose the option which fits your needs best.
+
+\subsection{Installation in Windows}
+Windows users often use Mik\TeX\ which downloads the latest stable package versions automatically. As far as I know, you do not need to install anything manually here.
 
 \subsection{Assigning the \texttt{TEXINPUTS} Variable}
 You can simply install \PGFPlots\ anywhere on your disc, for example into
@@ -56,10 +37,16 @@ Then, you set the \texttt{TEXINPUTS} variable to
 \begin{lstlisting}
 TEXINPUTS=/foo/bar/pgfplots//:
 \end{lstlisting}
-The trailing~`\texttt{:}' tells \LaTeX\ to check the default search paths after \lstinline!/foo/bar/pgfplots!. The double slash~`\texttt{//}' tells \LaTeX\ to search all subdirectories.
+The trailing~`\texttt{:}' tells \TeX\ to check the default search paths after \lstinline!/foo/bar/pgfplots!. The double slash~`\texttt{//}' tells \TeX\ to search all subdirectories.
 
 If the \texttt{TEXINPUTS} variable already contains something, you can append the line above to the existing \texttt{TEXINPUTS} content.
 
+Furthermore, you should set |TEXDOCS| as well,
+\begin{lstlisting}
+TEXDOCS=/foo/bar/pgfplots//:
+\end{lstlisting}
+so that the \TeX-documentation system finds the files |pgfplots.pdf| and |pgfplotstable.pdf| (on some systems, it is then enough to use |texdoc pgfplots|).
+
 Please refer to your operating systems manual for how to set environment variables.
 
 \subsection{Installation into a local \texttt{texmf}-directory}
@@ -71,13 +58,14 @@ A TDS conforming installation will use the same base directory as in the last se
 Do not forget to run \lstinline!texhash!.
 
 \subsection{If everything else fails...}
-If \LaTeX\ still doesn't find your files, you can copy all \lstinline!.sty!-files into your current project's working directory.
+If \TeX\ still doesn't find your files, you can copy all \lstinline!.sty!-files into your current project's working directory.
 
 Please refer to \url{http://www.ctan.org/installationadvice/} for more information about package installation.
 
 
 
 \subsection{Restrictions for DVI-Viewers and \texttt{dvipdfm}}
+\label{sec:drivers}%
 \PGF\ is compatible with 
 \begin{itemize}
 	\item \lstinline!latex!/\lstinline!dvips!,