diff options
Diffstat (limited to 'graphics/pgf/base/doc')
-rw-r--r-- | graphics/pgf/base/doc/ChangeLog | 200 | ||||
-rw-r--r-- | graphics/pgf/base/doc/FILES | 1 | ||||
-rw-r--r-- | graphics/pgf/base/doc/RELEASE_NOTES.md | 6 | ||||
-rw-r--r-- | graphics/pgf/base/doc/pgfmanual.pdf | bin | 10580316 -> 10185873 bytes | |||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-base-nodes.tex | 3 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-guidelines.tex | 2 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-library-edges.tex | 3 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-library-fpu.tex | 3 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-library-math.tex | 22 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-math-parsing.tex | 13 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-pgfkeys.tex | 3 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-graphs.tex | 2 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-shapes.tex | 4 | ||||
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-tutorial.tex | 2 |
14 files changed, 239 insertions, 25 deletions
diff --git a/graphics/pgf/base/doc/ChangeLog b/graphics/pgf/base/doc/ChangeLog index 4e3c19950c..62f9b71680 100644 --- a/graphics/pgf/base/doc/ChangeLog +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/FILES b/graphics/pgf/base/doc/FILES index 98478c08d6..eee8e8ce0c 100644 --- a/graphics/pgf/base/doc/FILES +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/RELEASE_NOTES.md b/graphics/pgf/base/doc/RELEASE_NOTES.md index 6fc188431c..9c9e4b60e8 100644 --- a/graphics/pgf/base/doc/RELEASE_NOTES.md +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/pgfmanual.pdf b/graphics/pgf/base/doc/pgfmanual.pdf Binary files differindex 47b3273441..a309703c55 100644 --- a/graphics/pgf/base/doc/pgfmanual.pdf +++ b/graphics/pgf/base/doc/pgfmanual.pdf diff --git a/graphics/pgf/base/doc/text-en/pgfmanual-en-base-nodes.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-base-nodes.tex index 29034d17cb..19499ec551 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-base-nodes.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-guidelines.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-guidelines.tex index e59a2b19ec..fa29cce302 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-guidelines.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-library-edges.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-library-edges.tex index 7207fb1612..51332af0cc 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-library-edges.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-library-fpu.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-library-fpu.tex index 04989eef44..6c0f62f5f5 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-library-fpu.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-library-math.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-library-math.tex index 7f0b429f1b..8fabb4998e 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-library-math.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-math-parsing.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-math-parsing.tex index d694ef7355..c0d32d4d9c 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-math-parsing.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-pgfkeys.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-pgfkeys.tex index 641bae58f2..95994059da 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-pgfkeys.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-graphs.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-graphs.tex index bfe669c724..0135679c6e 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-graphs.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-shapes.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-shapes.tex index eb23cd90d8..aa9b1a8962 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-tikz-shapes.tex +++ b/graphics/pgf/base/doc/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/graphics/pgf/base/doc/text-en/pgfmanual-en-tutorial.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-tutorial.tex index 7f334ddc7f..ae2c47cdc9 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-tutorial.tex +++ b/graphics/pgf/base/doc/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 |