asymptote 2.02

git-svn-id: svn://tug.org/texlive/trunk@19435 c570f23f-e606-0410-a88d-b1316a301751

16 files changed, 290 insertions, 398 deletions

diff --git a/Master/texmf/doc/asymptote/CAD.pdf b/Master/texmf/doc/asymptote/CAD.pdf
index 327f2ff3b0b..59b899d3388 100644
--- a/Master/texmf/doc/asymptote/CAD.pdf
+++ b/Master/texmf/doc/asymptote/CAD.pdf
diff --git a/Master/texmf/doc/asymptote/asymptote.pdf b/Master/texmf/doc/asymptote/asymptote.pdf
index d4a834d8dde..d480d1c6d84 100644
--- a/Master/texmf/doc/asymptote/asymptote.pdf
+++ b/Master/texmf/doc/asymptote/asymptote.pdf
diff --git a/Master/texmf/doc/asymptote/examples/animations/inlinemovie.tex b/Master/texmf/doc/asymptote/examples/animations/inlinemovie.tex
index f3d9f5b0893..5f1eff9d4bb 100644
--- a/Master/texmf/doc/asymptote/examples/animations/inlinemovie.tex
+++ b/Master/texmf/doc/asymptote/examples/animations/inlinemovie.tex
@@ -7,9 +7,13 @@
 Here is an inline PDF movie, generated with the commands
 \begin{verbatim}
 pdflatex inlinemovie
-asy inlinemovie
+asy inlinemovie-*.asy
 pdflatex inlinemovie
 \end{verbatim}
+or equivalently,
+\begin{verbatim}
+latexmk -pdf inlinemovie
+\end{verbatim}
 
 \begin{center}
 \begin{asy}
diff --git a/Master/texmf/doc/asymptote/examples/animations/inlinemovie3.tex b/Master/texmf/doc/asymptote/examples/animations/inlinemovie3.tex
index 46779e85b28..5131c652a11 100644
--- a/Master/texmf/doc/asymptote/examples/animations/inlinemovie3.tex
+++ b/Master/texmf/doc/asymptote/examples/animations/inlinemovie3.tex
@@ -7,9 +7,13 @@
 Here is an inline 3D PDF movie, generated with the commands
 \begin{verbatim}
 pdflatex inlinemovie3
-asy inlinemovie3
+asy inlinemovie3-*.asy
 pdflatex inlinemovie3
 \end{verbatim}
+or equivalently,
+\begin{verbatim}
+latexmk -pdf inlinemovie3
+\end{verbatim}
 
 \begin{center} 
 \begin{asy}
diff --git a/Master/texmf/doc/asymptote/examples/cards.asy b/Master/texmf/doc/asymptote/examples/cards.asy
new file mode 100644
index 00000000000..337a886ec86
--- /dev/null
+++ b/Master/texmf/doc/asymptote/examples/cards.asy
@@ -0,0 +1,26 @@
+picture rect;
+
+size(rect,0,2.5cm);
+
+real x=1;
+real y=1.25;
+
+filldraw(rect,box((-x,-y)/2,(x,y)/2),lightolive);
+
+label(rect,"1",(-x,y)*0.45,SE);
+label(rect,"2",(x,y)*0.45,SW);
+label(rect,"3",(-x,-y)*0.45,NE);
+label(rect,"4",(x,-y)*0.45,NW);
+
+frame rectf=rect.fit();
+frame toplef=rectf;
+frame toprig=xscale(-1)*rectf;
+frame botlef=yscale(-1)*rectf;
+frame botrig=xscale(-1)*yscale(-1)*rectf;
+
+size(0,7.5cm);
+
+add(toplef,(-x,y));
+add(toprig,(x,y));
+add(botlef,(-x,-y));
+add(botrig,(x,-y));
diff --git a/Master/texmf/doc/asymptote/examples/externalprc.tex b/Master/texmf/doc/asymptote/examples/externalprc.tex
index 96643d7cebf..e6d4ade1dcf 100644
--- a/Master/texmf/doc/asymptote/examples/externalprc.tex
+++ b/Master/texmf/doc/asymptote/examples/externalprc.tex
@@ -5,8 +5,8 @@
 % asy -inlineimage teapot -render=4 -tex pdflatex
 %
 \documentclass[12pt]{article}
-\input teapot_.pre
+\input teapot.pre
 \RequirePackage{color,graphicx}
 \begin{document}
-\input teapot_.tex
+\input teapot.tex
 \end{document}
