From 544b3afa0b563118bfa9a64d8ab468ee47c1fbd2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 15 May 2021 20:36:08 +0000 Subject: pgf (15may21) git-svn-id: svn://tug.org/texlive/trunk@59210 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/pgf/ChangeLog | 200 +++++++++++++++++++++ Master/texmf-dist/doc/generic/pgf/FILES | 1 + Master/texmf-dist/doc/generic/pgf/README.md | 53 ++++++ Master/texmf-dist/doc/generic/pgf/RELEASE_NOTES.md | 6 +- Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf | Bin 10580316 -> 10185873 bytes .../pgf/text-en/pgfmanual-en-base-nodes.tex | 3 + .../pgf/text-en/pgfmanual-en-guidelines.tex | 2 +- .../pgf/text-en/pgfmanual-en-library-edges.tex | 3 +- .../pgf/text-en/pgfmanual-en-library-fpu.tex | 3 +- .../pgf/text-en/pgfmanual-en-library-math.tex | 22 +-- .../pgf/text-en/pgfmanual-en-math-parsing.tex | 13 +- .../generic/pgf/text-en/pgfmanual-en-pgfkeys.tex | 3 - .../pgf/text-en/pgfmanual-en-tikz-graphs.tex | 2 +- .../pgf/text-en/pgfmanual-en-tikz-shapes.tex | 4 + .../generic/pgf/text-en/pgfmanual-en-tutorial.tex | 2 +- 15 files changed, 292 insertions(+), 25 deletions(-) create mode 100644 Master/texmf-dist/doc/generic/pgf/README.md (limited to 'Master/texmf-dist/doc/generic') 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 Binary files a/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf and b/Master/texmf-dist/doc/generic/pgf/pgfmanual.pdf 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 -- cgit v1.2.3