several updates (sorry Karl, it was a long train ride):

updates of packages: screenplay, bussproofs computational-complexity
     dvdcoll gnuplottex mathmode movie15 pgf pstricks-add pst-labo 
     trfsigns (dvi->pdf move, COPYING file to doc) toptesi tocvsec2 thumb 
     textfit (doc move)
added to tpm-ctan-check: typogrid trsym trfsigns tracking toptesi toolbox
     todo tocvsec2 tocloft tocbibind titling titlefoot thumb textopo textfit
     teubner tensor


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

4 files changed, 110 insertions, 39 deletions

diff --git a/Master/texmf-dist/doc/latex/movie15/README b/Master/texmf-dist/doc/latex/movie15/README
index e0d1259907e..bfe5f779188 100644
--- a/Master/texmf-dist/doc/latex/movie15/README
+++ b/Master/texmf-dist/doc/latex/movie15/README
@@ -30,9 +30,12 @@ Description:
 
 Usage:
 
- \usepackage[3D]{movie15}
+ \usepackage[<package options>]{movie15}
 
    Package option `3D' enables the 3D feature from the PDF-1.6 specification.
+   With option `draft' media files are not included. The file name is printed
+   in a box of size <width>x(<height>+<depth>). `final' does the opposite,
+   overriding a global draft option specified in the \documentclass command.
 
 
  \includemovie[<options>]{<width>}{<height>}{<media file>}
@@ -64,7 +67,7 @@ Usage:
 
    attach[=false]             By default, the embedded data stream is re-used as
                               embedded file attachment, giving the user the
-                              oportunity to extract the media file and to save
+                              opportunity to extract the media file and to save
                               it to disk for later playback with an external
                               player.  Re-use as file attachment can be
                               suppressed with `attach=false'.
@@ -97,9 +100,13 @@ Usage:
                               extend below the reference line of the running
                               text. Any valid TeX dimension will be accepted.
 
+   draft                      Locally switches to draft mode.
+
    externalviewer             Opens and plays the media in an external
                               application.
 
+   final                      Locally disables draft mode.
+
    inline[=false]             Movie file data are embedded into the PDF output
                               by default. Embedding can be suppressed using
                               `inline=false'.
@@ -109,7 +116,7 @@ Usage:
                               somewhere else in the document.
 
    mimetype=<mimetype>        Mime type of media. Must be specified if
-                              <media file> has a non-standard filename
+                              <media file> has a non-standard file name
                               extension from which the mimetype cannot be
                               guessed. See table `Known file name extensions'
                               below.
@@ -186,7 +193,7 @@ Usage:
    3Daac=<angle>              This option sets the aperture angle of the camera,
                               measured in degrees. Fixed point real numbers
                               between 0 and 180 are admissible. A sensible value
-                              of 30 is preset by default. Larger values can be
+                              of 30 is pre-set by default. Larger values can be
                               used to achieve wide-angle or fish-eye effects.
 
    3Dc2c=<x> <y> <z>          Direction vector C2C of arbitrary length,
diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.pdf b/Master/texmf-dist/doc/latex/movie15/movie15.pdf
index 3b4afa9dacc..27cd89c2953 100644
--- a/Master/texmf-dist/doc/latex/movie15/movie15.pdf
+++ b/Master/texmf-dist/doc/latex/movie15/movie15.pdf
diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.tex b/Master/texmf-dist/doc/latex/movie15/movie15.tex
index b81e6e07f3b..18f7d208363 100644
--- a/Master/texmf-dist/doc/latex/movie15/movie15.tex
+++ b/Master/texmf-dist/doc/latex/movie15/movie15.tex
@@ -14,6 +14,16 @@
 \usepackage{graphicx}
 \usepackage{hyperref}
 \usepackage{textcomp}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{float}
