tikzducks (15aug17)

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

3 files changed, 305 insertions, 111 deletions

diff --git a/Master/texmf-dist/doc/latex/tikzducks/README.md b/Master/texmf-dist/doc/latex/tikzducks/README.md
index cb0ce8573bc..3d6371a71fd 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/README.md
+++ b/Master/texmf-dist/doc/latex/tikzducks/README.md
@@ -1,11 +1,11 @@
-# tikzducks
+# Tikzducks
 
-This is a little LaTeX package for ducks to be used in *TikZ* pictures. The project is a continuation of https://tex.stackexchange.com/a/347458/36296
+This is a little LaTeX package for ducks to be used in TikZ pictures. The project is a continuation of https://tex.stackexchange.com/a/347458/36296
 
-This project is licensed under the LaTeX Project Public License (LPPL), see http://www.latex-project.org/lppl.txt
+This project is licensed under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt
 
 The project repository, including a bug tracker, can be found at https://github.com/samcarter8/tikzducks/issues
 
 ### A few examples:
 
-![tikz ducks](https://user-images.githubusercontent.com/8226363/28897479-36cb96ac-77e1-11e7-865f-2fcdd262ad03.png)
+![tikz ducks](https://user-images.githubusercontent.com/8226363/29253620-1c4ea2de-8082-11e7-800b-64df42ce6a66.png)
diff --git a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
index 98aa200f4a5..690141c3b00 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
+++ b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
index 6bf75c71c02..4eebe12d24a 100644
--- a/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
+++ b/Master/texmf-dist/doc/latex/tikzducks/tikzducks-doc.tex
@@ -1,107 +1,175 @@
-\documentclass{ltxdockit}
-\usepackage{btxdockit}
-
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% Documentation for the tikzducks package
+% A package to bring rubber ducks into tikz
+% Maintained by samcarter
+%
+% Project repository and bug tracker:
+% https://github.com/samcarter8/tikzducks
+%
+% Released under the LaTeX Project Public License v1.3c or later
+% See http://www.latex-project.org/lppl.txt
+%
+% Version 0.3
+% Aug 15, 2017 
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\documentclass[parskip=half]{scrartcl}
+
+% packages %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \usepackage[T1]{fontenc}	
 \usepackage[utf8]{inputenc}		
 \usepackage[english]{babel}
 \usepackage[bitstream-charter]{mathdesign}
 \usepackage{tikzducks}
-\usepackage{xspace}
 \usepackage[most]{tcolorbox}
-
-\KOMAoptions{numbers=noenddot}
-\addtokomafont{title}{\sffamily}
-\addtokomafont{paragraph}{\spotcolor}
-\addtokomafont{section}{\spotcolor}
-\addtokomafont{subsection}{\spotcolor}
-\addtokomafont{subsubsection}{\spotcolor}
-\addtokomafont{descriptionlabel}{\spotcolor}
-\setkomafont{caption}{\bfseries\sffamily\spotcolor}
-\setkomafont{captionlabel}{\bfseries\sffamily\spotcolor}
-
-\makeatletter
-\patchcmd{\paragraph}
-  {3.25ex \@plus1ex \@minus.2ex}{-3.25ex\@plus -1ex \@minus -.2ex}{}{}
-\patchcmd{\paragraph}{-1em}{1.5ex \@plus .2ex}{}{}
-\makeatother
-
-\title{The tikzducks package}
-\subtitle{using ducks in tikz}
-\author{samcarter}
- 
-\newcommand{\tikzducks}{\texttt{tikzducks}\xspace}
-\definecolor{duckblue}{rgb}{0.0,0.2,0.4}
-\lstloadlanguages{[LaTeX]Tex} 
+\usepackage[paper=a4paper,margin=3cm]{geometry}
+\usepackage[colorlinks=true,breaklinks=true,urlcolor=duckblue,linkcolor=duckblue,citecolor=duckblue,filecolor=duckblue]{hyperref}
+\usepackage{xspace}
+\usepackage{scrlayer-scrpage} 
+\usepackage{marvosym}
+
+% macros %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newcommand{\CTAN}{\textsc{CTAN}\xspace}
+\newcommand{\TikZ}{Ti\emph{k}Z\xspace}
+\newcommand{\tikzducks}{Ti\emph{k}Zducks\xspace}
+\newcommand{\miktex}{MiK\TeX\xspace}
+\newcommand{\texlive}{\TeX{}Live\xspace}
+
+% customisation %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\definecolor{duckblue}{RGB}{0,70,140}
+\addtokomafont{sectioning}{\color{duckblue}}
+\addtokomafont{date}{\normalsize}
+\addtokomafont{author}{\normalsize}
 
 \tcbset{%
 	colframe=duckblue,
 	arc=2mm,
 	fonttitle=\bfseries,
 	sidebyside,
-	listing options={language={[latex]TeX}, tabsize=2,breaklines},	righthand width=6.5cm
+	listing options={%
+		language={[latex]TeX},
+		tabsize=2,
+		breaklines,
+		basicstyle=\footnotesize\ttfamily,
+		commentstyle={\color{green!50!black}\slshape}, 
+		columns=fullflexible,
+		texcsstyle=*\color{duckblue}\bfseries,
+		keywordstyle=\color{red!60!black}\bfseries,
+		morekeywords={tikzpicture,scope,patterns},
+		moretexcs={duck,path,definecolor,duckpathjacket,duckpathbody,duckpathgrumpybill,duckpathbill,duckpathtshirt,duckpathshorthair,duckpathlonghair,duckpathcrazyhair,duckpathrecedinghair,scalebox,foreach,node,PassOptionsToPackage,usetikzlibrary,selectcolormodel,colorlet},
+	  delim ={[s][\ttfamily\color{green!50!black}]{$}{$}}
+	},
+	righthand width=6.5cm
 }
 
-\begin{document}
+\lstset{%
+	language={[latex]TeX},
+	tabsize=2,
+	breaklines,
+	basicstyle=\footnotesize\ttfamily,
+	commentstyle={\color{green!50!black}\slshape}, 
+	columns=fullflexible,
+	texcsstyle=*\color{duckblue}\bfseries,
+	keywordstyle=\color{red!60!black}\bfseries,
+	morekeywords={tikzpicture,scope,patterns},
+	moretexcs={duck,path,definecolor,duckpathjacket,duckpathbody,duckpathgrumpybill,duckpathbill,duckpathtshirt,duckpathshorthair,duckpathlonghair,duckpathcrazyhair,duckpathrecedinghair,scalebox,foreach,node,PassOptionsToPackage,usetikzlibrary,selectcolormodel,colorlet},
+ delim ={[s][\ttfamily\color{green!50!black}]{$}{$}}
+}
 
-\begin{center}
-	{\LARGE \textbf{The \texttt{tikzducks} Package (version 0.2)}}
-	
-	\large using ducks in \texttt{tikz}
-	
-	samcarter (alias 
-	\begin{tikzpicture}[scale=0.3,baseline=5pt]
-		\duck[body=yellow!50!brown!50!white, 
+\setlength{\footheight}{27.21881pt}
+\cfoot{%
+	\begin{tikzpicture}[scale=0.3,baseline=-5pt]
+		\duck
+	\end{tikzpicture}%
+	\ifnum\thepage>1%
+		\foreach \x in{2,...,\thepage}{%
+			\ifodd\x
+				\begin{tikzpicture}[scale=0.15,baseline=-12pt]
+					\duck
+				\end{tikzpicture}
+			\else%
+				\begin{tikzpicture}[scale=0.15,baseline=-5pt]
+					\duck
+				\end{tikzpicture}
+			\fi%
+		}%
+	\fi%
+} 
+\pagestyle{scrheadings}
+
+% meta %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\title{The \texorpdfstring{\tikzducks}{tikzducks} package}
+\subtitle{using ducks in \TikZ}
+\author{%
+	\texorpdfstring{\texttt{samcarter} (alias 
+		\begin{tikzpicture}[scale=0.3,baseline=5pt]
+			\duck[body=yellow!50!brown!50!white,
 					longhair=red!50!brown, 
 					jacket=blue!50!black]
-	\end{tikzpicture}%
-	)
-	
-	\url{https://github.com/samcarter8/tikzducks}
+		\end{tikzpicture})\\[0.8em]
+		\url{https://github.com/samcarter8/tikzducks}\\
+		\url{https://www.ctan.org/pkg/tikzducks}
+	}{samcarter}}
+\date{Version 0.3 -- \today}
 
-	\today
-\end{center}
+\begin{document}
+\maketitle
+\thispagestyle{scrheadings}
 
-\section{Introduction}
+\section{Introduc(k)tion}
 \label{intro}
 
-The \tikzducks package is a latex package for ducks to be used in \texttt{tikz} pictures. This project is a continuation of an answer at TeX.Stackexchange (\url{https://tex.stackexchange.com/a/347458/36296}).
+The \tikzducks package is a latex package for ducks to be used in \TikZ pictures. 
+This project is a continuation of an answer at TeX.Stackexchange: \href{tex.stackexchange.com/a/347458/36296}{How can we draw a duck?}.
 
-This package is work in progress (and will probably never be really finished as there is an infinite amount of things which could be added), therefore I would be happy to hear your feedback and ideas how to improve the package. The source code can be found on \url{https://github.com/samcarter8/tikzducks}, including a bug tracker, please make constructive use of it!
+This package is work in progress (and will probably never be really finished as there is an infinite amount of things which could be added), therefore I would be happy to hear your feedback and ideas how to improve the package. 
+The head version of the source code can be found on \url{github.com/samcarter8/tikzducks}, including a bug tracker, please make constructive use of it! A more stable package version can be found on \CTAN (\url{www.ctan.org/pkg/tikzducks}) and is included in both \miktex and \texlive as \tikzducks. 
 
-\subsection{License}
+\subsection{Acknowledgements}
 
-Copyright \textcopyright\ \texttt{samcarter}. Permission is granted to copy, distribute and\slash or modify this software under the terms of the LaTeX project public licence, version 1.3c \url{http://www.latex-project.org/lppl.txt}
+Without the friendly and helpful community of \href{https://tex.stackexchange.com/}{TeX.Stackexchange} this package would not exist. I would like to thank a few fellow users in particular:
 
-The shown example ducks are purely fictional characters, any resemblance to real persons is purely coincidental and no copyright infringement is intended.
+First of all \href{https://tex.stackexchange.com/users/101651/carlatex}{CarLaTeX} for pointing out the overwhelming need of having a \tikzducks package and \href{https://tex.stackexchange.com/users/3094/paulo-cereda}{Paulo Cereda} for his contagious enthusiasm for ducks (\emph{Quack!}). Many other users contributed to this package (in random order): \href{https://tex.stackexchange.com/users/4427/egreg}{egreg} helped to implement the \lstinline|\tikzset{}| interface which makes it much easier to adjust the properties of the ducks to fit the user needs, \href{https://tex.stackexchange.com/users/51022/symbol-1}{Symbol 1}  solved a few problems with default key values, \href{https://tex.stackexchange.com/users/2388/ulrike-fischer}{Ulrike Fischer} gave valuable \TikZ advices and last but not least my thanks go to \href{https://tex.stackexchange.com/users/5763/martin-schr%c3%b6der}{Martin Schr\"oder} for his feedback to the code review.
 
-\subsection{Acknowledgements}
+The ducks mostly consist of basic geometric shapes drawn in \TikZ. Some of the more complex shapes (e.g.\ the different hair styles) are first drawn in \texttt{inkscape}\footnote{\url{inkscape.org}} and then exported to \TikZ paths using the \texttt{SVG to TikZ/PGF} extension\footnote{\url{github.com/kjellmf/svg2tikz}}
+
+\subsection{Dependencies}
+
+The \tikzducks package loads the packages \lstinline|xcolor| and \TikZ, both without any options. If you require one of these packages to be loaded with some option, please consider loading it yourself before the \tikzducks package or use, e.g.
+
+\vskip0.5em
+\begin{lstlisting}[morekeywords={xcolor,svgnames}]
+	\PassOptionsToPackage{svgnames}{xcolor}
+\end{lstlisting}
+It also uses the \lstinline|\usetikzlibrary{patterns}|.
 
-I would like to thank a few fellow user from \href{https://tex.stackexchange.com/}{TeX.Stackexchange}: \href{https://tex.stackexchange.com/users/101651/carlatex}{CarLaTeX} for pointing out the overwhelming need of having a \tikzducks package,
-\href{https://tex.stackexchange.com/users/3094/paulo-cereda}{Paulo Cereda} for his contagious enthusiasm for ducks (\emph{Quack!}),
-\href{https://tex.stackexchange.com/users/4427/egreg}{egreg} for his help to implement the \texttt{\tikzset{}} interface which makes it much easier to adjust the properties of the ducks to fit the user needs and last but not least \href{https://tex.stackexchange.com/users/5763/martin-schr%c3%b6der}{Martin Schr\"oder} for his feedback to the code review
+\subsection{License}
+
+Copyright \raisebox{0.2em}{\tiny\fontfamily{cmr}\selectfont\textcopyright}
+\texttt{samcarter}. Permission is granted to copy, distribute and\slash or modify this software under the terms of the LaTeX project public licence, version 1.3c or later \url{http://www.latex-project.org/lppl.txt}.
 
-\bigskip\noindent
-Without them, this package would not exist!
+The shown example ducks are purely fictional characters, any resemblance to real ducks or persons is purely coincidental and no copyright infringement is intended.
 
-\newpage
 \section{Usage}
 
-The basic usage is fairly simple, to draw a duck
-\begin{tcblisting}{title={basic duck}}
+The basic usage is fairly simple, to draw a duck:
+\begin{tcblisting}{title={Basic duck}}
 \begin{tikzpicture}
 	\duck
 \end{tikzpicture}
 \end{tcblisting}
 
-To customise this basic duck, the package uses \texttt{pgf} keys. For almost all parts the colour can be changed using \verb|<shape name>=<colour name>|. For example to change the colour of the duck:
-\begin{tcblisting}{title={blue duck}}
+To customise this basic duck, the package uses \lstinline|pgf| keys. For almost all parts the colour can be changed using \lstinline|<shape name>=<colour name>|. For example to change the colour of the duck:
+\begin{tcblisting}{title={Blue duck}}
 \begin{tikzpicture}
 	\duck[body=blue]
 \end{tikzpicture}
 \end{tcblisting}
 
-If the size of the ducks should be changed:
-\begin{tcblisting}{title={scaled duck},	righthand width=3cm}
+\clearpage
+If the size of the ducks should be changed or shifted:
+\begin{tcblisting}{title={Scaled duck and \emph{The Ugly Duckling}},	righthand width=3cm}
 \begin{tikzpicture}[scale=0.6]
 	\duck
 	\begin{scope}[xshift=90pt, scale=.3, yshift=150pt]
@@ -111,15 +179,15 @@ If the size of the ducks should be changed:
 		\duck
 	\end{scope}
 	\begin{scope}[xshift=80pt, scale=.3, yshift=50pt]
-		\duck
+		\duck[body=gray!50!white,head=gray!50!white]
 	\end{scope}		
 \end{tikzpicture}
 \end{tcblisting}
 
 \subsection{Body parts}
 
-The various parts of the duck body can also be coloured independently, i.e. \texttt{body}, \texttt{head} and \texttt{bill}
-\begin{tcblisting}{title={harlequin duck}}
+The various parts of the duck body can also be coloured independently, i.e. \lstinline|body|, \lstinline|head| or \lstinline|bill|:
+\begin{tcblisting}{title={Harlequin duck}}
 \begin{tikzpicture}
 	\duck[body=yellow,
 		head=yellow!50!orange, 
@@ -127,17 +195,21 @@ The various parts of the duck body can also be coloured independently, i.e. \tex
 \end{tikzpicture}
 \end{tcblisting}
 
-Furthermore using the keyword \texttt{grumpy} the shape of the bill can be changed:
-\begin{tcblisting}{title={grumpy duck}}
+Furthermore using the keyword \lstinline|grumpy| the shape of the bill can be changed:
+\begin{tcblisting}{title={Grumpy duck}}
 \begin{tikzpicture}
 	\duck[grumpy]
 \end{tikzpicture}
+\begin{tikzpicture}
+	\duck[grumpy, bill=cyan]
+\end{tikzpicture}
 \end{tcblisting}
 
+\clearpage
 \subsection{Hair styles}
 
 Some duck also like to have nice hair cuts, several different hair styles are available:
-\begin{tcblisting}{title={hairy duck}}
+\begin{tcblisting}{title={Hairy duck}}
 \begin{tikzpicture}
 	\duck[longhair]
 \end{tikzpicture}
@@ -153,15 +225,15 @@ Some duck also like to have nice hair cuts, several different hair styles are av
 \end{tikzpicture}
 \end{tcblisting}
 
-And of course the colour of each hair styles can be adjusted:
-\begin{tcblisting}{title={coloured hair duck}}
+And of course the colour of each hair style can be adjusted:
+\begin{tcblisting}{title={Coloured hair duck}}
 \begin{tikzpicture}
 	\duck[longhair=teal]
 \end{tikzpicture}
 \end{tcblisting}
 
-Eyebrows are also part of the package. The colour choice is a bit complicate for them - if a colour is explicitly specified \verb|eyebrow=<colour name>| this colour is of coursed used. But if no colour is given, it falls first back to the hair colour and only if the duck does not have any hairs, the default colour is applied.
-\begin{tcblisting}{title={eye brow duck}}
+Eyebrows are also part of the package. The colour choice is more tricky for them -- if a colour is explicitly specified \lstinline|eyebrow=<colour name>| this colour is of course used, but if no colour is given, it first falls back to the hair colour and only if the duck does not have any hairs, the default colour is applied.
+\begin{tcblisting}{title={Eye brow duck}}
 \begin{tikzpicture}
 	\duck[eyebrow]
 \end{tikzpicture}
@@ -176,12 +248,10 @@ Eyebrows are also part of the package. The colour choice is a bit complicate for
 \end{tikzpicture}
 \end{tcblisting}
 
-\newpage
 \subsection{Clothing}
 
-A respectable duck needs a suitable wardrobe. It can choose from a \texttt{tshirt}, a \texttt{jacket} and a \texttt{tie}.
-
-\begin{tcblisting}{title={dressed duck}}
+A respectable duck needs a suitable wardrobe. It can choose from a \lstinline|tshirt|, a \lstinline|jacket| and a \lstinline|tie|. In it's infinite wardrobe these items are available in all colours definable in the current colour model.
+\begin{tcblisting}{title={Dressed duck}}
 \begin{tikzpicture}
 	\duck[tshirt]
 \end{tikzpicture}
@@ -200,49 +270,63 @@ A respectable duck needs a suitable wardrobe. It can choose from a \texttt{tshir
 \end{tikzpicture}
 \end{tcblisting}
 
-\subsection{Accessoire}
+\subsection{Accessoires}
+
+There is a multitude of things a duck might need. 
 
-There is a multitude of things a duck might need. All these examples also work without specifying a colour, but giving both examples with and without explicit colour just makes this overview unnecessary long.
+The following examples all also work without specifying a colour, but giving an examples with and one without explicit colour just makes this overview unnecessary long, so only one is given.
 
-\begin{tcblisting}{title={swimming duck}}
+\begin{tcblisting}{title={Swimming duck}}
 \begin{tikzpicture}
 	\duck[water=cyan!50!blue]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={alien duck}}
+\begin{tcblisting}{title={Alien duck}}
 \begin{tikzpicture}
 	\duck[alien=green!50!brown]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={hat duck}}
+\begin{tcblisting}{title={Hat duck}}
 \begin{tikzpicture}
 	\duck[hat=red!50!black]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={unicorn duck}}
+\begin{tcblisting}{title={Basecap duck}}
+\begin{tikzpicture}
+	\duck[cap=red!80!black]
+\end{tikzpicture}
+\end{tcblisting}
+
+\begin{tcblisting}{title={Santa Clause}}
+\begin{tikzpicture}
+	\duck[santa=red!80!black]
+\end{tikzpicture}
+\end{tcblisting}
+
+\begin{tcblisting}{title={Unicorn duck}}
 \begin{tikzpicture}
 	\duck[body=pink,
-	unicorn=magenta!60!violet,
-	longhair=magenta!60!violet]
+		unicorn=magenta!60!violet,
+		longhair=magenta!60!violet]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={glasses duck}}
+\begin{tcblisting}{title={Glasses duck}}
 \begin{tikzpicture}
 	\duck[glasses=red!50!black]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={sunglasses duck}}
+\begin{tcblisting}{title={Sunglasses duck}}
 \begin{tikzpicture}
-	\duck[sunglasses]
+	\duck[sunglasses=blue]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={book duck}}
+\begin{tcblisting}{title={Book duck}}
 \begin{tikzpicture}
 	\duck[book=\scalebox{0.5}{\TeX}]
 \end{tikzpicture}
@@ -251,31 +335,94 @@ There is a multitude of things a duck might need. All these examples also work w
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={magic duck}}
+\begin{tcblisting}{title={Magic duck}}
 \begin{tikzpicture}
 	\duck[magichat,
 				magicwand]
 \end{tikzpicture}
 \begin{tikzpicture}
 	\duck[magichat=teal,
-				magicstars=cyan,
+				magicstars=blue!30!cyan,
 				magicwand]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={icecream duck}}
+\begin{tcblisting}{title={Cricket duck}}
+\begin{tikzpicture}
+	\duck[cricket=red!50!black]
+\end{tikzpicture}
+\end{tcblisting}
+
+\begin{tcblisting}{title={Icecream duck}}
 \begin{tikzpicture}
 	\duck[icecream]
 \end{tikzpicture}
 \begin{tikzpicture}
-	\duck[icecream=brown, flavoura=brown, flavourb=white, flavourc=red]
+	\duck[icecream=brown, 
+	      flavoura=brown, 
+				flavourb=white, 
+				flavourc=red]
 \end{tikzpicture}
 \end{tcblisting}
 
-\section{Examples}
+\clearpage
+\section{Further customisation}
+
+This package will never be able to do everything every potential user might want to do, as this number quickly approaches $\infty$ -- but as the ducks are simply things inside \lstinline|tikzpicture|s, all the heavy weapons of the \TikZ package are available for further customisation.
+
+\begin{tcblisting}{title={Adding things to the duck}}
+\begin{tikzpicture}
+	\duck
+	\fill[blue] (2,0) rectangle (1,1);
+\end{tikzpicture}
+\end{tcblisting}
 
-Some examples how the \tikzducks can be customised:
-\begin{tcblisting}{title={samcarter duck},	righthand width=3cm}
+\begin{tcblisting}{title={Monochrome duck}}
+\begin{tikzpicture}
+	\selectcolormodel{gray}
+	\duck
+\end{tikzpicture}
+\end{tcblisting}
+
+For convenience the more complex paths of this package are stored in macros, which can easily be reused:
+\begin{tcblisting}{title={Redraw parts}}
+\begin{tikzpicture}
+	\duck
+	\path[preaction={fill, red!50!black},pattern=fivepointed stars, pattern color=yellow]  
+			\duckpathlonghair;
+\end{tikzpicture}
+\end{tcblisting}
+
+In detail, the following paths are available:
+
+\vskip0.5em
+\begin{lstlisting}[breakindent=0pt]
+\duckpathbody, \duckpathgrumpybill, \duckpathbill, \duckpathtshirt, \duckpathjacket,
+\duckpathshorthair, \duckpathlonghair, \duckpathcrazyhair, \duckpathrecedinghair
+\end{lstlisting}
+
+In case one of the other shapes is needed, please have a look at the package source code, which can be found in \lstinline|tikzducks.sty|.
+
+To ease the placement of further accessoires, some particular spots of the duck are marked with \TikZ coordinates, namely the \lstinline|wing|, \lstinline|head| and \lstinline|bill|. 
+
+{
+\footnotesize\ttfamily
+\begin{tcblisting}{title={\normalfont\normalsize\bfseries Coordinates}}
+\begin{tikzpicture}[scale=2]
+	\duck
+	\fill[black] (wing) circle (0.04);
+	\fill[black] (head) circle (0.04);
+	\fill[black] (bill) circle (0.04);
+	\node[xshift=15] at (wing) {wing};
+	\node[xshift=15] at (head) {head};
+	\node[xshift=18] at (bill) {bill};	
+\end{tikzpicture}
+\end{tcblisting}
+}
+
+\section{Showcase}
+
+\begin{tcblisting}{title={\texttt{samcarter} duck},	righthand width=3cm}
 \begin{tikzpicture}
 	\duck[body=yellow!50!brown!50!white, 
 		longhair=red!50!brown, 
@@ -283,28 +430,31 @@ Some examples how the \tikzducks can be customised:
 \end{tikzpicture}
 \end{tcblisting}
 
+\begin{tcblisting}{title={Paulo duck}, righthand width=3cm}
+\begin{tikzpicture}
+	\duck[cap,cricket]
+\end{tikzpicture}
+\end{tcblisting}
+
 \begin{tcblisting}{title={Brazil duck},	righthand width=3cm}
 \begin{tikzpicture}
-\definecolor{brazilgreen}{RGB}{0,155,58}
-\definecolor{brazilyellow}{RGB}{254,223,0}
-\definecolor{brazilblue}{RGB}{0,39,118}
+	\definecolor{brazilgreen}{RGB}{0,155,58}
+	\definecolor{brazilyellow}{RGB}{254,223,0}
+	\definecolor{brazilblue}{RGB}{0,39,118}
 	\duck[body=brazilyellow,
 				shorthair=brazilgreen]
 	\path[preaction={fill, brazilblue},pattern=fivepointed stars, pattern color=white] 
-		(0.500,1.145) .. controls (0.267, 1.102) and (-0.125,0.657) .. 
-		(0.289,0.261) .. controls (0.704,-0.135) and ( 2.863,0.130) .. 
-		(1.818,1.419) .. controls (0.938, 0.946) and ( 1.240,1.378) .. 
-		(0.513,0.700) -- cycle;
+	\duckpathjacket;
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={duck in black},	righthand width=3cm}
+\begin{tcblisting}{title={Duck in black},	righthand width=3cm}
 \begin{tikzpicture}
 	\duck[grumpy, body=yellow!50!brown!50!white, tshirt=white, jacket=black, tie=black, hat=black, sunglasses=black]
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={Prof. van Duck}, righthand width=3cm}
+\begin{tcblisting}{title={Prof.\ van Duck}, righthand width=3cm}
 \begin{tikzpicture}
 	\duck[body=yellow!50!brown!40!white,
 		crazyhair=gray!50!white,
@@ -315,7 +465,7 @@ Some examples how the \tikzducks can be customised:
 \end{tikzpicture}
 \end{tcblisting}
 
-\begin{tcblisting}{title={DEK},	righthand width=3cm}
+\begin{tcblisting}{title={Knuth duck},	righthand width=3cm}
 \begin{tikzpicture}
 	\duck[body=yellow!50!red!20!white,
 		recedinghair=gray!50!white,
@@ -328,5 +478,49 @@ Some examples how the \tikzducks can be customised:
 \end{tikzpicture}
 \end{tcblisting}
 
-\end{document}
+\addtocounter{footnote}{1}
+\begin{tcblisting}{title={67P/Churyumov-Gerasimenko duck$^\thefootnote$},	righthand width=3cm}
+\begin{tikzpicture}[path image/.style={path picture={\foreach \j in {0,...,2}{\node at (0,\j) {\foreach \i in {1,...,5}{\includegraphics[height=1cm]{#1}}};}}}]
+\path [path image=crinklepaper] 
+	(0.90,1.50) ellipse (0.50 and 0.625);
+\path [path image=crinklepaper] \duckpathbody;
+\fill [gray!80!white]  \duckpathbill;
+\fill[white!70!gray, rotate=-20]
+	(0.23,1.7675) ellipse (0.0893 and 0.125);
+\fill[black, rotate=-20]
+	(0.26,1.7575) ellipse (0.0357 and 0.0714);
+\fill[white!70!gray, rotate=-20]
+	(-0.06,1.74) ellipse (0.0786 and 0.1143);
+\fill[black, rotate=-20]
+	(-0.03,1.73) ellipse (0.0286 and 0.0643);
+\end{tikzpicture}
+\end{tcblisting}
+\footnotetext[\thefootnote]{If you try this at home, replace the \texttt{crinklepaper} with an image of the comet's surface, e.g. \url{arxiv.org/abs/1707.02945}}
+
+\begin{tcblisting}{title={With my username I had to...},	righthand width=3cm}
+\definecolor{sgskin}{RGB}{222,197,159}
+\definecolor{sgblond}{RGB}{238,203,96}
+\colorlet{sggreen}{olive!50!black}
+\colorlet{sgbill}{sgskin!85!black}
+\colorlet{sgshirt}{sggreen!50!black}
+
+\begin{tikzpicture}
+	\duck[body=sgskin,bill=sgbill,tshirt=sgshirt,jacket=sggreen,cap=sggreen]
+\end{tikzpicture}
+
+\begin{tikzpicture}
+	\duck[body=sgskin,bill=sgbill,tshirt=sgshirt,jacket=sggreen,shorthair=sgblond]
+\end{tikzpicture}
+
+\begin{tikzpicture}
+	\duck[body=sgskin,bill=sgbill,tshirt=sgshirt,jacket=sggreen,shorthair=brown!70!black,glasses=brown!30!gray, book={\AA}, bookcolour=brown!50!black]
+\end{tikzpicture}
+
+\begin{tikzpicture}
+	\duck[body=brown!80!black,bill=brown!65!black,tshirt=sgshirt,jacket=sggreen,grumpy]
+	\fill[sgblond, rotate=-10] (0.45,2.0) ellipse (0.12 and 0.05);
+	\node[rotate=170] at (0.8,1.89) {\scalebox{0.35}{\Leo}};
+\end{tikzpicture}
+\end{tcblisting}
 
+\end{document}
\ No newline at end of file