MetaPost 2.0 rc2: updated doc

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

8 files changed, 70 insertions, 9 deletions

diff --git a/Master/texmf-dist/doc/metapost/base/mpboxes.pdf b/Master/texmf-dist/doc/metapost/base/mpboxes.pdf
index e09572764cc..dba64f0c391 100644
--- a/Master/texmf-dist/doc/metapost/base/mpboxes.pdf
+++ b/Master/texmf-dist/doc/metapost/base/mpboxes.pdf
diff --git a/Master/texmf-dist/doc/metapost/base/mpgraph.pdf b/Master/texmf-dist/doc/metapost/base/mpgraph.pdf
index a8595c392bf..2ec2ac7801c 100644
--- a/Master/texmf-dist/doc/metapost/base/mpgraph.pdf
+++ b/Master/texmf-dist/doc/metapost/base/mpgraph.pdf
diff --git a/Master/texmf-dist/doc/metapost/base/mplibapi.pdf b/Master/texmf-dist/doc/metapost/base/mplibapi.pdf
index b76a1b4ca7c..de3847e0e5d 100644
--- a/Master/texmf-dist/doc/metapost/base/mplibapi.pdf
+++ b/Master/texmf-dist/doc/metapost/base/mplibapi.pdf
diff --git a/Master/texmf-dist/doc/metapost/base/mpman.pdf b/Master/texmf-dist/doc/metapost/base/mpman.pdf
index ac27aaea423..7ed5dd93479 100644
--- a/Master/texmf-dist/doc/metapost/base/mpman.pdf
+++ b/Master/texmf-dist/doc/metapost/base/mpman.pdf
diff --git a/Master/texmf-dist/doc/metapost/base/source-manual/TODO b/Master/texmf-dist/doc/metapost/base/source-manual/TODO
index 720d9661c15..db21b676abf 100644
--- a/Master/texmf-dist/doc/metapost/base/source-manual/TODO
+++ b/Master/texmf-dist/doc/metapost/base/source-manual/TODO
@@ -34,8 +34,6 @@ mp-implementors list or alternatively the metapost list.
 
 * Describe prescriptpart/postscriptpart.
 
-* Describe envelope primitive/macro.
-
 * Describe penrazor, penspeck.
 
 * Describe drawdot withpen counter-intuitivity.  Describe recent change
diff --git a/Master/texmf-dist/doc/metapost/base/source-manual/mplibapi.tex b/Master/texmf-dist/doc/metapost/base/source-manual/mplibapi.tex
index c4bbfc2b519..b4638fcda08 100644
--- a/Master/texmf-dist/doc/metapost/base/source-manual/mplibapi.tex
+++ b/Master/texmf-dist/doc/metapost/base/source-manual/mplibapi.tex
@@ -46,9 +46,9 @@
 \StartTitlePage
 \centerline{\definedfont[TitleFont at 50pt]{\MPLIB}}
 \blank[3*line]
-\centerline{\definedfont[SubTitleFont at 24pt]{API documentation, version 2.000}}
+\centerline{\definedfont[SubTitleFont at 24pt]{API documentation, version 2.00}}
 \blank[3*line]
-\centerline{Taco Hoekwater, September 2012 -- Luigi Scarso, April 2017}
+\centerline{Taco Hoekwater, September 2012 -- Luigi Scarso, February 2018}
 \StopTitlePage
 
 \section{Table of contents}
diff --git a/Master/texmf-dist/doc/metapost/base/source-manual/mpman.mp b/Master/texmf-dist/doc/metapost/base/source-manual/mpman.mp
index e458d2fa252..342389e6aa9 100644
--- a/Master/texmf-dist/doc/metapost/base/source-manual/mpman.mp
+++ b/Master/texmf-dist/doc/metapost/base/source-manual/mpman.mp
@@ -417,6 +417,30 @@ pickup pencircle scaled 1pt;
 draw fun;
 endfig;
 
