hobby (16aug14)

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

4 files changed, 49 insertions, 2 deletions

diff --git a/Master/texmf-dist/doc/latex/hobby/README b/Master/texmf-dist/doc/latex/hobby/README
index d48c4b90e17..04af0731d63 100644
--- a/Master/texmf-dist/doc/latex/hobby/README
+++ b/Master/texmf-dist/doc/latex/hobby/README
@@ -1,7 +1,7 @@
 ----------------------------------------------------------------
 hobby --- a TikZ/PGF library for drawing smooth(ish) curves using
           Hobby's algorithm (implemented in LaTeX3)
-E-mail: stacey@math.ntnu.no
+E-mail: loopspace@mathforge.org
 Released under the LaTeX Project Public License v1.3c or later
 See http://www.latex-project.org/lppl.txt
 ----------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby.pdf b/Master/texmf-dist/doc/latex/hobby/hobby.pdf
index 4f581c840cf..07ada0caba0 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby.pdf
+++ b/Master/texmf-dist/doc/latex/hobby/hobby.pdf
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf b/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
index c3b008ed70e..b63f4142a6b 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
+++ b/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex b/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
index a00a4d525a0..ed83ded58ce 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
+++ b/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
@@ -9,6 +9,7 @@
 \usepackage{fancyvrb}
 \usetikzlibrary{hobby,decorations.pathreplacing}
 \usepackage{listings}
+\usepackage{hyperref}
 \pgfplotsset{compat=1.9}
 \lstloadlanguages{[LaTeX]TeX}
 \lstset{breakatwhitespace=true,breaklines=true,language=TeX}
@@ -146,7 +147,14 @@ It can be loaded with
 \begin{verbatim}
 \usetikzlibrary{hobby}
 \end{verbatim}
-%%
+
+\textbf{Warning}: This package makes extensive use of \LaTeX3.
+On occasion, updates to \LaTeX3 packages have resulted in this package behaving oddly or not working at all.
+The most up to date version of this package can be obtained from the \href{http://bazaar.launchpad.net/~tex-sx/tex-sx/development/files}{TeX-SX Launchpad page} (download \Verb+hobby.dtx+ and run \Verb+tex hobby.dtx+ to generate the files).
+Often, such issues are reported on the \href{http://tex.stackexchange.com}{TeX-SX} site and workarounds quickly found so it is worth checking there as well.
+
+\bigskip
+
 There are a variety of ways of specifying the data to the algorithm to generate the curve.
 
 \subsection{As a \textsf{to path}.}
@@ -224,6 +232,38 @@ However, the Hobby algorithm is designed to draw a curve in 2D-{}space and does
 \end{tikzpicture}
 \end{example}
 
+\subsection{Basic Level PGF Commands}
+
+(Suggested by the question \href{http://tex.stackexchange.com/q/159896/86}{How to combine Hobby paths with PGF Basic Layer commands?} on TeX-SX.)
+
+In some circumstances, it is convenient to bypass TikZ and use more basic PGF commands for building a path.
+It is possible to add a path built using Hobby's algorithm in this fashion.
+The commands are:
+
+\begin{itemize}
+\item \Verb+\pgfpathhobby+ to initialise the path.
+If this is followed by a braced group then the contents of that are taken as options to the algorithm.
+
+\item \Verb+\pgfpathhobbypt{<pgf point specification>}+ to add a point to the path.
+If this is followed by a braced group then the contents of that are taken as options for that point.
+
+\item \Verb+\pgfpathhobbyend+ finalises the path.
+This applies the algorithm to the set of specified points and adds it to the current path.
+\end{itemize}
+
+\begin{example}
+\begin{tikzpicture}
+\pgfpathmoveto{\pgfpoint{0}{0}}
+\pgfpathlineto{\pgfpoint{1cm}{0}}
+\pgfpathhobby{closed=true}
+\pgfpathhobbypt{\pgfpoint{1cm}{2cm}}{tension in=2}
+\pgfpathhobbypt{\pgfpoint{2cm}{1cm}}
+\pgfpathhobbypt{\pgfpoint{3cm}{0cm}}
+\pgfpathhobbyend
+\pgfusepath{stroke}
+\end{tikzpicture}
+\end{example}
+
 \section{Customisation}
 
 There are various ways to customise the path generated by the Hobby algorithms.
@@ -865,6 +905,13 @@ The actual curves are then produced from the angles using the same formulae for
 
 At the last stage, we render both segments of the generated curve.
 
+\section{Acknowledgements}
+
+This package began life as an answer to the question \href{http://tex.stackexchange.com/q/54771/86}{Curve through a sequence of points with Metapost and TikZ}.
+Once released upon the unsuspecting world, various questions on the \href{http://tex.stackexchange.com}{TeX-SX} site have prompted new features (and bug-fixes).
+Most of these can be found by looking at the \href{http://tex.stackexchange.com/questions/tagged/hobby}{list of questions tagged ``hobby''} on that site.
+
+
 \begin{thebibliography}{1} \bibitem{MR834054} John~D. Hobby. \newblock Smooth, easy to compute interpolating splines. \newblock {\em Discrete Comput. Geom.}, 1:123--140, 1986. \end{thebibliography}
 
 \end{document}