From 0258bc8612e27c4ad2f1f1bdba6f31cd54eb96ce Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 4 May 2020 21:17:09 +0000 Subject: curve2e (4may20) git-svn-id: svn://tug.org/texlive/trunk@55009 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/curve2e/README.txt | 2 +- .../doc/latex/curve2e/curve2e-manual.pdf | Bin 565999 -> 567196 bytes .../doc/latex/curve2e/curve2e-manual.tex | 40 +++++++++++++-------- Master/texmf-dist/doc/latex/curve2e/curve2e.pdf | Bin 648539 -> 649719 bytes 4 files changed, 27 insertions(+), 15 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/curve2e/README.txt b/Master/texmf-dist/doc/latex/curve2e/README.txt index d805a99f290..dac99619c6b 100644 --- a/Master/texmf-dist/doc/latex/curve2e/README.txt +++ b/Master/texmf-dist/doc/latex/curve2e/README.txt @@ -10,7 +10,7 @@ %% License information appended %% File README.txt for package curve2e - [2020-04-02 v.2.2.6 Extension package for pict2e] + [2020-05-03 v.2.2.8 Extension package for pict2e] The package bundle curve2e is composed of the following files curve2e.dtx diff --git a/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.pdf b/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.pdf index 9d0fc06c453..034014125ea 100644 Binary files a/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.pdf and b/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.pdf differ diff --git a/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.tex b/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.tex index 23a35a8f85a..87961a4cd96 100644 --- a/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.tex +++ b/Master/texmf-dist/doc/latex/curve2e/curve2e-manual.tex @@ -1279,7 +1279,7 @@ Remember to delete all these subfolders if you decide to install a complete upda \multiput(50,50)(-15:5){11}{\polygon*(-1,-1)(1,-1)(1,1)(-1,1)} \end{picture} \end{minipage} -\caption{Some examples of the \meta{handler} optional argument}%\label{pag:multiput} +\caption{Some examples of the \meta{handler} optional argument}\label{pag:multiput} \end{figure} A new command |\xmultiput| (not available with the previous versions @@ -1331,14 +1331,14 @@ Remember to delete all these subfolders if you decide to install a complete upda \end{figure} \item This implementation of \pack{curve2e} includes an extension - to package |xfp|, in the sense that adds two more L3 commands: - |\fptest| and |\fpdowhile| to the two already contained and + to package |xfp|, in the sense that adds three more L3 commands: + |\fptest|, |\fpdowhile|, |fpwhiledo| to the two already contained and documented in the latter package. The syntax of such new commands is the following \begin{flushleft}\obeylines \cs{fptext}\marg{test}\marg{true}\marg{false} - and \cs{fpdowhile}\meta{test}\meta{operations to be repeated} + \cs{fpwhiledo}\meta{test}\meta{operations to be repeated} \end{flushleft} The macro |\fptest| requires two further arguments that contain what to do if the \meta{test} is true, and what to do if the @@ -1346,20 +1346,32 @@ Remember to delete all these subfolders if you decide to install a complete upda The \meta{test} is a logical expressions that connects math relation expressions, even floating point ones, by means of \emph{logical operators}; such operators are \verb+||+, \verb|&&|, and \verb|!|, - respectively for OR, AND, NOT; for example \verb|!<| means “not lower - than”, which is equivalent to “equal or grater than”. The logical - expression is parsed left to right and normal parentheses may be - used to alter this sequence. The logical operators work also - between logical variables, therefore the \meta{test} may contain - an interesting mixture of relation and logical operators. - - Before using |\fpdowhile| the arguments the \meta{test} depends - from must be set so that the test is true; during the execution + respectively for OR, AND, NOT; math relation expressions contain + relation operators, even negated ones: for example \verb|!<| means + “not lower than”, which is equivalent to “equal or grater than”, i.e. + \verb|=>|. The logical expression is parsed left to right and normal + parentheses may be used to alter this sequence. The logical operators + work also between logical variables, therefore the \meta{test} may + contain an interesting mixture of relation and logical operators. + + Before using |\fpdowhile| and |\fpwhiledo|the arguments of \meta{test} + depends on must be set so that the test is true; during the execution of the \meta{operations to be repeated} there must be some setting that eventually renders the \meta{test} false. The user should - pay attention to set the elements that \meta{test} depends from, + pay attention to set the elements that \meta{test} depends on, because the risk is to enter an infinite loop and end up with some error message stating that the working memory of the program is full. + Notice that |\fpdowhile| first puts the \meta{operations to be repeated} + into the work flow then checks the \meta{test} and possibly repeats the + cycle; on the opposite, |\fpwhiledo| first checks the \meta{test} then + possibly inserts the \meta{operations to be repeated} and cycles. + Evidently with the same \meta{test} the two while cycles produce + different results with a little, but important difference: if the input + data are macros defined by previous computations, there is no guarantee + that the \meta{test} is initially true; if it sis false, |fpwhiledo| + does not do anything, while |\fpdowhile| executes one cycle and produces + in the output stream something that might be nonsense. While cycles done + with |\fpwhiledo| should be safer and should be preferred. Nevertheless such commands are very useful also for drawing graphics; the |xmultiput| already makes use of such L3~functions. diff --git a/Master/texmf-dist/doc/latex/curve2e/curve2e.pdf b/Master/texmf-dist/doc/latex/curve2e/curve2e.pdf index 21c403da848..81441253bd5 100644 Binary files a/Master/texmf-dist/doc/latex/curve2e/curve2e.pdf and b/Master/texmf-dist/doc/latex/curve2e/curve2e.pdf differ -- cgit v1.2.3