From f07bb53970ee2ecc53f81a206a3d3a67ef665e4a Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Mon, 9 Jan 2006 00:56:57 +0000
Subject: doc 6

git-svn-id: svn://tug.org/texlive/trunk@85 c570f23f-e606-0410-a88d-b1316a301751
---
 .../doc/generic/pgf/text-en/pgfmanual-en-main.tex  | 352 +++++++++++++++++++++
 1 file changed, 352 insertions(+)
 create mode 100644 Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex

(limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex')

diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
new file mode 100644
index 00000000000..992375bc778
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-main.tex
@@ -0,0 +1,352 @@
+% Copyright 2003 by Till Tantau <tantau@cs.tu-berlin.de>.
+%
+% This program can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License Distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt.
+
+% pgf version is defined in \pgfversion in file
+% generic/pgf/utilities/pgfrcs.code.tex 
+
+\def\xcolorversion{2.00}
+\def\xkeyvalversion{1.8}
+
+\usepackage[version=0.96]{pgf}
+\usepackage{tikz}
+\usepackage{pgflibraryarrows}
+\usepackage{pgflibraryshapes}
+\usepackage{pgflibrarysnakes}
+\usepackage{pgflibraryautomata}
+\usepackage{pgflibraryplotmarks}
+\usepackage{pgflibrarytikzbackgrounds}
+\usepackage{pgflibrarytikztrees}
+\usepackage[left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
+\usepackage{amsmath,amssymb}
+\usepackage{xxcolor}
+\usepackage{pifont}
+\usepackage{makeidx}
+\usepackage[latin1]{inputenc}
+\usepackage{amsmath}
+
+\input{../../macros/pgfmanual-en-macros}
+
+\makeindex
+
+\makeatletter
+\renewcommand*\l@subsection{\@dottedtocline{2}{1.5em}{2.8em}}
+\renewcommand*\l@subsubsection{\@dottedtocline{3}{4.3em}{3.2em}}
+\makeatother
+
+%\includeonly{pgfmanual-en-tikz-shapes}
+
+% Global styles:
+\tikzstyle{every plot}=[prefix=plots/pgf-]
+\tikzstyle{shape example}=[color=black!30,draw,fill=yellow!30,line width=.5cm,inner xsep=2.5cm,inner ysep=0.5cm]
+
+\index{Options for graphics|see{Graphic options}}
+\index{Options for packages|see{Package options}}
+\index{File|see{Packages and files}}
+\index{Layout|see{Page layout}}
+
+\begin{document}
+
+{
+  \parindent0pt
+\vbox{}
+\vskip 3.5cm
+\Huge
+\tikzname\ and \pgfname
+
+\Large
+Manual for Version \pgfversion
+
+\vskip 3cm 
+
+\begin{codeexample}[graphic=white]
+\tikzstyle{level 1}=[sibling angle=120]
+\tikzstyle{level 2}=[sibling angle=60]
+\tikzstyle{level 3}=[sibling angle=30]
+\tikzstyle{every node}=[fill]
+\tikzstyle{edge from parent}=[snake=expanding waves,segment length=1mm,segment angle=10,draw]
+
+\tikz [grow cyclic,shape=circle,very thick,level distance=13mm,cap=round]
+  \node {} child [color=\A] foreach \A in {red,green,blue}
+    { node {} child [color=\A!50!\B] foreach \B in {red,green,blue}
+      { node {} child [color=\A!50!\B!50!\C] foreach \C in {black,gray,white}
+        { node {} }
+      }
+    };
+\end{codeexample}
+\vskip 0cm plus 1.5fill
+\vbox{}         
+\clearpage
+}
+
+{
+  \vbox{}
+  \vskip0pt plus 1fill
+  Für meinen Vater, damit er noch viele schöne \TeX-Graphiken erschaffen kann.
+  \vskip0pt plus 3fill
+  \vbox{}
+  \clearpage
+}
+
+
+\title{The \tikzname\ and \pgfname\ Packages\\
+  Manual for Version \pgfversion\\[1mm]
+\large\href{http://sourceforge.net/projects/pgf}{\texttt{http://sourceforge.net/projects/pgf}}}
+\author{Till Tantau\\
+  \href{mailto:tantau@users.sourceforge.net}{\texttt{tantau@users.sourceforge.net}}}
+
+\maketitle
+
+\tableofcontents
+
+\clearpage
+
+\part{Getting Started}
+
+This part is intended to help you get started with the \pgfname\
+package. First, the installation process is explained; however, the
+system will typically be already installed on your system, so this can
+often be skipped. Next, a short tutorial is given that explains the
+most often used commands and concepts of \tikzname, without going into
+any of the glorious details. At the end of this section you will find
+some, hopefully useful, hints on how to create ``good'' graphics in
+general. The information in this section is not specific to
+\pgfname. 
+
+\vskip3cm
+
+\begin{codeexample}[graphic=white,width=0pt]
+\tikz \draw[thick,rounded corners=8pt]
+  (0,0) -- (0,2) -- (1,3.25) -- (2,2) -- (2,0) -- (0,2) -- (2,2) -- (0,0) -- (2,0);
+\end{codeexample}
+
+\include{pgfmanual-en-introduction}
+\include{pgfmanual-en-installation}
+\include{pgfmanual-en-tutorial}
+\include{pgfmanual-en-guidelines}
+\include{pgfmanual-en-drivers}
+
+
+\part{Ti\emph{k}Z ist \emph{kein} Zeichenprogramm}
+\label{part-tikz}
+
+\vskip3cm
+\begin{codeexample}[graphic=white]
+\begin{tikzpicture}
+  \draw[fill=yellow] (0,0) -- (60:.75cm) arc (60:180:.75cm);
+  \draw(120:0.4cm) node {$\alpha$};
+
+  \draw[fill=green!30] (0,0) -- (right:.75cm) arc (0:60:.75cm);
+  \draw(30:0.5cm) node {$\beta$};
+
+  \begin{scope}[shift={(60:2cm)}]
+    \draw[fill=green!30] (0,0) -- (180:.75cm) arc (180:240:.75cm);
+    \draw (30:-0.5cm) node {$\gamma$};
+
+    \draw[fill=yellow] (0,0) -- (240:.75cm) arc (240:360:.75cm);
+    \draw (-60:0.4cm) node {$\delta$};
+  \end{scope}
+
+  \begin{scope}[thick]
+    \draw  (60:-1cm) node[fill=white] {$E$} -- (60:3cm) node[fill=white] {$F$};
+    \draw[red]                   (-2,0) node[left] {$A$} -- (3,0) node[right]{$B$};
+    \draw[blue,shift={(60:2cm)}] (-3,0) node[left] {$C$} -- (2,0) node[right]{$D$};
+  
+    \draw[shift={(60:1cm)},xshift=4cm]
+    node [right,text width=6cm,rounded corners,fill=red!20,inner sep=1ex]
+    {
+      When we assume that $\color{red}AB$ and $\color{blue}CD$ are
+      parallel, i.\,e., ${\color{red}AB} \mathbin{\|} \color{blue}CD$,
+      then $\alpha = \delta$ and $\beta = \gamma$.
+    };
+  \end{scope}
+\end{tikzpicture}
+\end{codeexample}
+
+
+
+\include{pgfmanual-en-tikz-design}
+\include{pgfmanual-en-tikz-scopes}
+\include{pgfmanual-en-tikz-coordinates}
+\include{pgfmanual-en-tikz-paths}
+\include{pgfmanual-en-tikz-actions}
+\include{pgfmanual-en-tikz-shapes}
+\include{pgfmanual-en-tikz-trees}
+\include{pgfmanual-en-tikz-transformations}
+
+
+
+\part{Libraries and Utilities}
+\label{part-libraries}
+
+In this part the library and utility packages are documented. The
+library packages provide additional predefined graphic objects like
+new arrow heads, or new plot marks. These are not loaded by default
+since many users will not need them.
+
+The utility packages are not directly involved in creating graphics,
+but you may find them useful nonetheless. All of them either directly
+depend on \pgfname\ or they are designed to work well together with
+\pgfname\ even though they can be used in a stand-alone way.
+\vskip2cm
+\medskip
+\noindent
+\begin{codeexample}[graphic=white]
+\begin{tikzpicture}[scale=2]
+  \shade[top color=blue,bottom color=gray!50] (0,0) parabola (1.5,2.25) |- (0,0);
+  \draw (1.05cm,2pt) node[above] {$\displaystyle\int_0^{3/2} \!\!x^2\mathrm{d}x$};
+  
+  \draw[style=help lines] (0,0) grid (3.9,3.9)
+       [step=0.25cm]      (1,2) grid +(1,1);
+
+  \draw[->] (-0.2,0) -- (4,0) node[right] {$x$};
+  \draw[->] (0,-0.2) -- (0,4) node[above] {$f(x)$};
+
+  \foreach \x/\xtext in {1/1, 1.5/1\frac{1}{2}, 2/2, 3/3}
+    \draw[shift={(\x,0)}] (0pt,2pt) -- (0pt,-2pt) node[below] {$\xtext$};
+
+  \foreach \y/\ytext in {1/1, 2/2, 2.25/2\frac{1}{4}, 3/3}
+    \draw[shift={(0,\y)}] (2pt,0pt) -- (-2pt,0pt) node[left] {$\ytext$};
+    
+  \draw (-.5,.25) parabola bend (0,0) (2,4) node[below right] {$x^2$};
+\end{tikzpicture}
+\end{codeexample}
+
+\include{pgfmanual-en-libraries}
+\include{pgfmanual-en-pgffor}
+\include{pgfmanual-en-pages}
+\include{pgfmanual-en-xxcolor}
+
+
+
+\part{The Basic Layer}
+
+\vskip1cm
+\begin{codeexample}[graphic=white]
+\begin{tikzpicture}
+  \draw[gray,very thin] (-1.9,-1.9) grid (2.9,3.9)
+          [step=0.25cm] (-1,-1) grid (1,1);
+  \draw[blue] (1,-2.1) -- (1,4.1); % asymptote
+                
+  \draw[->] (-2,0) -- (3,0) node[right] {$x(t)$};
+  \draw[->] (0,-2) -- (0,4) node[above] {$y(t)$};
+
+  \foreach \pos in {-1,2}
+    \draw[shift={(\pos,0)}] (0pt,2pt) -- (0pt,-2pt) node[below] {$\pos$};
+
+  \foreach \pos in {-1,1,2,3}
+    \draw[shift={(0,\pos)}] (2pt,0pt) -- (-2pt,0pt) node[left] {$\pos$};
+
+  \fill (0,0) circle (0.064cm);
+  \draw[thick,parametric,domain=0.4:1.5,samples=200]
+    % The plot is reparameterised such that there are more samples
+    % near the center.
+    plot[id=asymptotic-example] function{(t*t*t)*sin(1/(t*t*t)),(t*t*t)*cos(1/(t*t*t))}
+    node[right] {$\bigl(x(t),y(t)\bigr) = (t\sin \frac{1}{t}, t\cos \frac{1}{t})$};
+
+  \fill[red] (0.63662,0) circle (2pt)
+    node [below right,fill=white,yshift=-4pt] {$(\frac{2}{\pi},0)$};
+\end{tikzpicture}
+\end{codeexample}
+
+
+\include{pgfmanual-en-base-design}
+\include{pgfmanual-en-base-scopes}
+\include{pgfmanual-en-base-points}
+\include{pgfmanual-en-base-paths}
+\include{pgfmanual-en-base-snakes}
+\include{pgfmanual-en-base-actions}
+\include{pgfmanual-en-base-arrows}
+\include{pgfmanual-en-base-nodes}
+\include{pgfmanual-en-base-transformations}
+\include{pgfmanual-en-base-images}
+\include{pgfmanual-en-base-shadings}
+\include{pgfmanual-en-base-plots}
+\include{pgfmanual-en-base-layers}
+\include{pgfmanual-en-base-quick}
+
+
+
+
+\part{The System Layer}
+\label{part-system}
+
+This part describes the low-level interface of \pgfname, called the
+\emph{system layer}. This interface provides a complete abstraction of
+the internals of the underlying drivers. 
+
+Unless you intend to port \pgfname\ to another driver or unless you intend
+to write your own optimized frontend, you need not read this part.
+
+In the following it is assumed that you are familiar with the basic
+workings of the |graphics| package and that you know what
+\TeX-drivers are and how they work.
+
+\vskip1cm
+\begin{codeexample}[graphic=white]
+\begin{tikzpicture}[shorten >=1pt,->]
+  \tikzstyle{vertex}=[circle,fill=black!25,minimum size=17pt,inner sep=0pt]
+  
+  \foreach \name/\x in {s/1, 2/2, 3/3, 4/4, 15/11, 16/12, 17/13, 18/14, 19/15, t/16}
+    \node[vertex] (G-\name) at (\x,0) {$\name$};
+
+  \foreach \name/\angle/\text in {P-1/234/5, P-2/162/6, P-3/90/7, P-4/18/8, P-5/-54/9}
+    \node[vertex,xshift=6cm,yshift=.5cm] (\name) at (\angle:1cm) {$\text$};
+  
+  \foreach \name/\angle/\text in {Q-1/234/10, Q-2/162/11, Q-3/90/12, Q-4/18/13, Q-5/-54/14}
+    \node[vertex,xshift=9cm,yshift=.5cm] (\name) at (\angle:1cm) {$\text$};
+
+  \foreach \from/\to in {s/2,2/3,3/4,3/4,15/16,16/17,17/18,18/19,19/t}
+    \draw (G-\from) -- (G-\to);  
+
+  \foreach \from/\to in {1/2,2/3,3/4,4/5,5/1,1/3,2/4,3/5,4/1,5/2}
+    { \draw (P-\from) -- (P-\to); \draw (Q-\from) -- (Q-\to); }
+
+  \draw (G-3) .. controls +(-30:2cm) and +(-150:1cm) .. (Q-1);
+  \draw (Q-5) -- (G-15);
+\end{tikzpicture}
+\end{codeexample}
+
+\include{pgfmanual-en-pgfsys-overview}
+\include{pgfmanual-en-pgfsys-commands}
+\include{pgfmanual-en-pgfsys-paths}
+\include{pgfmanual-en-pgfsys-protocol}
+
+
+
+\part{References and Index}
+
+\vskip1cm
+\begin{codeexample}[graphic=white]
+\begin{tikzpicture}
+  \draw[line width=0.3cm,color=red!30,cap=round,join=round] (0,0)--(2,0)--(2,5);
+  \draw[help lines] (-2.5,-2.5) grid (5.5,7.5);
+  \draw[very thick] (1,-1)--(-1,-1)--(-1,1)--(0,1)--(0,0)--
+    (1,0)--(1,-1)--(3,-1)--(3,2)--(2,2)--(2,3)--(3,3)--
+    (3,5)--(1,5)--(1,4)--(0,4)--(0,6)--(1,6)--(1,5)
+    (3,3)--(4,3)--(4,5)--(3,5)--(3,6)
+    (3,-1)--(4,-1);
+  \draw[below left] (0,0) node(s){$s$};
+  \draw[below left] (2,5) node(t){$t$};
+  \fill (0,0) circle (0.06cm) (2,5) circle (0.06cm);
+  \draw[->,rounded corners=0.2cm,shorten >=2pt]
+    (1.5,0.5)-- ++(0,-1)-- ++(1,0)-- ++(0,2)-- ++(-1,0)-- ++(0,2)-- ++(1,0)--
+    ++(0,1)-- ++(-1,0)-- ++(0,-1)-- ++(-2,0)-- ++(0,3)-- ++(2,0)-- ++(0,-1)--
+    ++(1,0)-- ++(0,1)-- ++(1,0)-- ++(0,-1)-- ++(1,0)-- ++(0,-3)-- ++(-2,0)--
+    ++(1,0)-- ++(0,-3)-- ++(1,0)-- ++(0,-1)-- ++(-6,0)-- ++(0,3)-- ++(2,0)--
+    ++(0,-1)-- ++(1,0);
+\end{tikzpicture}
+\end{codeexample}
+
+\printindex
+
+\end{document}
+
+
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: "~/texmf/tex/generic/pgf/doc/pgf/version-for-pdftex/en/pgfmanual"
+%%% End: 
-- 
cgit v1.2.3