+\usepackage{ifpdf}
+
+\ifpdf\else
+  \makeatletter
+  \@latex@error{Please use pdfLaTeX to compile this documentation}
+  \makeatother
+\fi
 
 \pdfpagewidth595bp
 \pdfpageheight842bp
@@ -44,6 +54,8 @@ A \LaTeX{} package for inclusion of movies, sounds and 3D objects into PDF docum
 \end{abstract}
 
 \tableofcontents
+
+\newpage
 \section{Introduction}
 
 The way multimedia content, i.\,e. movies and sounds, is included into PDF has changed with Adobe's PDF specification, version 1.5. PDF-1.5 supports a larger variety of movie and sound formats, limited only by the number of plug-ins available for Adobe Reader\textsuperscript{\scriptsize\textregistered}. With PDF-1.6, support for 3D objects, stored in the U3D file format, has been added. See Table \ref{table:mime} for a list of viable media formats. The specification allows media file contents to be completely embedded into the PDF output, thus producing self-contained PDF documents.
@@ -57,6 +69,14 @@ The final PDF output can be viewed with Windows\textsuperscript{\scriptsize\text
 \section{Installation}
 The file `movie15.sty' should be stored in a place where \LaTeX{} can find it.
 
+\section{Requirements}
+pdf\LaTeX{}, version $\ge1.20$, is needed for direct PDF output.
+
+If the package option `\verb+3D+' is set, `movie15' loads Michael Mehlich's `fp' package for fixed point arithmetic. Since it does not belong to the core packages of most \TeX{} distributions it must be installed prior to selecting the `\verb+3D+' option.
+
+Adobe Reader, version 6, is required for playing movies and sounds, version 7 for rendering embedded 3D content. Unfortunately, only Windows and Mac versions of Adobe Reader provide the necessary plug-ins.
+
+\newpage
 \section{Using the package}
 Invoke the package by putting the line
 \begin{verbatim}
@@ -64,9 +84,21 @@ Invoke the package by putting the line
 \end{verbatim}
 to the preamble of your document, i.\,e. somewhere between \verb+\documentclass+ and \verb+\begin{document}+.
 
-`movie15' takes the option `\verb+3D+'. It enables the 3D feature from the PDF-1.6 specification. Inclusion of 3D files into PDF is discussed separately in section~\ref{3dtut}.
+`movie15' honours the following package options:
+\begin{verbatim}
+3D
+\end{verbatim}
+Enables the 3D feature from the PDF-1.6 specification. Inclusion of 3D files into PDF is discussed separately in section~\ref{sec:3D}.
 
-Currently, there are no further options.
+\begin{verbatim}
+draft
+\end{verbatim}
+Media files are not included. Just the file name is printed in a box of size \verb+<width>+$\times$(\verb+<height>++\verb+<depth>+), see \hyperlink{lnk:widthheight}{below}.
+\begin{verbatim}
+final
+\end{verbatim}
+The opposite of draft. Useful to override a global draft option specified
+in the \verb+\documentclass+ command.
 
 If PDF is generated via DVI and Postscript by the usual \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+ sequence of commands, the `graphicx' and `hyperref' packages are required and must be loaded \emph{after} `movie15'.
 
@@ -74,22 +106,15 @@ In the case of pdf\LaTeX{}, the `graphicx' and `hyperref' packages are not requi
 
 Note that several runs may be necessary to resolve internally created cross-references. Appropriate warnings will be issued in such cases.
 
-\section{Requirements}
-pdf\LaTeX{}, version $\ge1.20$, is needed for direct PDF output.
-
-If the package option `\verb+3D+' is set, `movie15' loads Michael Mehlich's `fp' package for fixed point arithmetic. Since it does not belong to the core packages of most \TeX{} distributions it must be installed prior to selecting the `\verb+3D+' option.
-
-Adobe Reader, version 6, is required for playing movies and sounds, version 7 for rendering embedded 3D content. Unfortunately, only Windows and Mac versions of Adobe Reader provide the necessary plug-ins.
-
 \section{The user interface}
 \subsection{Media inclusion}\label{usrif}
 Movies, sounds and 3D objects are embedded into the document using the command
 \begin{verbatim}
     \includemovie[<options>]{<width>}{<height>}{<media file>}
 \end{verbatim}
-Unless left empty, the \verb+<width>+ and \verb+<height>+ arguments must be given in valid \TeX{} dimensions. Horizontal and vertical dimensions of the media clip are scaled independently to fit \verb+<width>+ and \verb+<height>+ or, if the two latter are empty, to fit the size of the text box, given as argument to the `\verb+text+' option (see \hyperlink{lnk:textoption}{below}). \verb+<media file>+ specifies the file name of the media clip. If the media file is embedded as part of the final PDF output, which is the default, it may reside wherever \TeX{} or Ghostscript search for input files, depending on the PDF producing method.
+\hypertarget{lnk:widthheight}{}Unless left empty, the \verb+<width>+ and \verb+<height>+ arguments must be given in valid \TeX{} dimensions. Horizontal and vertical dimensions of the media clip are scaled independently to fit \verb+<width>+ and \verb+<height>+ or, if the two latter are empty, to fit the size of the text box, given as argument to the `\verb+text+' option, see \hyperlink{lnk:textoption}{below}. \verb+<media file>+ specifies the file name of the media clip. If the media file is embedded as part of the final PDF output, which is the default, it may reside wherever \TeX{} or Ghostscript search for input files, depending on the PDF producing method.
 
-Below, common options to \verb+\includemovie+ are listed. Options specific to embedding of 3D content are discussed separately in section~\ref{3dtut}.
+Below, common options to \verb+\includemovie+ are listed. Options specific to embedding of 3D content are discussed separately in section~\ref{sec:3D}. The impatient reader may advance directly to the \hyperlink{sec:3Dtut}{3D quick-start guide}, which summarizes the basic steps for embedding 3D objects.
 \begin{verbatim}
 attach[=false]
 \end{verbatim}
@@ -127,10 +152,18 @@ depth=<depth>
 \end{verbatim}
 Specifies how far the media display area should extend below the bottom line of the running text. Any valid \TeX{} dimension is accepted.
 \begin{verbatim}
+draft
+\end{verbatim}
+Locally switches to draft mode.
+\begin{verbatim}
 externalviewer
 \end{verbatim}
 Opens and plays the media in an external application.
 \begin{verbatim}
+final
+\end{verbatim}
+Locally disables draft mode.
+\begin{verbatim}
 inline[=false]
 \end{verbatim}
 Media file \emph{data} are embedded into PDF output by default.
@@ -222,12 +255,12 @@ volume=<percentage of original volume>
 \end{verbatim}
 The meaning of this option should be self explaining.
 
-\subsection{Inclusion of 3D objects}\label{3dtut}
-The PDF-1.6 specification, which was introduced with the advent of Adobe Acrobat/Reader 7, allows embedding of 3-dimensional graphic objects, such as CAD models or 3D scientific data, and lets the user interactively manipulate them. At time of writing this documentation, the only supported file format is U3D~\cite{3diforg}, and only one commercial software~\cite{dexp} for exporting into U3D format, yet from a number of CAD and 3D vector formats, including DXF and VRML, was known. Nevertheless, a try-out version of~\cite{dexp} can be downloaded from the Web site.
+\subsection{Inclusion of 3D objects}\label{sec:3D}
+The PDF-1.6 specification, which was introduced with the advent of Adobe Acrobat/Reader 7, allows embedding of 3-dimensional graphic objects, such as CAD models or 3D scientific data, and lets the user interactively manipulate them. At time of writing this documentation, the only supported file format is U3D~\cite{3diforg}, and only one commercial software~\cite{dexp} for exporting into U3D format, yet from a number of CAD and 3D vector formats, including DXF and VRML, was known. Nevertheless, a try-out version of~\cite{dexp} can be downloaded without charge.
 
 Selection of the `\verb+3D+' package option enables the 3D feature. Most of the command options listed in section~\ref{usrif} do what they are supposed to do in the case of embedded 3D as well. Other options are ignored, in particular `\verb+repeat+', `\verb+palindrome+', `\verb+startat+', `\verb+endat+', `\verb+rate+' and `\verb+volume+', because they do not make sense and `\verb+mouse+', because 3D objects are interactive by definition. Options `\verb+inline=false+' and `\verb+url+' are supported, but imply option `{\tt{}externalview\-er}', because the 3D Reader plug-in handles embedded files only.
 
-There are a few options to \verb+\includemovie+ which define how the 3D object is positioned within the viewport of a virtual camera, or conversely, how the virtual camera is positioned and oriented within a coordinate system, called `The World', which bears the 3D object at a fixed position. Fig.~\ref{3dscene} should help to visualize the scenery: The virtual camera is orbiting at a distance of $ROO$ around the centre of orbit, specified by the position vector $\overrightarrow{COO}$; $\sphericalangle AAC$ is the camera's aperture angle. In addition, the direction vector $\overrightarrow{C2C}$ is needed to specify the initial camera position.
+There are a few options to \verb+\includemovie+ which define how the 3D object is positioned within the view port of a virtual camera, or conversely, how the virtual camera is positioned and oriented within a coordinate system, called `The World', which bears the 3D object at a fixed position. Fig.~\ref{3dscene} should help to visualize the scenery: The virtual camera is orbiting at a distance of $ROO$ around the centre of orbit, specified by the position vector $\overrightarrow{COO}$; $\sphericalangle AAC$ is the camera's aperture angle. In addition, the direction vector $\overrightarrow{C2C}$ is needed to specify the initial camera position.
 \begin{figure}[ht]
   \resizebox{\linewidth}{!}{\input{3dsystem}}
   \caption{Camera and 3D object in the World System $XYZ$; centre of orbit position vector $\vec{COO}$, centre of orbit to camera direction vector $\vec{C2C}$, radius of orbit $ROO$, aperture angle of camera $\sphericalangle AAC$.}\label{3dscene}
@@ -237,7 +270,7 @@ The \emph{default view}, i.\,e. the view that is shown initially after activatin
 \begin{verbatim}
 3Daac=<angle>
 \end{verbatim}
-This option sets the aperture angle of the camera, measured in degrees. Fixed point real numbers between 0 and 180 are admissible. A sensible value of 30 is preset by default. Larger values can be used to achieve wide-angle or fish-eye effects, see example~\ref{ex3d} in section~\ref{examples}.
+This option sets the aperture angle of the camera, measured in degrees. Fixed point real numbers between 0 and 180 are admissible. A sensible value of 30 is pre-set by default. Larger values can be used to achieve wide-angle or fish-eye effects, see example~\ref{ex3d} in section~\ref{examples}.
 \begin{verbatim}
 3Dc2c=<x> <y> <z>
 \end{verbatim}
@@ -255,13 +288,7 @@ are allowed.
 \end{verbatim}
 \verb+<r>+ (always positive!) specifies the radius of orbit $ROO$ of the virtual camera. See option `\verb+3Dc2c+' for the number format of \verb+<r>+.
 
-Without the above options the virtual camera sits at the origin $(0,0,0)$ of the World, looking in the positive $Y$ direction, i. e. default settings of \verb+3Droo=0+, \verb+3Dcoo=0 0 0+ and  \verb+3Dc2c=0 -1 0+ are assumed. (Note that $\overrightarrow{C2C}$ is the opposite of the view vector!)
-
-Thus, in order to get a `front view' of the 3D object it is sufficient to gradually increase the radius $ROO$ from \LaTeX{} run to \LaTeX{} run until the object or group of objects can be fully seen in the viewport. Since the object size in terms of world coordinate units may differ in orders of magnitude between U3D files, the optimal `\verb+3Droo+' setting might be found by experimenting with a series of geometrically increasing numbers, such as 1, 10, 100, 1000, 10000 etc. to get a rough approximation and by subsequent fine tuning using smaller changes.
-
-Ideally, there should be no need for changing the default setting of \verb+3Dcoo=0 0 0+ for the centre of orbit. However, this requires that the 3D object or group of objects be centred around the world origin $(0,0,0)$ during file export into U3D format. (This is the default setting with~\cite{dexp}.) If the 3D object apparently pivots around an orbital centre that lies outside of the object's cubature, either the file export could be repeated with appropriate settings or the centre of orbit could be moved into the object centre using the `\verb+3Dcoo+' option. Regarding the latter method, this can be easily achieved if the object is examined from two different directions, say from left (\verb+3Dc2c=-1 0 0+) in order to adjust the \verb+<y>+ and \verb+<z>+ coordinates of `\verb+3Dcoo+' and from front (\verb+3Dc2c=0 -1 0+) in order to adjust the remaining \verb+<x>+ coordinate.
-
-Alternatively, good values for the `\verb+3Droo+' and `\verb+3Dcoo+' options can be found easily by temporarily inserting a hyperlink using the \verb+\movieref+ command together with the `\verb+3Dcalculate+' option. See section \ref{hyperlinks} for an explanation and example \ref{ex3d} in section \ref{examples}.
+Without the above options the virtual camera sits at the origin $(0,0,0)$ of the World, looking in the positive $Y$ direction, i.\,e. default settings of \verb+3Droo=0+, \verb+3Dcoo=0 0 0+ and  \verb+3Dc2c=0 -1 0+ are assumed. (Note that $\overrightarrow{C2C}$ is the opposite of the view vector!) Thus, in order to get a `front view' of the 3D object it is sufficient to set the radius of orbit, i.\,e. the distance between camera and object appropriately. Sometimes you may want to adjust the orbital centre, i.\,e. the target of the camera as well, in particular, if the object is irregularly shaped. Fortunately, it is possible to let the values of the corresponding options be determined automatically. Simply insert a hyperlink using the \verb+\movieref+ command together with the `\verb+3Dcalculate+' option. Once the settings for `\verb+3Droo+' and `\verb+3Dcoo+' have been calculated, the hyperlink can be removed again. See section \ref{hyperlinks} for an explanation and example \ref{ex3d} in section \ref{examples}.
 
 \begin{verbatim}
 3Dviews=<views file>
@@ -331,7 +358,7 @@ Go to a predefined view of the 3D object. \verb+<index>+ can take `\verb+F+', `\
 3Dcoo=<x> <y> <z>
 3Droo=<r>
 \end{verbatim}
-Instead of referencing an existing view of the 3D object, a new one can be defined using any of these options, cf. section~\ref{3dtut}.
+Instead of referencing an existing view of the 3D object, a new one can be defined using any of these options, cf. section~\ref{sec:3D}.
 
 \begin{verbatim}
 3Dcalculate[=<aac angle>]
@@ -347,6 +374,7 @@ Runs the script \verb+<JavaScript file>+ after clicking the link. Unlike the scr
 \end{verbatim}
 For details about Acrobat JavaScript and its Annot3D object, see \cite{jscript}.
 
+\newpage
 \subsection{Compatibility commands}
 Two user commands have been provided that make `movie15' a replacement for the `multimedia' package which is part of Till Tantau's `Beamer' Class:
 \begin{verbatim}
@@ -386,7 +414,7 @@ duration=<duration in seconds>s
 \end{verbatim}
 The duration of the media segment to be played. The trailing `\verb+s+' is mandatory. Note that `\verb+duration+' cannot be used together with option `\verb+startat+' from \verb+\includemovie+. In order to define a media segment options can be combined as follows: `\verb+startat+'/`\verb+endat+', `\verb+start+'/`\verb+endat+', `\verb+start+'/`\verb+duration+'.
 
-%\newpage
+\newpage
 \section{Examples}\label{examples}
 \begin{enumerate}
 \item A short circular MPEG movie, taken from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video.net/} \href{http://www.linux-video.net/Samples/}{\tt Samples/}
@@ -411,8 +439,7 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 \end{center}
 \end{minipage}
 
-%\enlargethispage{15ex}\thispagestyle{empty}
-\newpage
+%\newpage
 \item Another MPEG movie, loaded on the fly from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video} \href{http://www.linux-video.net/Samples/}{\tt .net/Samples/}. Hence, a working Internet connection is required. This time, we force the QuickTime plug-in to be used instead of MediaPlayer (Windows boxes only). Well, the latter seems to be bugged. Quod erat expectandum.
 
 \begin{minipage}{0.5\linewidth}
@@ -438,7 +465,6 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 \begin{minipage}{0.5\linewidth}
 \begin{center}
   \includemovie[poster, label=alien, text=(AlienSong.mpg), url, playerid=AAPL_QuickTime, repeat]{\linewidth}{.75\linewidth}{http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg}\\
-%  \includemovie[poster, label=alien, text=(AlienSong.mpg), playerid=AAPL_QuickTime, repeat]{\linewidth}{.75\linewidth}{AlienSong.mpg}\\
 \movieref[rate=0.5]{alien}{Slow}\hfill
 \movieref{alien}{Normal}\hfill
 \movieref[rate=2]{alien}{Fast}\hfill
@@ -446,6 +472,7 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 \end{center}
 \end{minipage}
 
+\newpage
 \item\label{ex3d} Embedded U3D file. It is based on a VRML model by Peter Whitehouse \href{mailto:pwhitehouse@optusnet.com.au}{\tt <pwhitehouse@optusnet.com.au>}. Conversion to U3D has been made with DeepExploration\textsuperscript{\scriptsize\textregistered}\cite{dexp}. The file `{\tt dice.vws}' provides additional views to be selected from the 3D toolbar or by right click. The JavaScript `{\tt dice.js}' defines light sources and disables the annoying Gimbal rotation mode.
 
 \begin{minipage}{0.5\linewidth}
@@ -490,15 +517,43 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 
 \end{enumerate}
 
-\begin{thebibliography}{9}
-  \bibitem{pdfspec} Adobe Systems Inc.: \emph{PDF Reference, fifth edition: Adobe Portable Document Format version 1.6}, 2004, Implementation note 144, Appendix H.3, available at: \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/pdf_creation_apis_and_specs/PDFReference.pdf}{\tt http://partners.adobe.com/public/developer/en/acrobat/sdk/} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/pdf_creation_apis_and_specs/PDFReference.pdf}{\tt pdf/pdf\_creation\_apis\_and\_specs/PDFReference.pdf}.
-  \bibitem{3diforg} \href{http://www.3dif.org/}{\tt http://www.3dif.org/}
-  \bibitem{dexp} \href{http://www.righthemisphere.com/products/dexp/}{\tt http://www.righthemisphere.com/products/dexp/}
-  \bibitem{jscript3D}  Adobe Systems Inc.: \emph{Adobe Acrobat 7.0 3D JavaScript Reference}, 2005, available at \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/Acro3DJS.pdf}{\tt http://partners.adobe.com/public/developer/en/ac} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/Acro3DJS.pdf}{\tt robat/sdk/pdf/javascript/Acro3DJS.pdf}
-  \bibitem{jscript}  Adobe Systems Inc.: \emph{Adobe Acrobat 7.0.5 JavaScript Scripting Reference}, 2005, available at \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}{\tt http://partners.adobe.com/public/developer/en/ac} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}{\tt robat/sdk/pdf/javascript/AcroJS.pdf}
-\end{thebibliography}
+\appendix
+\section{3D quick-start guide}\hypertarget{sec:3Dtut}{}
+\begin{enumerate}
+  \item Insert the 3D object with default camera settings and a {\tt \string\movieref} referencing it:
+
+  {\tt%
+    \string\includemovie[poster, label=my\_label]\string{\\
+	\phantom{xx}.5\string\linewidth\\
+	\string}\string{\\
+	\phantom{xx}.5\string\linewidth\\
+	\string}\string{\\
+    \phantom{xx}my\_file.u3d\\
+	\string}\string\\\\
+    \string\movieref[3Dcalculate]\string{my\_label\string}\string{Click here!\string}
+  }
+
+  \item Compile and recompile the document source until no more `movie15' related warnings appear.
+  \item Open the PDF document with Adobe Reader and go to the page containing the 3D object. Click the link and wait for a dialogue box to pop up.
+  \item Copy the settings ({\tt 3Droo=...}, {\tt 3Dcoo=...}) from the dialogue box into the option list of {\tt \string\include\-movie}. Remove the link from the document source:
+
+  {\tt%
+    \string\includemovie[\\
+	\phantom{xx}poster, 3Droo=33.3333, 3Dcoo=1.2345 9.8765 0
+	\\]\string{\\
+	\phantom{xx}.5\string\linewidth\\
+	\string}\string{\\
+	\phantom{xx}.5\string\linewidth\\
+	\string}\string{\\
+    \phantom{xx}my\_file.u3d\\
+	\string}
+  }
+
+  \item Again, compile and recompile the document source until no more `movie15' related warnings appear.
+\end{enumerate}
 
-\begin{table}[h]
+\section{Media formats}
+\begin{table}[H]
 \caption{Media formats for use with Adobe Reader (partially from \cite{pdfspec})}\label{table:mime}
 \RaggedRight
 \begin{tabular}[t]{llp{0.36\linewidth}}\hline
@@ -521,5 +576,14 @@ wma             & audio/x-ms-wma & Windows Media Audio\\
 wmv             & video/x-ms-wmv & Windows Media Video\\\hline
 \end{tabular}
 \end{table}
+
+\begin{thebibliography}{9}
+  \bibitem{pdfspec} Adobe Systems Inc.: \emph{PDF Reference, fifth edition: Adobe Portable Document Format version 1.6}, 2004, Implementation note 144, Appendix H.3, available at: \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/pdf_creation_apis_and_specs/PDFReference.pdf}{\tt http://partners.adobe.com/public/developer/en/acrobat/sdk/} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/pdf_creation_apis_and_specs/PDFReference.pdf}{\tt pdf/pdf\_creation\_apis\_and\_specs/PDFReference.pdf}.
+  \bibitem{3diforg} \href{http://www.3dif.org/}{\tt http://www.3dif.org/}
+  \bibitem{dexp} \href{http://www.righthemisphere.com/products/dexp/}{\tt http://www.righthemisphere.com/products/dexp/}
+  \bibitem{jscript3D}  Adobe Systems Inc.: \emph{Adobe Acrobat 7.0 3D JavaScript Reference}, 2005, available at \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/Acro3DJS.pdf}{\tt http://partners.adobe.com/public/developer/en/ac} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/Acro3DJS.pdf}{\tt robat/sdk/pdf/javascript/Acro3DJS.pdf}
+  \bibitem{jscript}  Adobe Systems Inc.: \emph{Adobe Acrobat 7.0.5 JavaScript Scripting Reference}, 2005, available at \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}{\tt http://partners.adobe.com/public/developer/en/ac} \href{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}{\tt robat/sdk/pdf/javascript/AcroJS.pdf}
+\end{thebibliography}
+
 \end{document}
 
diff --git a/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf
index 0eb32f511c4..845bbbaab89 100644
--- a/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf
+++ b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf