summaryrefslogtreecommitdiff
path: root/Build/source/utils/asymptote/doc/asymptote.texi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-04-03 22:35:04 +0000
committerKarl Berry <karl@freefriends.org>2018-04-03 22:35:04 +0000
commit36b8d1341af4a7ab1f5759d75ad1eecfc375c1f4 (patch)
tree12d09b686d2c18f245dc6fd492c09cdcd4c02ebc /Build/source/utils/asymptote/doc/asymptote.texi
parentd73e029b665b866fe734e44508746a2cba513fd7 (diff)
asy 2.42 sources
git-svn-id: svn://tug.org/texlive/trunk@47274 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/utils/asymptote/doc/asymptote.texi')
-rw-r--r--Build/source/utils/asymptote/doc/asymptote.texi60
1 files changed, 31 insertions, 29 deletions
diff --git a/Build/source/utils/asymptote/doc/asymptote.texi b/Build/source/utils/asymptote/doc/asymptote.texi
index 0c7d92a297a..278a57541c6 100644
--- a/Build/source/utils/asymptote/doc/asymptote.texi
+++ b/Build/source/utils/asymptote/doc/asymptote.texi
@@ -4,6 +4,8 @@
@include version.texi
@finalout
+@codequoteundirected on
+
@copying
This file documents @code{Asymptote}, version @value{VERSION}.
@@ -366,31 +368,17 @@ Users of the @code{Microsoft Windows} operating system can install the
self-extracting @code{Asymptote} executable @code{asymptote-x.xx-setup.exe},
where @code{x.xx} denotes the latest version.
-A working @TeX{} implementation (such as the one available at
+A working @TeX{} implementation (we recommend
+@url{https://www.tug.org/texlive} or
@url{http://www.miktex.org}) will be required to typeset labels.
You will also need to install @code{GPL Ghostscript} version 9.14 or
later from @url{http://downloads.ghostscript.com/public}.
-To view the default @code{PostScript} output, you can install the
+To view @code{PostScript} output, you can install the
program @code{gsview} available from
@url{http://www.cs.wisc.edu/~ghost/gsview/}.
-@cindex @code{psview}
-@anchor{psview}
-A better (and free) @code{PostScript} viewer available at
-@url{http://psview.sourceforge.net/} (which in particular works properly
-in interactive mode) unfortunately currently requires some manual
-configuration. Specifically, if version @code{x.xx} of @code{psview} is
-extracted to the directory @code{c:\Program Files} one needs to put
-@verbatim
-import settings;
-psviewer="c:\Program Files\psview-x.xx\psv.exe";
-@end verbatim
-@noindent
-in the optional @code{Asymptote} configuration file;
-@pxref{configuration file}).
The @code{ImageMagick} package from
-
@url{http://www.imagemagick.org/script/binary-releases.php}
@noindent
@@ -428,8 +416,7 @@ Users of @code{ggv} will need to enable @code{Watch file} under
Users of @code{gsview} will need to enable @code{Options/Auto Redisplay}
(however, under @code{MSDOS} it is still necessary to click on the
@code{gsview} window; under @code{UNIX} one must manually redisplay by
-pressing the @code{r} key). A better (and free) multiplatform
-alternative to @code{gsview} is @code{psview} (@pxref{psview}).
+pressing the @code{r} key).
@cindex @code{settings}
@cindex configuration file
@@ -2166,6 +2153,13 @@ returns an array of strings obtained by splitting @code{s} into substrings
delimited by @code{delimiter} (an empty delimiter signifies a space,
but with duplicate delimiters discarded);
+@cindex @code{array}
+@cindex @code{operator +(...string[] a)}.
+@item string[] array(string s)
+returns an array of strings obtained by splitting @code{s} into
+individual characters. The inverse operation is provided by
+@code{operator +(...string[] a)}.
+
@anchor{format}
@item string format(string s, int n, string locale="")
@cindex @code{format}
@@ -2174,14 +2168,15 @@ string @code{s} using locale @code{locale} (or the current locale if an
empty string is specified), following the behaviour of the C function
@code{fprintf}), except that only one data field is allowed.
-@item string format(string s=defaultformat, string s=defaultseparator, real x, string locale="")
+@item string format(string s=defaultformat, bool forcemath=false, string s=defaultseparator, real x, string locale="")
returns a string containing @code{x} formatted according to the C-style format
string @code{s} using locale @code{locale} (or the current locale if an
empty string is specified), following the behaviour of the C function
@code{fprintf}), except that only one data field is allowed, trailing
zeros are removed by default (unless @code{#} is specified), and
-(if the format string specifies math mode) @TeX{} is used to typeset
-scientific notation using the @code{defaultseparator="\!\times\!";};
+if @code{s} specifies math mode or @code{forcemath=true}, @TeX{} is
+used to typeset scientific notation using the
+@code{defaultseparator="\!\times\!";};
@cindex @code{hex}
@cindex @code{hexidecimal}
@@ -4465,8 +4460,11 @@ for nonintegral built-in arithmetic types @code{T}. If @code{a} and
@cindex @code{CTZ}
@code{Asymptote} also defines bitwise functions @code{int AND(int,int)},
@code{int OR(int,int)}, @code{int XOR(int,int)}, @code{int NOT(int)},
-@code{int CLZ(int)} (count leading zeros), and @code{int CTZ(int)}
-(count trailing zeros).
+@code{int CLZ(int)} (count leading zeros),
+@code{int CTZ(int)} (count trailing zeros),
+@code{int popcount(int)} (count bits populated by ones), and
+@code{int bitreverse(int a, int bits)} (reverse bits within a word of
+length bits).
@node Self & prefix operators, User-defined operators, Arithmetic & logical, Operators
@subsection Self & prefix operators
@@ -4515,7 +4513,7 @@ The following symbols may be used with @code{operator} to define or redefine
operators on structures and built-in types:
@verbatim
- + * / % ^ ! < > == != <= >= & | ^^ .. :: -- --- ++
-<< >> $ $$ @ @@
+<< >> $ $$ @ @@ <>
@end verbatim
@noindent
The operators on the second line have precedence one higher than the
@@ -5293,10 +5291,14 @@ if @code{n >= 1} returns a uniform partition of @code{[a,b]} into
@code{n} subintervals (otherwise returns a null array);
@cindex @code{find}
-@item int find(bool[], int n=1)
-returns the index of the @code{n}th @code{true} value or -1 if not found.
-If @code{n} is negative, search backwards from the end of the array for the
-@code{-n}th value;
+@item int find(bool[] a, int n=1)
+returns the index of the @code{n}th @code{true} value in the boolean array
+@code{a} or -1 if not found. If @code{n} is negative, search backwards
+from the end of the array for the @code{-n}th value;
+
+@cindex @code{findall}
+@item int[] findall(bool[] a)
+returns the indices of all @code{true} values in the boolean array @code{a}.
@cindex @code{search}
@item int search(T[] a, T key)