summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/handout
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-03-22 22:31:08 +0000
committerKarl Berry <karl@freefriends.org>2014-03-22 22:31:08 +0000
commitfcbe1f2e86b4786a3143654b64e797ed088f8ff5 (patch)
treea05eb18419b8cbd208f6aa1f3b2e185de477dca0 /Master/texmf-dist/doc/latex/handout
parent6c2849b1103ceaad47b6adfbca0c187d113b537e (diff)
handout (22mar14)
git-svn-id: svn://tug.org/texlive/trunk@33260 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/handout')
-rw-r--r--Master/texmf-dist/doc/latex/handout/README4
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example.bib15
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdfbin0 -> 11476 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example1-minimal.tex14
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdfbin0 -> 11469 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.tex16
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdfbin0 -> 12759 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.tex20
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdfbin0 -> 16971 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.tex22
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdfbin0 -> 19774 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example5-numbering.tex24
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdfbin0 -> 25253 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.tex24
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdfbin0 -> 39220 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.tex42
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/latexmkrc2
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/makefile5
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583-not-and-only.tex4
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583.tex4
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583b.tex4
-rw-r--r--Master/texmf-dist/doc/latex/handout/examples/txt/Richard_Simon_NT.tex4
-rw-r--r--Master/texmf-dist/doc/latex/handout/handout.pdfbin0 -> 68323 bytes
-rw-r--r--Master/texmf-dist/doc/latex/handout/handout.tex174
-rw-r--r--Master/texmf-dist/doc/latex/handout/latexmkrc2
-rw-r--r--Master/texmf-dist/doc/latex/handout/makefile21
26 files changed, 401 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/handout/README b/Master/texmf-dist/doc/latex/handout/README
new file mode 100644
index 00000000000..83578af16d6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/README
@@ -0,0 +1,4 @@
+Create handout for auditors of a speech.
+
+Copyright 2014 Maïeul Rouquette
+LLPL 1.3 http://www.latex-project.org/lppl.txt \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example.bib b/Master/texmf-dist/doc/latex/handout/examples/example.bib
new file mode 100644
index 00000000000..f2eb05e99d2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example.bib
@@ -0,0 +1,15 @@
+@book{Simon1689,
+ Address = {Rotterdam},
+ Author = {Richard Simon},
+ Publisher = {Reinier Leers},
+ Title = {Histoire critique du texte du Nouveau Testament, Où l'on établit la Verité des Actes sur lesquels la Religion Chrétienne est fondée},
+ Year = {1689}}
+
+@book{Preau1583,
+ Address = {Paris},
+ Author = {Gabriel du Preau},
+ Pagination = {folio},
+ Publisher = {Jacques Keruer},
+ Title = {Histoire de l'Estat et succes de l'Eglise dressee en forme de chronique generalle et universelle},
+ Volume = {1},
+ Year = {1583}}
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdf b/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdf
new file mode 100644
index 00000000000..630bd915899
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.tex b/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.tex
new file mode 100644
index 00000000000..e60ce1f2d42
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.tex
@@ -0,0 +1,14 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage{handout}
+
+\begin{document}
+
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{txt/Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdf b/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdf
new file mode 100644
index 00000000000..b72160a5022
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.tex b/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.tex
new file mode 100644
index 00000000000..bce2792d571
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.tex
@@ -0,0 +1,16 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\begin{document}
+
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{txt/Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdf b/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdf
new file mode 100644
index 00000000000..6a997975df0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.tex b/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.tex
new file mode 100644
index 00000000000..de1b979f56c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.tex
@@ -0,0 +1,20 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage[dir=txt]{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\begin{document}
+
+L'historien catholique Gabriel du Preau ce sert de l'épisode lorsqu'il est question de Matthieu:
+\handout{Preau1583.tex}
+Des commentaires sur ce passage
+
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdf b/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdf
new file mode 100644
index 00000000000..d77e46d6fed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.tex b/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.tex
new file mode 100644
index 00000000000..fc667e9c646
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.tex
@@ -0,0 +1,22 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage[dir=txt,sectioning]{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\begin{document}
+
+\section{Au temps des guerre de religions}
+L'historien catholique Gabriel du Preau ce sert de l'épisode lorsqu'il est question de Matthieu:
+\handout{Preau1583.tex}
+Des commentaires sur ce passage
+
+\section{Les conflits autour de l'œuvre de Richard~Simon}
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdf b/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdf
new file mode 100644
index 00000000000..e3c4f3be779
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.tex b/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.tex
new file mode 100644
index 00000000000..09633659e76
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.tex
@@ -0,0 +1,24 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage[dir=txt,sectioning,numbering]{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\begin{document}
+
+\section{Au temps des guerre de religions}
+L'historien catholique Gabriel du Preau ce sert de l'épisode lorsqu'il est question de Matthieu:
+\handout{Preau1583.tex}
+Des commentaires sur ce passage
+
+Mais notre auteur dispose aussi de l'œuvre de Nicéphore Calliste Xanthopoulos. C'est pourquoi il duplique notre évangile retrouvé:
+\handout{Preau1583b}
+Des commentaires sur ce passage
+\section{Les conflits autour de l'œuvre de Richard~Simon}
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdf b/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdf
new file mode 100644
index 00000000000..b2c9c8a5852
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.tex b/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.tex
new file mode 100644
index 00000000000..21be851ecfb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.tex
@@ -0,0 +1,24 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\setmainlanguage{french}
+\usepackage[dir=txt,sectioning,numbering]{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\begin{document}
+
+\section{Au temps des guerre de religions}
+L'historien catholique Gabriel du Preau ce sert de l'épisode lorsqu'il est question de Matthieu:
+\handout{Preau1583-not-and-only.tex}
+Des commentaires sur ce passage
+
+Mais notre auteur dispose aussi de l'œuvre de Nicéphore Calliste Xanthopoulos. C'est pourquoi il duplique notre évangile retrouvé:
+\handout{Preau1583b}
+Des commentaires sur ce passage
+\section{Les conflits autour de l'œuvre de Richard~Simon}
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit:
+\handout{Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdf b/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdf
new file mode 100644
index 00000000000..e2f6d050498
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.tex b/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.tex
new file mode 100644
index 00000000000..c7d083752e9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.tex
@@ -0,0 +1,42 @@
+\documentclass[a4paper]{article}
+\usepackage{polyglossia,fontspec}
+\usepackage[style=verbose-trad2]{biblatex}
+\bibliography{example}
+\setmainlanguage{french}
+\usepackage[dir=txt,sectioning,numbering]{handout}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}%
+}
+
+\newcommand{\citehandout}{%
+ \AtNextCitekey{%
+ \forhandout{%
+ \beforehandoutref%
+ }%
+ \forhandout{%
+ \cite[\strfield{postnote}]{\strfield{entrykey}}%
+ }%
+ \forhandout{%
+ \afterhandoutref%
+ }%
+ }%
+}
+\newcommand{\beforehandoutref}{\par\noindent\hspace{-2\parindent}}
+\newcommand{\afterhandoutref}{\par\vskip0.25\baselineskip}
+\begin{document}
+
+\section{Au temps des guerre de religions}
+L'historien catholique Gabriel du Preau ce sert de l'épisode lorsqu'il est question de Matthieu\citehandout\footcite[33]{Preau1583}:
+\handout{Preau1583-not-and-only.tex}
+Des commentaires sur ce passage
+
+Mais notre auteur dispose aussi de l'œuvre de Nicéphore Calliste Xanthopoulos. C'est pourquoi il duplique notre évangile retrouvé\citehandout\footcite[194]{Preau1583}:
+\handout{Preau1583b}
+Des commentaires sur ce passage
+\section{Les conflits autour de l'œuvre de Richard~Simon}
+Dans son \emph{Histoire critique du texte du Nouveau Testament}, Richard~Simon écrit\citehandout\footcite[45]{Simon1689}:
+\handout{Richard_Simon_NT.tex}
+Des commentaires sur ce passage.
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/handout/examples/latexmkrc b/Master/texmf-dist/doc/latex/handout/examples/latexmkrc
new file mode 100644
index 00000000000..f69e7ab8f79
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/latexmkrc
@@ -0,0 +1,2 @@
+$pdflatex = "xelatex";
+$pdf_mode = "1";
diff --git a/Master/texmf-dist/doc/latex/handout/examples/makefile b/Master/texmf-dist/doc/latex/handout/examples/makefile
new file mode 100644
index 00000000000..aa7ef50a164
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/makefile
@@ -0,0 +1,5 @@
+all: *tex *bib
+ latexmk *tex
+
+clean:
+ @$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz* *fls *.handout
diff --git a/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583-not-and-only.tex b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583-not-and-only.tex
new file mode 100644
index 00000000000..2930a23ef2f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583-not-and-only.tex
@@ -0,0 +1,4 @@
+
+\begin{quotation}
+L'an 42. l'Evangeliste S.~Matthieu escrivit son Evangile en Hebreu au païs de Iudee: qui ayant esté long temps caché, fut par luy mesme reuelé\footnote{\nothandout{Note non présente dans l'exemplier.}\onlyhandout{Note seulement présente dans l'exemplier.}} \& trouvé du temps de l'Empereur Zenon, comme nous verrons en son lieu.
+\end{quotation}
diff --git a/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583.tex b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583.tex
new file mode 100644
index 00000000000..19a8483b907
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583.tex
@@ -0,0 +1,4 @@
+
+\begin{quotation}
+L'an 42. l'Evangeliste S.~Matthieu escrivit son Evangile en Hebreu au païs de Iudee: qui ayant esté long temps caché, fut par luy mesme reuelé \& trouvé du temps de l'Empereur Zenon, comme nous verrons en son lieu.
+\end{quotation}
diff --git a/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583b.tex b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583b.tex
new file mode 100644
index 00000000000..398f79bf4c9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/txt/Preau1583b.tex
@@ -0,0 +1,4 @@
+
+\begin{quotation}
+Aussi durant son Empire, fut trouvé en Cypre souz un arbre, que l'on nomme Silique, le corps de S.~Barnabé Apostre, sur l'estomach duquel estoit le sainct \& sacré Evangile de l'Evangeliste sainct Matthieu, escrit de la propre main d'iceluy S.~Barnabé. A cause dequoy les Cypriens deslors commencerent d'avoir leur ville capitale Salamine franche \& libre: \& ne furent de là en avant contraincts de porter leur denombrement \& declaration en Antioche, comme ils fouloient faire au precedent. Iustinian puis apres confirma d'avantage leurs droicts, privileges \& franchises, à cause que Theodose sa femme estoit du pays de Cypre: comme luy mesme aussi porta grand honneur à sa ville Achride Iustiniane la premiere.
+\end{quotation} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/handout/examples/txt/Richard_Simon_NT.tex b/Master/texmf-dist/doc/latex/handout/examples/txt/Richard_Simon_NT.tex
new file mode 100644
index 00000000000..662185768ee
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/examples/txt/Richard_Simon_NT.tex
@@ -0,0 +1,4 @@
+
+\begin{quotation}
+Mr.~le~Moine habile Protestant \& savant dans les langues Orientales, nous assûre qu'il étoit écrit en Ebreu, parce que Saint~Barnabé qui l'avoit décrit pour son usage étoit Juif de naissance, \& prêchoit à ceux de sa nation. Mais il y a plus d'apparence qu'Anthime qui n'étoit pas Juif en supposa un grec ; \& il n'est gueres croyable qu'on l'eust lû publiquement dans l'Eglise de Constantinople, s'il eût été écrit en Ebreu.
+\end{quotation} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/handout/handout.pdf b/Master/texmf-dist/doc/latex/handout/handout.pdf
new file mode 100644
index 00000000000..21acf21a316
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/handout.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/handout/handout.tex b/Master/texmf-dist/doc/latex/handout/handout.tex
new file mode 100644
index 00000000000..fbef47d9215
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/handout.tex
@@ -0,0 +1,174 @@
+\documentclass{ltxdockit}[2011/03/25]
+\usepackage{btxdockit}
+\usepackage{fontspec}
+\usepackage[mono=false]{libertine}
+\usepackage{microtype}
+\usepackage[american]{babel}
+\usepackage[strict]{csquotes}
+\setmonofont[Scale=MatchLowercase]{DejaVu Sans Mono}
+\usepackage{shortvrb}
+\usepackage{pifont}
+\usepackage{minted}
+\usepackage{bidi}
+% Meta-datas
+\titlepage{%
+ title={Handout's making},
+ subtitle={to prepare your speech},
+ email={maieul <at> maieul <dot> net},
+ author={Maïeul Rouquette},
+ revision={1.0.0},
+ date={20/03/2014},
+ url={https://github.com/maieul/handout}}
+
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+\section{Introduction}
+\subsection{Goal}
+
+In some fields of schol­ar­ship, a beamer does not of­fer good sup­port when giv­ing a talk in a pro­ceed­ing. For ex­am­ple, in clas­si­cal philol­ogy, the main sources are text, and it will be bet­ter to dis­tribute a hand­out to the au­di­ence with ex­tracts of the texts about which we will talk.
+
+The pack­age sup­ports prepa­ra­tion of such hand­outs when writ­ing the talk.
+
+\subsection{Credits}
+
+This package was created for Maïeul Rouquette's PHD\footnote{\url{http://apocryphes.hypothese.org}.} in 2014. It is licenced on the \emph{\LaTeX\ Project Public Licence}\footnote{\url{http://latex-project.org/lppl/lppl-1-3c.html}.}.
+
+All issues can be submitted, in French or English, in the GitHub issues page\footnote{\url{https://github.com/maieul/handout/issues}.}.
+
+\subsection{French tutorial}
+
+As the idea of the package behavior was send by French \LaTeX\ users\footnote{\url{http://fr.comp.text.tex.narkive.com/pXMop2kE/fabrication-d-un-exemplier}.}, and as the package's author has French as native language, a French tutorial is available in \url{http://geekographie.maieul.net/136}.
+
+All files in the examples' folder are in French, but that should not have consequence for the meaning of their behaviors. They have to be run with \XeLaTeX.
+
+
+\section{Basis}
+
+The package can be loaded very quickly with the standard command \cs{usepackage}
+
+\begin{minted}{tex}
+\usepackage{handout}
+\end{minted}
+The idea of the this package is to prepare handout during the writing of the paper. When you want to add something in your handout, just write it on an external file, and call this external file with the command \cs{handout} :
+
+\begin{minted}{tex}
+Your text
+\handout{folder/example}
+Your text
+\end{minted}
+
+The PDF output will contain two parts:
+\begin{enumerate}
+ \item Your paper.
+ \item The handout.
+\end{enumerate}
+
+You have just to split your pdf in two parts to obtain your handout for auditors.
+See example~1.
+
+\section{Code to be run at the beginning of the handout}
+
+You can execute any code at the beginning of the handout by defining a command \cmd{beforehandout}. For example, to suppress extra margins of the \env{quotation} environment:
+\begin{minted}{tex}
+\newcommand{\beforehandout}{%
+ \renewenvironment{quotation}{}{}
+}
+\end{minted}
+See example~2.
+
+Note that the package always do some action before the handout:
+\begin{itemize}
+ \item Start a new page.
+ \item Reset page and footnote.
+ \item Disable \cmd{index} and \cmd{label} command.
+\end{itemize}
+\section{Putting all the example's files in a same folder}
+
+In most cases, your file will be put in the same folder. So you can fix this folder with the package's option \opt{dir}:
+\begin{minted}{tex}
+\usepackage[dir=folder]{handout}
+...
+Your text
+\handout{example}
+Your text
+\end{minted}
+
+See example~3.
+
+\section{Recopying the sectioning commands in the handout}
+
+If you want your handout be organized with the same sectioning commands as your main paper, you can use the option \opt{sectioning} when loading the package. See example~4.
+
+\section{Numbering the examples}
+
+The package option \opt{numbering} automatically numbers the examples. The example's number is by default printed in margin, in a frame. See example~5.
+
+To customize number's presentation, you can redefine three commands:
+\begin{enumerate}
+ \item \cmd{thehandoutnumber} to redefine the way the number is displayed. Standard is:
+\begin{minted}{tex}
+\renewcommand{\thehandoutnumber}{\fbox{\arabic{handoutnumber}}}
+\end{minted}
+See \LaTeX\ documentation on counter's appearance.
+ \item \cmd{handoutnumber} to redefine the position of the number. Standard is :
+\begin{minted}{tex}
+\newcommand{\handoutnumber}[1]{\marginpar{#1}}
+\end{minted}
+ \item \cmd{handoutnumberintxt}, to redefine the position of the number in the main text. Standard is:
+\begin{minted}{tex}
+\newcommand{\handoutnumberintxt}[1]{\handoutnumber{#1}}
+\end{minted}
+\end{enumerate}
+
+\section{Temporarily disabling the handout generation}
+
+The package's option \opt{disabled} allows to disable the handout generation.
+
+\section{Advanced use}
+\subsection{Conditional code}
+
+The argument of a \cmd{onlyhandout} command will be printed only in the handout. Conversely, the argument of a command \cmd{nothandout} will printed only in the main text. See example~6.
+
+\subsection{Insert code in the handout}
+
+The argument of the \cmd{forhandout} command will be add in the handout, even if called outside a included file.
+
+\emph{Be careful} : if the content of the argument start by a command, this command won't be run before the handout.
+
+The \cmd{forhandout} command is quite complexe to manage, but can be useful if you want to insert automatically bibliographic reference in your handout. If you use \emph{biblatex} to manage bibliography, you can define a \cmd{citehandout} command this code :
+
+\begin{minted}{tex}
+\newcommand{\citehandout}{%
+ \AtNextCitekey{%
+ \forhandout{%
+ \beforehandoutref%
+ }%
+ \forhandout{%
+ \cite[\strfield{postnote}]{\strfield{entrykey}}%
+ }%
+ \forhandout{%
+ \afterhandoutref%
+ }%
+ }%
+}
+\newcommand{\beforehandoutref}{\par\noindent\hspace{-2\parindent}}
+\newcommand{\afterhandoutref}{\par\vskip0.25\baselineskip}
+\end{minted}
+
+You can call \cmd{citehandout} command before citation commands that you want reference be copied in the handout. See example~7 and the \emph{biblatex} handbook.
+
+Note that the citation tracker is automatically reset at the beginning of the handout.
+
+\section{Change history}
+
+\begin{changelog}
+
+\begin{release}{1.0.0}{2014-03-20}
+\item First public release.
+\end{release}
+\end{changelog}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/handout/latexmkrc b/Master/texmf-dist/doc/latex/handout/latexmkrc
new file mode 100644
index 00000000000..d6cfc714fa5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/latexmkrc
@@ -0,0 +1,2 @@
+$pdflatex = "xelatex --shell-escape %S";
+$pdf_mode = "1";
diff --git a/Master/texmf-dist/doc/latex/handout/makefile b/Master/texmf-dist/doc/latex/handout/makefile
new file mode 100644
index 00000000000..e4e5610c87f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/handout/makefile
@@ -0,0 +1,21 @@
+
+dist: examples handout.tex README *.sty makefile latexmkrc
+ $(RM) ../handout.zip
+ rm -rf handout
+ latexmk handout.tex
+ $(MAKE) -C examples all
+
+ mkdir handout
+ cp *.sty *.tex *.pdf latexmkrc makefile README handout
+
+ mkdir handout/examples
+ cp examples/*pdf examples/*tex examples/*bib examples/latexmkrc examples/makefile handout/examples
+
+ mkdir handout/examples/txt
+ cp examples/txt/*tex handout/examples/txt
+ zip -r ../handout.zip handout
+
+clean:
+ $(MAKE) -C examples clean
+ @$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz* *.pyg
+ rm -rf handout