summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-05-15 20:36:08 +0000
committerKarl Berry <karl@freefriends.org>2021-05-15 20:36:08 +0000
commit544b3afa0b563118bfa9a64d8ab468ee47c1fbd2 (patch)
tree5daa86acec73defb207aefe148404f0131e08e45 /Master/texmf-dist/doc/generic
parentbf129e8b52e880fb8fdf9d68afd6995df3f225ed (diff)
pgf (15may21)
git-svn-id: svn://tug.org/texlive/trunk@59210 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/ChangeLog200
-rw-r--r--Master/texmf-dist/doc/generic/pgf/FILES1
-rw-r--r--Master/texmf-dist/doc/generic/pgf/README.md53
-rw-r--r--Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md6
-rw-r--r--Master/texmf-dist/doc/generic/pgf/pgfmanual.pdfbin10580316 -> 10185873 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-nodes.tex3
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-guidelines.tex2
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-edges.tex3
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fpu.tex3
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-math.tex22
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-math-parsing.tex13
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfkeys.tex3
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-graphs.tex2
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-shapes.tex4
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tutorial.tex2
15 files changed, 292 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/ChangeLog b/Master/texmf-dist/doc/generic/pgf/ChangeLog
index 4e3c19950cb..62f9b716808 100644
--- a/Master/texmf-dist/doc/generic/pgf/ChangeLog
+++ b/Master/texmf-dist/doc/generic/pgf/ChangeLog
@@ -1,3 +1,203 @@
+2021-05-15 Henri Menke
+
+ - Release 3.1.9a
+
+2021-05-08 Henri Menke
+
+ - Merge pull request #1012 from TorbjornT/incontrol_doc
+
+2021-05-08 Torbjørn T
+
+ - Specify that relative coord is to end point
+
+2021-04-12 Henri Menke
+
+ - Merge pull request #1005 from kechtel/patch-1
+
+2021-04-12 Christoph Kecht
+
+ - Fix typo in guidelines on graphics
+
+2021-04-11 Henri Menke
+
+ - CI: Expire the cache
+
+2021-04-11 Henri Menke
+
+ - Merge pull request #1004 from michal-h21/patch-1
+
+2021-04-11 Michal Hoftich
+
+ - Update pgfsys-dvisvgm4ht.def
+
+2021-04-03 Henri Menke
+
+ - Merge pull request #1003 from tknuth/patch-1
+
+2021-04-03 Dr. Tobias Knuth
+
+ - fixed typo
+
+2021-04-02 muzimuzhi
+
+ - Merge pull request #977 from muzimuzhi/pgf-point-node-border
+
+2021-04-01 muzimuzhi
+
+ - adjust comments
+
+2021-01-16 muzimuzhi
+
+ - \pgfpointshapeborder: measure by distance < 0.02pt
+
+2021-01-14 muzimuzhi
+
+ - \pgfpointshapeborder: more doc words
+
+2021-01-13 muzimuzhi
+
+ - doc: use paired `` and ''
+
+2021-01-13 muzimuzhi
+
+ - \pgfpointshapeborder: doc new behavior
+
+2021-01-13 muzimuzhi
+
+ - pgf/shapes: add warning when \pgfpointshapeborder gives up
+
+2021-01-10 muzimuzhi
+
+ - pgf/shapes: improve \pgfpointshapeborder, #908
+
+2021-03-25 Henri Menke
+
+ - Merge pull request #1002 from muzimuzhi/edef-keys
+
+2021-03-24 muzimuzhi
+
+ - pgfkeys: enhance edef keys, #305
+
+2021-03-05 Henri Menke
+
+ - fixup! build: copy the README into the TDS archive
+
+2021-03-02 Henri Menke
+
+ - build: copy the README into the TDS archive
+
+2021-03-02 Henri Menke
+
+ - Release 3.1.9
+
+2021-03-02 Henri Menke
+
+ - Merge pull request #996 from muzimuzhi/dvips-blend-mode
+
+2021-02-28 muzimuzhi
+
+ - dvips: fix displacement after blend group, #995
+
+2021-02-24 muzimuzhi
+
+ - Revert "syntax is similar to METAPOST not METAFONT"
+
+2021-02-23 muzimuzhi
+
+ - Merge pull request #994 from itmm/master
+
+2021-02-22 Timm Knape
+
+ - syntax is similar to METAPOST not METAFONT
+
+2021-02-14 Henri Menke
+
+ - Merge pull request #992 from joel-coffman/dev/fix-code-2-args-documentation
+
+2021-02-13 Joel Coffman
+
+ - Correct documentation for .code 2 args second arg
+
+2021-01-22 Henri Menke
+
+ - Merge pull request #987 from muzimuzhi/doc-typo
+
+2021-01-22 muzimuzhi
+
+ - doc: fix typo #986
+
+2021-01-14 muzimuzhi
+
+ - Merge pull request #981 from muzimuzhi/fix-tikz@handle
+
+2021-01-14 muzimuzhi
+
+ - Apply suggestions from code review
+
+2021-01-13 muzimuzhi
+
+ - tikz: fix uses of \pgfutil@switch
+
+2021-01-11 Henri Menke
+
+ - Merge pull request #979 from muzimuzhi/doc-install-only
+
+2021-01-11 muzimuzhi
+
+ - doc/fpu: fpu: mark /pgf/fpu/install only as not experimental
+
+2020-12-25 Henri Menke
+
+ - Fix and document dim() #964
+
+2021-01-04 Henri Menke
+
+ - Merge pull request #976 from muzimuzhi/tikz-math
+
+2021-01-05 muzimuzhi
+
+ - tikz/math: gobble spaces between for list and loop body
+
+2021-01-04 Henri Menke
+
+ - Merge pull request #970 from muzimuzhi/reset-tikz@expandcount
+
+2021-01-05 muzimuzhi
+
+ - tikz: retry to handle \relax on path #966
+
+2021-01-04 Henri Menke
+
+ - tikz/calendar: switch over \pgf@let@token in \tikz@lib@cal@handle
+
+2021-01-02 Henri Menke
+
+ - Merge pull request #973 from schtandard/spurious_show
+
+2021-01-02 schtandard
+
+ - Remove a spurious \show
+
+2021-01-02 Henri Menke
+
+ - Merge pull request #972 from alisaaalehi/patch-1
+
+2021-01-02 Ali Salehi
+
+ - doc: fix typo
+
+2021-01-01 Henri Menke
+
+ - tikz: switch over \pgf@let@token in \tikz@handle
+
+2020-12-29 Henri Menke
+
+ - tikz: improve \tikz@expandcount handling
+
+2020-12-29 muzimuzhi
+
+ - tikz: reset \tikz@expandcount more frequent #969
+
2020-12-27 Henri Menke
- Release 3.1.8b
diff --git a/Master/texmf-dist/doc/generic/pgf/FILES b/Master/texmf-dist/doc/generic/pgf/FILES
index 98478c08d6f..eee8e8ce0c7 100644
--- a/Master/texmf-dist/doc/generic/pgf/FILES
+++ b/Master/texmf-dist/doc/generic/pgf/FILES
@@ -1,6 +1,7 @@
doc/generic/pgf/ChangeLog
doc/generic/pgf/FILES
doc/generic/pgf/INSTALL
+doc/generic/pgf/README.md
doc/generic/pgf/RELEASE_NOTES.md
doc/generic/pgf/description.html
doc/generic/pgf/extract.lua
diff --git a/Master/texmf-dist/doc/generic/pgf/README.md b/Master/texmf-dist/doc/generic/pgf/README.md
new file mode 100644
index 00000000000..8be5668d45a
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pgf/README.md
@@ -0,0 +1,53 @@
+# pgf – A Portable Graphic Format for TeX
+
+![CI](https://github.com/pgf-tikz/pgf/workflows/CI/badge.svg)
+
+PGF is a TeX macro package for generating graphics. It is platform-
+and format-independent and works together with the most important TeX
+backend drivers, including `pdftex` and `dvips`. It comes with a
+user-friendly syntax layer called Ti*k*Z.
+
+See the directory `doc/generic/pgf` for more information. See the file
+`doc/generic/pgf/pgfmanual.pdf` (also available from
+https://pgf-tikz.github.io/pgf/pgfmanual.pdf) for a manual. This
+documentation also explains the installation. See the file
+`doc/generic/pgf/license/LICENSE` for license details.
+
+Please go to the official repository at https://github.com/pgf-tikz/pgf or the
+official mailing list at https://tug.org/mailman/listinfo/pgf-tikz to submit
+bug reports, request new features, etc.
+
+## Installation
+
+In general you should just use the version of PGF that is shipped by
+your TeX distribution. See their documentation on how to install
+packages.
+
+If you are feeling adventurous you can install the latest development
+version in TeX Live from our tlcontrib repository.
+```console
+$ tlmgr repository add http://pgf-tikz.github.io/pgf/tlnet pgf-development
+$ tlmgr pinning add pgf-development "*"
+$ tlmgr update --self --all
+$ tlmgr install pgf --reinstall
+```
+
+## Development
+
+Currently PGF does not have a comprehensive test suite to check for
+regressions, so for now we check for bugs by building the manual for
+each commit. To build the manual locally you can either copy the PGF
+repository into your texmf tree (not recommended) or use the usertree
+option of TeX Live. For the usertree option on GNU/Linux, follow
+these steps:
+```console
+$ git clone https://github.com/pgf-tikz/pgf
+$ tlmgr init-usertree --usertree pgf
+$ export TEXMFHOME=$(readlink -f pgf)
+$ cd pgf
+$ texlua build.lua manual luatex
+```
+We recommend building at least the version for LuaTeX, as shown in the
+example above because this has the broadest coverage of PGF features.
+To test the animations feature you have to build the version for
+dvisvgm.
diff --git a/Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md b/Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md
index 6fc188431c5..9c9e4b60e87 100644
--- a/Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md
+++ b/Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md
@@ -1,5 +1 @@
-Hotfix for handling of TeX conditionals on a path. We can't forward \relax and
-frozen \relax through the parser because there is existing code that relies on
-this.
-
-The recommendation is to use expandable conditionals where possible.
+Emergency release to fix pgfplots which depends on unreleased parts of PGF.
diff --git a/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf b/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf
index 47b3273441b..a309703c557 100644
--- a/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf
+++ b/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-nodes.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-nodes.tex
index 29034d17cb7..19499ec5517 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-nodes.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-base-nodes.tex
@@ -601,6 +601,9 @@ commands:
\end{pgfpicture}
\end{codeexample}
%
+ \emph{Remark:} If the given \meta{point} is almost identical to the center
+ of \meta{node}, the node center is returned and a warning message will be
+ printed.
\end{command}
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-guidelines.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-guidelines.tex
index e59a2b19ecf..fa29cce3024 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-guidelines.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-guidelines.tex
@@ -320,7 +320,7 @@ is ``the graphic looks nicer than the table'', try to answer the following
questions based on the information in the table or in the graphic:
%
\begin{enumerate}
- \item How many participants where there?
+ \item How many participants were there?
\item How many participants returned the feedback form?
\item What percentage of the participants returned the feedback form?
\item How many participants checked ``very good''?
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-edges.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-edges.tex
index 7207fb1612b..51332af0cc3 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-edges.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-edges.tex
@@ -253,7 +253,8 @@ this curve looks can be influenced via a number of options.
%
\begin{key}{/tikz/in control=\meta{coordinate}}
This option causes the \meta{coordinate} to be used as the target
- control point.
+ control point. You can use a coordinate like |+(1,0)| to specify
+ a point relative to the \emph{end} coordinate.
\end{key}
%
\begin{key}{/tikz/controls=\meta{coordinate}| and |\meta{coordinate}}
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fpu.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fpu.tex
index 04989eef44d..6c0f62f5f5f 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fpu.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-fpu.tex
@@ -179,7 +179,8 @@ by \pgfname.
\endgroup
\end{codeexample}
%
- \emph{This key is experimental and can change or disappear at any time!}
+ This key is introduced in \pgfname v3.1.6 and marked stable since \pgfname
+ v3.1.8.
\end{key}
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-math.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-math.tex
index 7f0b429f1be..8fabb4998e5 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-math.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-math.tex
@@ -68,7 +68,7 @@ following command:
};
};
int \f, \i;
- for \i in {0,1,...,20}{
+ for \i in {0,1,...,20} {
\f = fibonacci(\i);
print {\f, };
};
@@ -86,8 +86,8 @@ In addition to this command the following key is provided:
\tikz[x=0.25cm,y=0.25cm,
evaluate={
int \i, \j;
- for \i in {0,...,10}{
- for \j in {0,...,10}{
+ for \i in {0,...,10} {
+ for \j in {0,...,10} {
\a{\i,\j} = (\i+\j)*5;
};
};
@@ -295,7 +295,7 @@ following keyword.
\subsection{Repeating Things}
-\begin{math-keyword}{{for} \meta{variable} \texttt{in \{}\meta{list}\texttt{\}\{}\meta{expressions}\texttt{\};}}
+\begin{math-keyword}{{for} \meta{variable} \texttt{in \{}\meta{list} \texttt{\}\{}\meta{expressions}\texttt{\};}}
This is a ``trimmed down'' version of the |\foreach| command available as
part of \pgfname\ and \tikzname, but cannot currently be used outside of
the |\tikzmath| command. It is important to note the following:
@@ -310,7 +310,7 @@ following keyword.
\tikzmath{
int \x, \v;
\v=1;
- for \x in {1,...,{random(3,10)}}{
+ for \x in {1,...,{random(3,10)}} {
\v=\v*2;
};
print {$x=\x, v=\v$};
@@ -333,8 +333,8 @@ following keyword.
\tikzmath{
int \x, \y;
\y = 0;
- for \x1 in {1,...,5}{
- for \x2 in {10,20,...,50}{
+ for \x1 in {1,...,5} {
+ for \x2 in {10,20,...,50} {
\y = \y+\x1*\x2;
};
};
@@ -365,7 +365,7 @@ of an expression. In this case the following keyword can be used:
\begin{tikzpicture}
\tikzmath{
int \x;
- for \k in {0,10,...,350}{
+ for \k in {0,10,...,350} {
if \k>260 then { let \c = orange; } else {
if \k>170 then { let \c = blue; } else {
if \k>80 then { let \c = red; } else {
@@ -409,7 +409,7 @@ You can add functions by using the following keywords:
function product(\x,\y) {
return \x*\y;
};
- int \i, \i, \k;
+ int \i, \j, \k;
\i = random(1,10);
\j = random(20, 40);
\k = product(\i, \j);
@@ -441,7 +441,7 @@ options. Firstly, the following keyword can be used:
\tikzmath{
int \x, \y, \z;
\x = random(2, 5);
- for \y in {0,...,6}{
+ for \y in {0,...,6} {
\z = \x^\y;
print {$\x^\y=\z$, };
};
@@ -462,7 +462,7 @@ executed inside a |tikzpicture|.
\draw [help lines] grid (3,2);
\tikzmath{
coordinate \c;
- for \x in {0,10,...,360}{
+ for \x in {0,10,...,360} {
\c = (1.5cm, 1cm) + (\x:1cm and 0.5cm);
{ \fill (\c) circle [radius=1pt]; };
};
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-math-parsing.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-math-parsing.tex
index d694ef73559..c0d32d4d9c6 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-math-parsing.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-math-parsing.tex
@@ -484,7 +484,7 @@ The following functions are recognized:
\begin{tikzpicture}
\foreach \f [count=\i from 0] in
{abs,acos,add,and,array,asin,atan,atan2,bin,ceil,cos,
- cosec,cosh,cot,deg,depth,div,divide,e,equal,factorial, false,
+ cosec,cosh,cot,deg,depth,dim,div,divide,e,equal,factorial, false,
floor,frac,gcd,greater,height,hex,Hex,int,ifthenelse,iseven,isodd,isprime,
less,ln,log10,log2,max,min,mod,Mod,multiply,
neg,not,notequal,notgreater,notless,
@@ -1332,6 +1332,17 @@ some notable exceptions.
%
\end{math-function}
+\begin{math-function}{dim(\mvar{x})}
+\mathcommand
+ This returns the dimension of the array \mvar{x}. The array must begin and
+ end with braces (e.g., |{1,2,3,4}|).
+ %
+\begin{codeexample}[]
+\pgfmathparse{dim({1,2,3,4})} \pgfmathresult
+\end{codeexample}
+ %
+\end{math-function}
+
The following hyperbolic functions were adapted from code suggested by Martin
Heller:
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfkeys.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfkeys.tex
index 641bae58f24..95994059dac 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfkeys.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfkeys.tex
@@ -1025,9 +1025,6 @@ A number of handlers exist for defining the code of keys.
\pgfkeys{/page size={30cm}{20cm}}
\end{codeexample}
%
- The second argument is optional: if it is not provided, it will be the
- empty string.
-
Because of the special way the \meta{value} is parsed, if you set
\meta{value} to, for instance, |first| (without any braces), then |#1| will
be set to |f| and |#2| will be set to |irst|.
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-graphs.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-graphs.tex
index bfe669c7247..0135679c6e7 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-graphs.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-graphs.tex
@@ -270,7 +270,7 @@ preamble) results in the following somewhat more pleasing rendering:
\subsubsection{Concept: Edge Labels and Styles}
When connectors like |->| or |--| are used to connect nodes or whole chain
-groups, one or more edges will typically be created. These edges can be styles
+groups, one or more edges will typically be created. These edges can be styled
easily by providing options in square brackets directly after these connectors:
%
\begin{codeexample}[preamble={\usetikzlibrary{graphs}}]
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-shapes.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-shapes.tex
index eb23cd90d8e..aa9b1a89621 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-shapes.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-shapes.tex
@@ -2627,6 +2627,10 @@ Section~\ref{section-node-coordinates}. Suppose you have said
Likewise, |(1,1)--(x)| will also have the line end on the border in the
direction coming from |(1,1)|.
+ If the specified coordinate is almost identical to the node center, for
+ example |(x)--(0,0)|, no line will be drawn and a warning message will
+ be printed.
+
In addition to |--|, the curve-to path operation |..| and the path
operations \verb!-|! and \verb!|-! will also handle nodes without
anchors correctly. Here is an example, see also
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tutorial.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tutorial.tex
index 7f334ddc7f3..ae2c47cdc91 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tutorial.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tutorial.tex
@@ -793,7 +793,7 @@ from where the sine ends:
\end{codeexample}
Note that there is no |--| between |(30:1cm)| and |++(0,-0.5)|. In detail, this
-path is interpreted as follows: ``First, the |(30:1cm)| tells me to move by pen
+path is interpreted as follows: ``First, the |(30:1cm)| tells me to move my pen
to $(\cos 30^\circ,1/2)$. Next, there comes another coordinate specification,
so I move my pen there without drawing anything. This new point is half a unit
down from the last position, thus it is at $(\cos 30^\circ,0)$. Finally, I move