diff --git a/Master/texmf/doc/asymptote/examples/intro.asy b/Master/texmf/doc/asymptote/examples/intro.asy
index 20b03c578dc..5d7ce12b184 100644
--- a/Master/texmf/doc/asymptote/examples/intro.asy
+++ b/Master/texmf/doc/asymptote/examples/intro.asy
@@ -352,13 +352,9 @@ item("Having prescribed outgoing and incoming path directions $e^{i\theta}$
 at node~$z_0$ and $e^{i\phi}$ at node $z_1$ relative to the
 vector $z_1-z_0$, the control points are determined as:");  
 
-skip(-3);
-
 equations("u&=&z_0+e^{i\theta}(z_1-z_0)f(\theta,-\phi),\nonumber\\
 v&=&z_1-e^{i\phi}(z_1-z_0)f(-\phi,\theta),");
 
-skip(-3);
-
 remark("where the relative distance function $f(\theta,\phi)$ is given by Hobby [1986].");
 
 asyfigure("Hobbycontrol","height=9cm");
@@ -376,9 +372,13 @@ equation("\displaystyle x(t)=\sum_{k=0}^3 B_k(t) P_k, \qquad t\in [0,1].");
 
 item("The resulting curve is also a B\'ezier curve:");
 
+skip(-2);
+
 equations("x'_i(t)&=&\sum_{k=0}^3 B_k(t) A_{ij}(P_k)_j+C_i\nonumber\\
 &=&\sum_{k=0}^3 B_k(t) P'_k,");
 
+skip(-2);
+
 remark("where $P'_k$ is the transformed $k^{\rm th}$ control point, noting
 $\displaystyle\sum_{k=0}^3 B_k(t)=1.$");
 }
diff --git a/Master/texmf/doc/asymptote/examples/latexusage-1.asy b/Master/texmf/doc/asymptote/examples/latexusage-1.asy
deleted file mode 100644
index 7f0d6a2b3aa..00000000000
--- a/Master/texmf/doc/asymptote/examples/latexusage-1.asy
+++ /dev/null
@@ -1,55 +0,0 @@
-if(!settings.multipleView)
- settings.batchView=false;
-defaultfilename="latexusage-1";
-if(settings.render < 0) settings.render=4;
-settings.inlineimage=true;
-settings.embed=true;
-settings.outformat="";
-settings.toolbar=false;
-viewportmargin=(2,2);
-
-// Global Asymptote definitions can be put here.
-import three;
-usepackage("bm");
-texpreamble("\def\V#1{\bm{#1}}");
-// One can globally override the default toolbar settings here:
-// settings.toolbar=true;
-
-size(4cm,0);
-pen colour1=red;
-pen colour2=green;
-
-pair z0=(0,0);
-pair z1=(-1,0);
-pair z2=(1,0);
-real r=1.5;
-path c1=circle(z1,r);
-path c2=circle(z2,r);
-fill(c1,colour1);
-fill(c2,colour2);
-
-picture intersection=new picture;
-fill(intersection,c1,colour1+colour2);
-clip(intersection,c2);
-
-add(intersection);
-
-draw(c1);
-draw(c2);
-
-//draw("$\A$",box,z1);              // Requires [inline] package option.
-//draw(Label("$\B$","$B$"),box,z2); // Requires [inline] package option.
-draw("$A$",box,z1);
-draw("$\V{B}$",box,z2);
-
-pair z=(0,-2);
-real m=3;
-margin BigMargin=Margin(0,m*dot(unit(z1-z),unit(z0-z)));
-
-draw(Label("$A\cap B$",0),conj(z)--z0,Arrow,BigMargin);
-draw(Label("$A\cup B$",0),z--z0,Arrow,BigMargin);
-draw(z--z1,Arrow,Margin(0,m));
-draw(z--z2,Arrow,Margin(0,m));
-
-shipout(bbox(0.25cm));
-viewportsize=(390.0pt,0);
diff --git a/Master/texmf/doc/asymptote/examples/latexusage-2.asy b/Master/texmf/doc/asymptote/examples/latexusage-2.asy
deleted file mode 100644
index b91be72419f..00000000000
--- a/Master/texmf/doc/asymptote/examples/latexusage-2.asy
+++ /dev/null
@@ -1,23 +0,0 @@
-if(!settings.multipleView)
- settings.batchView=false;
-defaultfilename="latexusage-2";
-if(settings.render < 0) settings.render=4;
-settings.inlineimage=true;
-settings.embed=true;
-settings.outformat="";
-settings.toolbar=false;
-viewportmargin=(2,2);
-
-// Global Asymptote definitions can be put here.
-import three;
-usepackage("bm");
-texpreamble("\def\V#1{\bm{#1}}");
-// One can globally override the default toolbar settings here:
-// settings.toolbar=true;
-
-
-currentprojection=orthographic(5,4,2);
-draw(unitcube,blue);
-label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
-size(0,4cm);
-viewportsize=(390.0pt,0);
diff --git a/Master/texmf/doc/asymptote/examples/latexusage-3.asy b/Master/texmf/doc/asymptote/examples/latexusage-3.asy
deleted file mode 100644
index d3990c9cbfb..00000000000
--- a/Master/texmf/doc/asymptote/examples/latexusage-3.asy
+++ /dev/null
@@ -1,38 +0,0 @@
-if(!settings.multipleView)
- settings.batchView=false;
-defaultfilename="latexusage-3";
-if(settings.render < 0) settings.render=4;
-settings.inlineimage=true;
-settings.embed=true;
-settings.outformat="";
-settings.toolbar=false;
-viewportmargin=(2,2);
-
-// Global Asymptote definitions can be put here.
-import three;
-usepackage("bm");
-texpreamble("\def\V#1{\bm{#1}}");
-// One can globally override the default toolbar settings here:
-// settings.toolbar=true;
-
-
-pair z0=(0,0);
-pair z1=(2,0);
-pair z2=(5,0);
-pair zf=z1+0.75*(z2-z1);
-
-draw(z1--z2);
-dot(z1,red+0.15cm);
-dot(z2,darkgreen+0.3cm);
-label("$m$",z1,1.2N,red);
-label("$M$",z2,1.5N,darkgreen);
-label("$\hat{\ }$",zf,0.2*S,fontsize(24pt)+blue);
-
-pair s=-0.2*I;
-draw("$x$",z0+s--z1+s,N,red,Arrows,Bars,PenMargins);
-s=-0.5*I;
-draw("$\bar{x}$",z0+s--zf+s,blue,Arrows,Bars,PenMargins);
-s=-0.95*I;
-draw("$X$",z0+s--z2+s,darkgreen,Arrows,Bars,PenMargins);
-size(390.0pt,0);
-viewportsize=(390.0pt,0);
diff --git a/Master/texmf/doc/asymptote/examples/latexusage.tex b/Master/texmf/doc/asymptote/examples/latexusage.tex
index 6324238f1a2..ae555a476bd 100644
--- a/Master/texmf/doc/asymptote/examples/latexusage.tex
+++ b/Master/texmf/doc/asymptote/examples/latexusage.tex
@@ -3,13 +3,16 @@
 % Use this form to include EPS (latex) or PDF (pdflatex) files:
 \usepackage{asymptote}
 
-% Use this form with latex or pdflatex to include inline LaTeX code:
+% Use this form with latex or pdflatex to include inline LaTeX code by default:
 %\usepackage[inline]{asymptote}
 
+% Use this form with latex or pdflatex to create PDF attachments by default:
+%\usepackage[attach]{asymptote}
+
 % Enable this line to support PDF hyperlinks:
-%\usepackage{hyperref}\hypersetup{setpagesize=false}
+%\usepackage{hyperref}\hypersetup{setpagesize=false,unicode}
 
-% Enable this line for PDF attachments with asy environment option attach=true:
+% Enable this line to support the attach option:
 %\usepackage[dvips]{attachfile2}
 
 \begin{document}
@@ -76,11 +79,12 @@ shipout(bbox(0.25cm));
 Each graph is drawn in its own environment. One can specify the width
 and height to \LaTeX\ explicitly. This 3D example can be viewed
 interactively either with Adobe Reader or Asymptote's fast OpenGL-based
-renderer. It is often desirable to embed such files as annotated attachments;
-this requires the optional \verb+\usepackage{attachfile2}+ package and
-the \verb+{attach=true}+ option:
+renderer. To support {\tt latexmk}, 3D figures should specify
+\verb+inline=true+. It is sometimes desirable to embed 3D files as annotated
+attachments; this requires the optional \verb+\usepackage{attachfile2}+
+package and the \verb+attach=true+ option:
 \begin{center}
-\begin{asy}[height=4cm,attach=false]
+\begin{asy}[height=4cm,inline=true,attach=false]
 currentprojection=orthographic(5,4,2);
 draw(unitcube,blue);
 label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
@@ -89,7 +93,7 @@ label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
 
 One can also scale the figure to the full line width:
 \begin{center}
-\begin{asy}[width=\the\linewidth]
+\begin{asy}[width=\the\linewidth,inline=true]
 pair z0=(0,0);
 pair z1=(2,0);
 pair z2=(5,0);
diff --git a/Master/texmf/doc/asymptote/examples/slidemovies.asy b/Master/texmf/doc/asymptote/examples/slidemovies.asy
deleted file mode 100644
index ec724cf3326..00000000000
--- a/Master/texmf/doc/asymptote/examples/slidemovies.asy
+++ /dev/null
@@ -1,46 +0,0 @@
-// Slide demo.
-// Command-line options to enable stepping and/or reverse video:
-// asy [-u stepping=true] [-u reverse=true] slidedemo
-
-orientation=Landscape;
-
-settings.tex="pdflatex";
-
-import slide;
-
-// Optional movie modules:
-import animate;     // For portable embedded PDF movies
-import external;    // For portable external movies
-import embed;       // For non-portable embedded movies
-
-usersetting();
-
-titlepage("Slides with {\tt Asymptote}: Animations","John C. Bowman",
-          "University of Alberta","\today","http://asymptote.sf.net");
-
-title("Embedded PDF movies (portable)");
-animation a=animation("A");
-animation b=animation("B");
-int n=20;
-for(int i=0; i < 2n; ++i) {
-  picture pic;
-  size(pic,100);
-  draw(pic,shift(0,sin(pi/n*i))*unitsquare);
-  a.add(pic);
-  if(i < 1.5n) b.add(rotate(45)*pic);
-}
-display(a.pdf("autoplay,loop,controls"));
-display(b.pdf("controls"));
-
-title("External Movie (portable)");
-display(external.embed("animations/wheel.mpg",
-                       "poster,text=wheel.mpg,label=wheel.mpg",20cm,5.6cm));
-display(external.link("animations/wheel.mpg","Play","play"));
-
-title("Embedded Movie (not portable)");
-// Generated needed files if they don't already exist.
-asy("mpg","animations/wheel");
-display(embed.embed("animations/wheel.mpg",
-                    "poster,text=wheel.mpg,label=wheel.mpg",
-                    20cm,5.6cm));
-display(embed.link("animations/wheel.mpg","Play","play"));
diff --git a/Master/texmf/doc/asymptote/examples/washermethod.asy b/Master/texmf/doc/asymptote/examples/washermethod.asy
index 9a18b871414..d86bf8cd4df 100644
--- a/Master/texmf/doc/asymptote/examples/washermethod.asy
+++ b/Master/texmf/doc/asymptote/examples/washermethod.asy
@@ -12,9 +12,14 @@ pair F(real x) {return (x,f(x));}
 triple F3(real x) {return (x,f(x),0);}
 
 ngraph=12;
-path[] p={graph(F,0.7476,1.8043,Spline)--cycle,
-	  graph(F,0.7,0.7476,Spline)--graph(F,1.7787,1.8043,Spline)--cycle,
-	  graph(F,0,0.7,Spline)--graph(F,1.8043,2,Spline)--cycle};
+
+real x1=0.7476;
+real x2=1.7787;
+real x3=1.8043;
+
+path[] p={graph(F,x1,x2,Spline),
+          graph(F,0.7,x1,Spline)--graph(F,x2,x3,Spline),
+          graph(F,0,0.7,Spline)--graph(F,x3,2,Spline)};
 
 pen[] pn=new pen[] {color1,color2,color1};
 
@@ -24,7 +29,7 @@ for(int i=0; i < p.length; ++i) {
   revolution a=revolution(path3(p[i]),Y,0,alpha);
   draw(surface(a),pn[i],render);
 
-  surface s=surface(p[i]);
+  surface s=surface(p[i]--cycle);
   draw(s,pn[i],render);
   draw(rotate(alpha,Y)*s,pn[i],render);
 }
diff --git a/Master/texmf/doc/info/asy-faq.info b/Master/texmf/doc/info/asy-faq.info
index 64d6def87ce..059fa578d1a 100644
--- a/Master/texmf/doc/info/asy-faq.info
+++ b/Master/texmf/doc/info/asy-faq.info
@@ -9,7 +9,7 @@ END-INFO-DIR-ENTRY
 File: $prefix.info, Node: Top, Next: Question 1.1, Up: (dir)
 
             ASYMPTOTE FREQUENTLY ASKED QUESTIONS
-                            05 Jul 2010
+                            11 Jul 2010
                           
 This is the list of Frequently Asked Questions about Asymptote (asy).
 
diff --git a/Master/texmf/doc/info/asymptote.info b/Master/texmf/doc/info/asymptote.info
index af0f271a9d2..e72ff70242c 100644
--- a/Master/texmf/doc/info/asymptote.info
+++ b/Master/texmf/doc/info/asymptote.info
@@ -1,11 +1,11 @@
 This is asymptote.info, produced by makeinfo version 4.13 from
 ../asymptote.texi.
 
-This file documents `Asymptote', version 2.01.
+This file documents `Asymptote', version 2.02.
 
    `http://asymptote.sourceforge.net'
 
-   Copyright (C) 2004-9 Andy Hammerlindl, John Bowman, and Tom Prince.
+   Copyright (C) 2004-10 Andy Hammerlindl, John Bowman, and Tom Prince.
 
      Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Lesser General Public License
@@ -23,11 +23,11 @@ File: asymptote.info,  Node: Top,  Next: Description,  Up: (dir)
 Asymptote
 *********
 
-This file documents `Asymptote', version 2.01.
+This file documents `Asymptote', version 2.02.
 
    `http://asymptote.sourceforge.net'
 
-   Copyright (C) 2004-9 Andy Hammerlindl, John Bowman, and Tom Prince.
+   Copyright (C) 2004-10 Andy Hammerlindl, John Bowman, and Tom Prince.
 
      Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Lesser General Public License
@@ -499,7 +499,7 @@ used; if it is old we recommend first putting
 in the `Asymptote' source directory.
 
 If your graphics card supports multisampling, we recommend using version
-`2.6.0-rc1' (or later) of `freeglut' to support antialiasing in
+`2.6.0' (or later) of `freeglut' to support antialiasing in
 `Asymptote''s adaptive `OpenGL' 3D renderer (`MacOS X' users can skip
 this step since `Asymptote' is configured to use the native glut
 library on that platform). Download
@@ -2325,7 +2325,7 @@ number, until it saturates with one or more color components equal to 1.
       at the beginning of the file (this requires the `type1cm' package
      available from
 
-          `http://www.ctan.org/tex-archive/help/Catalogue/entries/type1cm'
+          `http://www.ctan.org/tex-archive/macros/latex/contrib/type1cm/'
      and included in recent `LaTeX' distributions). The font size and
      line skip of a pen can be examined with the routines `real
      fontsize(pen p=currentpen)' and `real lineskip(pen p=currentpen)',
@@ -4642,60 +4642,66 @@ File: asymptote.info,  Node: LaTeX usage,  Next: Base modules,  Prev: Programmin
 ***************
 
 `Asymptote' comes with a convenient `LaTeX' style file `asymptote.sty'
-that makes `LaTeX' `Asymptote'-aware. Entering `Asymptote' code
-directly into the `LaTeX' source file, at the point where it is needed,
-keeps figures organized and avoids the need to invent new file names
-for each figure. Simply add the line `\usepackage{asymptote}' at the
-beginning of your file and enclose your `Asymptote' code within a
-`\begin{asy}...\end{asy}' environment. As with the `LaTeX' `comment'
-environment, the `\end{asy}' command must appear on a line by itself,
-with no leading spaces or trailing commands/comments.
+(version 1.15 or later) that makes `LaTeX' `Asymptote'-aware. Entering
+`Asymptote' code directly into the `LaTeX' source file, at the point
+where it is needed, keeps figures organized and avoids the need to
+invent new file names for each figure. Simply add the line
+`\usepackage{asymptote}' at the beginning of your file and enclose your
+`Asymptote' code within a `\begin{asy}...\end{asy}' environment. As
+with the `LaTeX' `comment' environment, the `\end{asy}' command must
+appear on a line by itself, with no leading spaces or trailing
+commands/comments.
 
    The sample `LaTeX' file below, named `latexusage.tex', can be run as
 follows:
 latex latexusage
-asy latexusage
+asy latexusage-*.asy
 latex latexusage
 
 or
 pdflatex latexusage
-asy latexusage
+asy latexusage-*.asy
 pdflatex latexusage
+ To switch between using `latex' and `pdflatex' you may first need to
+remove the files `latexusage-*', `latexusage.pre', and `latexusage.aux'.
 
-   To switch between using `latex' and `pdflatex' you may first need to
-remove the files `latexusage-*', `latexusage_.pre', and
-`latexusage.aux'. Version 1.13 of `Asymptote.sty' supports processing
-each figure separately: `asy latexusage' is equivalent to `asy
-latexusage-*.asy'. For example, one may wish to reduce memory usage by
-generating each figure in a separate `UNIX' process:
-/bin/ls latexusage-*.asy | xargs --replace=% asy %
+   An even better method for processing a `LaTeX' file with embedded
+`Asymptote' code is to use the `latexmk' utility from
+
+     `http://www.ctan.org/tex-archive/support/latexmk/'
+   after putting the rules
+
+sub asy {return system("asy '$_[0]'");}
+add_cus_dep("asy","eps",0,"asy");
+add_cus_dep("asy","pdf",0,"asy");
+add_cus_dep("asy","tex",0,"asy");
+in a file `latexmkrc' in the same directory. The command
+latexmk -pdf latexusage
+ will then call `Asymptote' automatically, recompiling only the figures
+that have changed. Since each figure is compiled in a separate system
+process, this method also tends to use less memory.
 
    One can specify `width', `height', `viewportwidth',
-`viewportheight', and `attach' `keyval'-style options to the `asy'
-environment.  The current version of `asymptote.sty' supports the
-embedding of 3D PRC files, either inline or, using the `attach' option
-with the `attachfile2' (or older `attachfile') `LaTeX' package, as
-annotated (but printable) attachments. For many applications, the
-annotated attachment method tends to be more convenient.  The default
-value of `viewportwidth' is `\the\linewidth' for inline 3D figures and
-`0' for attachments.
-
-   If the `inline' option is given to the `asymptote.sty' package,
-inline `LaTeX' code is generated instead of EPS or PDF files. This
-makes 2D LaTeX symbols visible to the `\begin{asy}...\end{asy}'
-environment.  In this mode, Asymptote correctly aligns 2D LaTeX symbols
-defined outside of `\begin{asy}...\end{asy}', but treats their size as
-zero; an optional second string can be given to `Label' to provide an
-estimate of the unknown label size.
-
-   Note that if `latex' is used with the `inline' option, the labels
-might not show up in DVI viewers that cannot handle raw `PostScript'
-code. One can use `dvips'/`dvipdf' to produce `PostScript'/PDF output
-(we recommend using the modified version of `dvipdf' in the `Asymptote'
-patches directory, which accepts the `dvips -z' hyperdvi option).
-
-   An excellent tutorial by Dario Teixeira on integrating `Asymptote'
-and `LaTeX' is available at `http://dario.dse.nl/projects/asylatex/'.
+`viewportheight', `attach', and `inline'.  `keyval'-style options to
+the `asy' environment.  Three-dimensional PRC files may either be
+embedded within the page (the default) or attached as annotated (but
+printable) attachments, using the `attach' option and the `attachfile2'
+(or older `attachfile') `LaTeX' package. The default value of
+`viewportwidth' is `\the\linewidth' for inline 3D figures and `0' for
+attachments. The `inline' option generates inline `LaTeX' code instead
+of EPS or PDF files. This makes 2D LaTeX symbols visible to the
+`\begin{asy}...\end{asy}' environment.  In this mode, Asymptote
+correctly aligns 2D LaTeX symbols defined outside of
+`\begin{asy}...\end{asy}', but treats their size as zero; an optional
+second string can be given to `Label' to provide an estimate of the
+unknown label size.
+
+   Note that if the `latex' TeX engine is used with the `inline'
+option, labels might not show up in DVI viewers that cannot handle raw
+`PostScript' code. One can use `dvips'/`dvipdf' to produce
+`PostScript'/PDF output (we recommend using the modified version of
+`dvipdf' in the `Asymptote' patches directory, which accepts the `dvips
+-z' hyperdvi option).
 
    Here now is `latexusage.tex':
 
@@ -4704,13 +4710,16 @@ and `LaTeX' is available at `http://dario.dse.nl/projects/asylatex/'.
 % Use this form to include EPS (latex) or PDF (pdflatex) files:
 \usepackage{asymptote}
 
-% Use this form with latex or pdflatex to include inline LaTeX code:
+% Use this form with latex or pdflatex to include inline LaTeX code by default:
 %\usepackage[inline]{asymptote}
 
+% Use this form with latex or pdflatex to create PDF attachments by default:
+%\usepackage[attach]{asymptote}
+
 % Enable this line to support PDF hyperlinks:
-%\usepackage{hyperref}\hypersetup{setpagesize=false}
+%\usepackage{hyperref}\hypersetup{setpagesize=false,unicode}
 
-% Enable this line for PDF attachments with asy environment option attach=true:
+% Enable this line to support the attach option:
 %\usepackage[dvips]{attachfile2}
 
 \begin{document}
@@ -4777,11 +4786,12 @@ shipout(bbox(0.25cm));
 Each graph is drawn in its own environment. One can specify the width
 and height to \LaTeX\ explicitly. This 3D example can be viewed
 interactively either with Adobe Reader or Asymptote's fast OpenGL-based
-renderer. It is often desirable to embed such files as annotated attachments;
-this requires the optional \verb+\usepackage{attachfile2}+ package and
-the \verb+{attach=true}+ option:
+renderer. To support {\tt latexmk}, 3D figures should specify
+\verb+inline=true+. It is sometimes desirable to embed 3D files as annotated
+attachments; this requires the optional \verb+\usepackage{attachfile2}+
+package and the \verb+attach=true+ option:
 \begin{center}
-\begin{asy}[height=4cm,attach=false]
+\begin{asy}[height=4cm,inline=true,attach=false]
 currentprojection=orthographic(5,4,2);
 draw(unitcube,blue);
 label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
@@ -4790,7 +4800,7 @@ label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
 
 One can also scale the figure to the full line width:
 \begin{center}
-\begin{asy}[width=\the\linewidth]
+\begin{asy}[width=\the\linewidth,inline=true]
 pair z0=(0,0);
 pair z1=(2,0);
 pair z2=(5,0);
@@ -5201,20 +5211,18 @@ directory the commands:
 tex ifdraft.dtx
 texhash
 
+   A more portable method for embedding movie files, which should work
+on any platform and does not require the `movie15' or `ifdraft'
+packages, is provided by using the `external' module instead of
+`embed'. An example of these interfaces is provided in the file
+`embeddedmovie.asy' and `externalmovie.asy' in the `animations'
+subdirectory of the examples directory. For a higher quality movie
+generated directly by `Asymptote', use the `animate' module along with
+the `animate.sty' package to embed a portable PDF animation (*note
+animate::).
+
    An example of embedding `U3D' code is provided in the file
-`embeddedu3d.asy'.  As of version 7.0.8, `Adobe Reader' supports the
-`U3D' format under Linux.
-
-   Unfortunately, Adobe has not yet made available an embedded movie
-plugin for the Linux version of `Adobe Reader'.  A portable method for
-embedding movie files, which should work on any platform and does not
-require the `movie15' or `ifdraft' packages, is provided by using the
-`external' module instead of `embed'. An example of these interfaces is
-provided in the file `embeddedmovie.asy' and `externalmovie.asy' in the
-`animations' subdirectory of the examples directory. For a higher
-quality movie generated directly by `Asymptote', use the `animate'
-module along with the `animate.sty' package to embed a portable PDF
-animation (*note animate::).
+`embeddedu3d.asy'.
 
 
 File: asymptote.info,  Node: slide,  Next: MetaPost,  Prev: embed,  Up: Base modules
@@ -8528,7 +8536,7 @@ Index
                                                               (line   6)
 * atleast:                               Bezier curves.       (line  56)
 * attach <1>:                            graph.               (line 415)
-* attach:                                LaTeX usage.         (line  35)
+* attach:                                LaTeX usage.         (line  46)
 * autoadjust:                            three.               (line 354)
 * autoimport:                            Options.             (line 110)
 * automatic scaling:                     graph.               (line 682)
@@ -8942,7 +8950,7 @@ Index
 * guide:                                 Paths and guides.    (line 300)
 * guide3:                                three.               (line   6)
 * hatch:                                 Pens.                (line 267)
-* height:                                LaTeX usage.         (line  35)
+* height:                                LaTeX usage.         (line  46)
 * help <1>:                              Debugger.            (line  30)
 * help <2>:                              Help.                (line   6)
 * help:                                  Interactive mode.    (line  44)
@@ -8992,6 +9000,7 @@ Index
 * initialized:                           Arrays.              (line  39)
 * initializers:                          Variable initializers.
                                                               (line   6)
+* inline:                                LaTeX usage.         (line  46)
 * InOutTicks:                            graph3.              (line  34)
 * input <1>:                             Interactive mode.    (line  48)
 * input:                                 Files.               (line  11)
@@ -9054,6 +9063,7 @@ Index
 * latex:                                 Options.             (line 142)
 * LaTeX fonts:                           Pens.                (line 192)
 * LaTeX usage:                           LaTeX usage.         (line   6)
+* latexmk:                               LaTeX usage.         (line  30)
 * latin1:                                latin1.              (line   6)
 * latitude:                              Data types.          (line 134)
 * latticeshade:                          fill.                (line  32)
@@ -9572,6 +9582,7 @@ Index
 * type1cm:                               Pens.                (line 178)
 * typedef <1>:                           Functions.           (line  36)
 * typedef:                               Data types.          (line 344)
+* U3D:                                   embed.               (line  38)
 * undefined:                             Paths and guides.    (line 268)
 * UnFill:                                Frames and pictures. (line 152)
 * unfill:                                fill.                (line 106)
@@ -9612,10 +9623,10 @@ Index
 * verbatim:                              Frames and pictures. (line 271)
 * vertex-dependent colors:               three.               (line  81)
 * Vertical:                              flowchart.           (line  81)
-* viewportheight:                        LaTeX usage.         (line  35)
+* viewportheight:                        LaTeX usage.         (line  46)
 * viewportmargin:                        three.               (line 262)
 * viewportsize:                          three.               (line 262)
-* viewportwidth:                         LaTeX usage.         (line  35)
+* viewportwidth:                         LaTeX usage.         (line  46)
 * views:                                 three.               (line 231)
 * vim:                                   Editing modes.       (line  33)
 * virtual functions:                     Structures.          (line 181)
@@ -9626,7 +9637,7 @@ Index
 * wheel mouse:                           GUI.                 (line   6)
 * while:                                 Programming.         (line  29)
 * white-space string delimiter mode:     Arrays.              (line 359)
-* width:                                 LaTeX usage.         (line  35)
+* width:                                 LaTeX usage.         (line  46)
 * windingnumber:                         Paths and guides.    (line 268)
 * word:                                  Arrays.              (line 359)
 * write <1>:                             Arrays.              (line 399)
@@ -9696,146 +9707,146 @@ Index
 
 
 Tag Table:
-Node: Top574
-Node: Description6832
-Node: Installation10333
-Node: UNIX binary distributions11386
-Node: MacOS X binary distributions12492
-Node: Microsoft Windows13376
-Ref: psview14086
-Node: Configuring15007
-Node: Search paths19228
-Node: Compiling from UNIX source20025
-Ref: multisampling20614
-Node: Editing modes23024
-Node: Subversion25456
-Node: Uninstall25919
-Node: Tutorial26269
-Ref: unitcircle30495
-Node: Drawing commands32431
-Node: draw34142
-Ref: arrows35290
-Node: fill40533
-Ref: gradient shading41577
-Node: clip45805
-Node: label46397
-Ref: Label47096
-Node: Bezier curves52821
-Node: Programming56398
-Ref: array iteration57212
-Node: Data types58293
-Ref: format67301
-Node: Paths and guides70904
-Ref: circle71158
-Ref: arctime76646
-Ref: extension80501
-Node: Pens87184
-Ref: fillrule94550
-Ref: basealign95447
-Ref: transparency98274
-Ref: makepen101717
-Ref: overwrite102555
-Node: Transforms103765
-Node: Frames and pictures105556
-Ref: envelope106697
-Ref: size107780
-Ref: unitsize108767
-Ref: shipout109827
-Ref: filltype112160
-Ref: add115297
-Ref: add about116243
-Ref: tex119181
-Node: Files120055
-Ref: cd121020
-Ref: scroll125452
-Node: Variable initializers128525
-Node: Structures131250
-Node: Operators138694
-Node: Arithmetic & logical139008
-Node: Self & prefix operators140982
-Node: User-defined operators141770
-Node: Implicit scaling142681
-Node: Functions143244
-Ref: stack overflow145997
-Node: Default arguments146561
-Node: Named arguments147300
-Node: Rest arguments149462
-Node: Mathematical functions152272
-Node: Arrays156879
-Ref: sort163929
-Ref: tridiagonal166333
-Ref: solve167561
-Node: Slices171754
-Node: Casts175644
-Node: Import177609
-Node: Static182836
-Node: LaTeX usage185730
-Node: Base modules191468
-Node: plain193968
-Node: simplex194620
-Node: math194893
-Node: interpolate197598
-Node: geometry197877
-Node: trembling198471
-Node: stats198822
-Node: patterns199082
-Node: markers199318
-Node: tree201101
-Node: binarytree201289
-Node: drawtree201878
-Node: syzygy202082
-Node: feynman202356
-Node: roundedpath202631
-Node: animation202914
-Ref: animate203331
-Node: embed204470
-Node: slide206259
-Node: MetaPost206599
-Node: unicode207315
-Node: latin1208203
-Node: babel208571
-Node: labelpath208800
-Node: labelpath3209620
-Node: annotate209931
-Node: CAD210402
-Node: graph210712
-Ref: ticks217841
-Ref: pathmarkers231120
-Ref: marker231585
-Ref: markuniform231936
-Ref: errorbars233727
-Ref: automatic scaling237783
-Node: palette248429
-Ref: images248547
-Ref: image252718
-Ref: logimage253196
-Ref: penimage254002
-Node: three254446
-Ref: PostScript3D278988
-Node: obj280680
-Node: graph3280932
-Ref: GaussianSurface286057
-Node: grid3287161
-Node: solids287901
-Node: tube288849
-Node: flowchart291084
-Node: contour295653
-Node: contour3300778
-Node: slopefield301085
-Node: ode302522
-Node: Options302782
-Ref: configuration file308627
-Ref: settings308627
-Ref: convert309828
-Node: Interactive mode312795
-Ref: history314948
-Node: GUI316253
-Node: GUI installation316756
-Node: GUI usage317886
-Node: PostScript to Asymptote318789
-Node: Help319545
-Node: Debugger321281
-Node: Credits323066
-Node: Index323998
+Node: Top575
+Node: Description6834
+Node: Installation10335
+Node: UNIX binary distributions11388
+Node: MacOS X binary distributions12494
+Node: Microsoft Windows13378
+Ref: psview14088
+Node: Configuring15009
+Node: Search paths19230
+Node: Compiling from UNIX source20027
+Ref: multisampling20616
+Node: Editing modes23022
+Node: Subversion25454
+Node: Uninstall25917
+Node: Tutorial26267
+Ref: unitcircle30493
+Node: Drawing commands32429
+Node: draw34140
+Ref: arrows35288
+Node: fill40531
+Ref: gradient shading41575
+Node: clip45803
+Node: label46395
+Ref: Label47094
+Node: Bezier curves52819
+Node: Programming56396
+Ref: array iteration57210
+Node: Data types58291
+Ref: format67299
+Node: Paths and guides70902
+Ref: circle71156
+Ref: arctime76644
+Ref: extension80499
+Node: Pens87182
+Ref: fillrule94548
+Ref: basealign95445
+Ref: transparency98271
+Ref: makepen101714
+Ref: overwrite102552
+Node: Transforms103762
+Node: Frames and pictures105553
+Ref: envelope106694
+Ref: size107777
+Ref: unitsize108764
+Ref: shipout109824
+Ref: filltype112157
+Ref: add115294
+Ref: add about116240
+Ref: tex119178
+Node: Files120052
+Ref: cd121017
+Ref: scroll125449
+Node: Variable initializers128522
+Node: Structures131247
+Node: Operators138691
+Node: Arithmetic & logical139005
+Node: Self & prefix operators140979
+Node: User-defined operators141767
+Node: Implicit scaling142678
+Node: Functions143241
+Ref: stack overflow145994
+Node: Default arguments146558
+Node: Named arguments147297
+Node: Rest arguments149459
+Node: Mathematical functions152269
+Node: Arrays156876
+Ref: sort163926
+Ref: tridiagonal166330
+Ref: solve167558
+Node: Slices171751
+Node: Casts175641
+Node: Import177606
+Node: Static182833
+Node: LaTeX usage185727
+Node: Base modules191768
+Node: plain194268
+Node: simplex194920
+Node: math195193
+Node: interpolate197898
+Node: geometry198177
+Node: trembling198771
+Node: stats199122
+Node: patterns199382
+Node: markers199618
+Node: tree201401
+Node: binarytree201589
+Node: drawtree202178
+Node: syzygy202382
+Node: feynman202656
+Node: roundedpath202931
+Node: animation203214
+Ref: animate203631
+Node: embed204770
+Node: slide206373
+Node: MetaPost206713
+Node: unicode207429
+Node: latin1208317
+Node: babel208685
+Node: labelpath208914
+Node: labelpath3209734
+Node: annotate210045
+Node: CAD210516
+Node: graph210826
+Ref: ticks217955
+Ref: pathmarkers231234
+Ref: marker231699
+Ref: markuniform232050
+Ref: errorbars233841
+Ref: automatic scaling237897
+Node: palette248543
+Ref: images248661
+Ref: image252832
+Ref: logimage253310
+Ref: penimage254116
+Node: three254560
+Ref: PostScript3D279102
+Node: obj280794
+Node: graph3281046
+Ref: GaussianSurface286171
+Node: grid3287275
+Node: solids288015
+Node: tube288963
+Node: flowchart291198
+Node: contour295767
+Node: contour3300892
+Node: slopefield301199
+Node: ode302636
+Node: Options302896
+Ref: configuration file308741
+Ref: settings308741
+Ref: convert309942
+Node: Interactive mode312909
+Ref: history315062
+Node: GUI316367
+Node: GUI installation316870
+Node: GUI usage318000
+Node: PostScript to Asymptote318903
+Node: Help319659
+Node: Debugger321395
+Node: Credits323180
+Node: Index324112
 
 End Tag Table
diff --git a/Master/texmf/doc/man/man1/asy.man1.pdf b/Master/texmf/doc/man/man1/asy.man1.pdf
index 964a9724a2a..b15add600aa 100644
--- a/Master/texmf/doc/man/man1/asy.man1.pdf
+++ b/Master/texmf/doc/man/man1/asy.man1.pdf