+beginfig(261);
+path p[] ;
+pen mypen ;
+pen mypenC;
+numeric L ;
+numeric S ;
+L:=10;
+Sa:=1;
+Sb:=2;
+Rot=32;
+p[-1] := ( (Sa*cosd(0),Sb*sind(0)) for i=1 upto L-1: -- (Sa*cosd(i/L*360), Sb*sind(i/L*360)) endfor -- cycle )  rotated Rot;
+mypen := makepen(p[-1]) ;
+mypenC:= (pencircle xscaled 2Sa yscaled 2Sb) rotated Rot;
+p0 := (0,0){down} .. {up} (100,0)  ;
+p1 := envelope  mypen  of p0 ;
+draw  p1 withcolor black   withpen pencircle scaled 0.2pt ;
+draw p0 withcolor 0.8white withpen mypenC;
+for t=1 upto length(p1): 
+ draw (point t of p1) withpen pencircle scaled 0.8pt; 
+endfor;
+%currentpicture := currentpicture scaled  30 ;
+endfig;
+
+
 
 beginfig(28);
 path p[];
diff --git a/Master/texmf-dist/doc/metapost/base/source-manual/mpman.tex b/Master/texmf-dist/doc/metapost/base/source-manual/mpman.tex
index 006d4700af9..adea728a7c6 100644
--- a/Master/texmf-dist/doc/metapost/base/source-manual/mpman.tex
+++ b/Master/texmf-dist/doc/metapost/base/source-manual/mpman.tex
@@ -1,4 +1,4 @@
-% $Id: mpman.tex 2133 2017-04-03 09:00:28 lscarso $
+% $Id: mpman.tex 2139 2018-02-19 14:38:47Z luigi.scarso@gmail.com $
 % MetaPost manual, by John Hobby.  License at end.
 \listfiles
 \RequirePackage{ifpdf}
@@ -12,9 +12,9 @@
 \fi
 \documentclass{article} % article is NOT the original style
 \usepackage[nofancy]{svninfo}% Access VCS information.
-\svnInfo $Id: mpman.tex 2133 2017-04-03 09:00:28 lscarso $
-%\svnInfo $Id: mpman.tex 2059 2017-04-30 21:56:18Z karl $
-\newcommand*{\mpversion}{2.000}
+\svnInfo $Id: mpman.tex 2139 2018-02-19 14:38:47Z luigi.scarso@gmail.com $
+%\svnInfo $Id: mpman.tex 2139 2018-02-19 14:38:47Z luigi.scarso@gmail.com $
+\newcommand*{\mpversion}{2.00}
 
 \usepackage[T1]{fontenc}
 \usepackage{lmodern}
@@ -113,7 +113,7 @@
     \vskip3bp
     \centerline{and the MetaPost development team}
     \vskip20.8bp% actually 31.8bp (-11bp)
-    \centerline{\large documented version: \mpversion\ (2.0rc1)}
+    \centerline{\large documented version: \mpversion\ (2.0rc2)}
     \vskip3bp
 \tracingall    \centerline{\svnInfoMaxToday} \tracingnone
     \vfil
@@ -2620,6 +2620,45 @@ $$ \hbox{\tt arctime a of p} $$
 gives the time~{\tt t} such that
 $$ \hbox{\tt arclength subpath (0,t) of p} = {\tt a}. $$
 
+The operator {\tt
+  envelope}\index{envelope?\texttt{envelope}}\label{Denvelop} %
+returns the envelope of a path {\tt p} drawn with a polygonal pen,
+and returns an error if the pen is not polygonal.
+Figure~\ref{fig261} shows the envelope of an approximation of an elliptical pen.
+
+\begin{figure}[htp]
+$$ \begin{verbatim}
+beginfig(261);
+path p[] ;
+pen mypen ;
+pen mypenC;
+numeric L ;
+numeric S ;
+L:=10;
+Sa:=1;
+Sb:=2;
+Rot=32;
+p[-1] := ( (Sa*cosd(0),Sb*sind(0)) for i=1 upto L-1:
+ -- (Sa*cosd(i/L*360), Sb*sind(i/L*360)) endfor -- cycle )  rotated Rot;
+mypen := makepen(p[-1]) ;
+mypenC:= (pencircle xscaled 2Sa yscaled 2Sb) rotated Rot;
+p0 := (0,0){down} .. {up} (100,0)  ;
+p1 := envelope  mypen  of p0 ;
+draw  p1 withcolor black   withpen pencircle scaled 0.2pt ;
+draw p0 withcolor 0.8white withpen mypenC;
+for t=1 upto length(p1): 
+ draw (point t of p1) withpen pencircle scaled 0.8pt; 
+endfor;
+endfig;
+\end{verbatim}
+\atop \includegraphics[width=0.9\textwidth]{mpman-261.mps}
+$$
+\caption{Example of envelope}
+\label{fig261}
+\end{figure}
+
+
+
 \subsection{Affine Transformations}
 \label{transsec}
 \index{transform type}