multiaudience (3aug15)

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

8 files changed, 245 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/multiaudience/Makefile b/Master/texmf-dist/doc/latex/multiaudience/Makefile
new file mode 100644
index 00000000000..042984e8af7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/Makefile
@@ -0,0 +1,62 @@
+#
+#
+# This file is in public domain
+#
+# $Id: Makefile,v 1.3 2015/08/02 23:00:13 boris Exp $
+#
+
+PACKAGE=multiaudience
+PDF = sample-execs.pdf sample-devs.pdf sample-admins.pdf
+
+
+all:  $(PACKAGE).pdf ${PDF}
+
+%.pdf:  %.dtx   $(PACKAGE).sty
+	pdflatex $<
+	- bibtex $*
+	pdflatex $<
+	- makeindex -s gind.ist -o $*.ind $*.idx
+	- makeindex -s gglo.ist -o $*.gls $*.glo
+	pdflatex $<
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+	do pdflatex $<; done
+
+
+
+
+%.sty:   %.ins %.dtx  
+	pdflatex $<
+
+sample-%.pdf:  sample.tex $(PACKAGE).sty
+	pdflatex -jobname sample-$* "\def\CurrentAudience{$*}\input{sample.tex}"
+	-bibtex sample-$*
+	pdflatex -jobname sample-$* "\def\CurrentAudience{$*}\input{sample.tex}"
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' sample-$*.log) \
+	do pdflatex -jobname sample-$* "\def\CurrentAudience{$*}\input{sample.tex}"; done
+
+
+.PRECIOUS:  $(PACKAGE).cfg $(PACKAGE).sty
+
+
+clean:
+	$(RM) $(PACKAGE).sty  *.log *.aux \
+	*.cfg *.glo *.idx *.toc \
+	*.ilg *.ind *.out *.lof \
+	*.lot *.bbl *.blg *.gls *.hd \
+	*.dvi *.ps *.tgz *.zip *.brf
+
+veryclean: clean
+	$(RM) $(PACKAGE).pdf ${PDF}
+
+distclean: veryclean
+
+#
+# Archive for the distribution. Includes typeset documentation
+#
+archive:  all clean
+	tar -czvf $(PACKAGE).tgz -C .. --exclude '*~' --exclude '*.tgz' --exclude CVS $(PACKAGE)
+
+zip:  all clean
+	${MAKE} $(PACKAGE).sty
+	$(RM) *.log
+	zip -r  $(PACKAGE).zip * -x '*~' -x '*.tgz' -x '*.zip' -x CVS -x 'CVS/*'
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/multiaudience/README b/Master/texmf-dist/doc/latex/multiaudience/README
new file mode 100644
index 00000000000..48e74efbb19
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/README
@@ -0,0 +1,5 @@
+			Mutltiaudience package
+			    Boris Veytsman
+
+The multiaudience package allows to generate several versions of the
+same document for different audiences.
diff --git a/Master/texmf-dist/doc/latex/multiaudience/multiaudience.pdf b/Master/texmf-dist/doc/latex/multiaudience/multiaudience.pdf
new file mode 100644
index 00000000000..ff0d56538f3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/multiaudience.pdf
diff --git a/Master/texmf-dist/doc/latex/multiaudience/sample-admins.pdf b/Master/texmf-dist/doc/latex/multiaudience/sample-admins.pdf
new file mode 100644
index 00000000000..45eaf05b442
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/sample-admins.pdf
diff --git a/Master/texmf-dist/doc/latex/multiaudience/sample-devs.pdf b/Master/texmf-dist/doc/latex/multiaudience/sample-devs.pdf
new file mode 100644
index 00000000000..3c0c46d282d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/sample-devs.pdf
diff --git a/Master/texmf-dist/doc/latex/multiaudience/sample-execs.pdf b/Master/texmf-dist/doc/latex/multiaudience/sample-execs.pdf
new file mode 100644
index 00000000000..6ded1224d69
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/sample-execs.pdf
diff --git a/Master/texmf-dist/doc/latex/multiaudience/sample.tex b/Master/texmf-dist/doc/latex/multiaudience/sample.tex
new file mode 100644
index 00000000000..a2d9960c66e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/sample.tex
@@ -0,0 +1,174 @@
+\documentclass{article}
+\usepackage{multiaudience}
+\SetNewAudience{admins}
+\SetNewAudience{devs}
+\SetNewAudience{execs}
+\usepackage[colorlinks]{hyperref}
+\usepackage{fancyvrb}
+\VerbatimFootnotes
+\begin{document}
+
+\title{Examples of \textsl{multiaudience} package use}
+\date{$ $Date: 2015/07/11 22:49:40 $ $}
+\author{Boris Veytsman}
+\maketitle
+
+\clearpage
+\tableofcontents
+\clearpage
+
+\section{Introduction}
+\label{sec:intro}
+
+We defined three audiences:
+\begin{verbatim}
+\SetNewAudience{admins}
+\SetNewAudience{devs}
+\SetNewAudience{execs}
+\end{verbatim}
+
+
+\section{The \texttt{\textbackslash CurrentAudience} command}
+\label{sec:CurrentAudience}
+
+\begin{verbatim}
+The current audience is \CurrentAudience.
+\end{verbatim}
+
+The current audience is \CurrentAudience.
+
+\section{The \texttt{\textbackslash showto} command}
+\label{sec:showto}
+
+
+Note the nesting here:
+\begin{verbatim}
+\showto{admins}{This text is visible to admins only\footnote{And
+    admins see a footnote}.}
+\showto{admins, devs}{This text is visible to admins and
+  devs. \showto{devs}{This text is visible to devs.}}  
+\showto{-, admins}{This text is \emph{not} visible to admins.}
+This text is visible to everybody\footnote{And everybody sees a
+  footnote}.  
+\end{verbatim}
+
+\showto{admins}{This text is visible to admins only\footnote{And
+    admins see a footnote}.}
+\showto{admins, devs}{This text is visible to admins and
+  devs. \showto{devs}{This text is visible to devs.}}  
+\showto{-, admins}{This text is \emph{not} visible to admins.}
+This text is visible to everybody\footnote{And everybody sees a
+  footnote}.   
+
+\section{The \texttt{shownto} environment}
+\label{sec:env}
+
+\begin{verbatim}
+\begin{shownto}{admins}
+  This is for admins only.
+\end{shownto}
+\end{verbatim}
+
+\begin{shownto}{admins}
+  This is for admins only.
+\end{shownto}
+
+
+\begin{verbatim}
+\begin{shownto}{-, admins}
+  This is for everybody \emph{but} admins.
+\end{shownto}
+\end{verbatim}
+
+\begin{shownto}{-, admins}
+  This is for everybody \emph{but} admins.
+\end{shownto}
+
+
+\section{Use of verbatim text}
+\label{sec:verbatiom}
+
+
+
+\begin{verbatim}
+\begin{shownto}{-,execs}
+We cannot use \texttt{verbatim} inside shownto, but we can use
+\texttt{input} with \texttt{verbatim} inside.
+
+
+We also can use \texttt{path} and \texttt{url} from hyperref package:
+\path{a$2}, \url{http://borisv.lk.net/cv/cv.html\#Publications}. 
+\input{verbatim}
+
+We also can use \texttt{path} and \texttt{url} from hyperref package:
+\path{a$2}, \url{http://borisv.lk.net/cv/cv.html\#Publications}. 
+\end{shownto}
+\end{verbatim}
+
+\begin{shownto}{-,execs}
+We cannot use \texttt{verbatim} inside shownto, but we can use
+\texttt{input} with \texttt{verbatim} inside.
+
+
+We also can use \texttt{path} and \texttt{url} from hyperref package:
+\path{a$2}, \url{http://borisv.lk.net/cv/cv.html\#Publications}. 
+\input{verbatim}
+\end{shownto}
+
+Another option is the use of \verb|\SaveVerb| and friends from
+\textsl{fancyvrb} package:
+
+\begin{verbatim}
+\begin{SaveVerbatim}{SavedVerb}
+This is a verbatim line: ~!@#$%^&*{}:"`'<>?  
+\end{SaveVerbatim}
+
+\begin{shownto}{-,devs}
+  \UseVerbatim{SavedVerb}
+\end{shownto}
+\end{verbatim}
+
+\begin{SaveVerbatim}{SavedVerb}
+This is a verbatim line: ~!@#$%^&*{}:"`'<>?  
+\end{SaveVerbatim}
+
+\begin{shownto}{-,devs}
+  \UseVerbatim{SavedVerb}
+\end{shownto}
+
+\section{Syntactic sugar}
+\label{sec:sugar}
+
+\begin{verbatim}
+We have a special footnote command\Footnote{admins}{This footnote is
+  for admins only.}.
+\end{verbatim}
+
+We have a special footnote command\Footnote{admins}{This footnote is
+  for admins only.}.
+
+\begin{verbatim}
+\begin{Subsection}{admins}[Admins-only subsection]{This subsection is
+    visible only to admins}
+We have special sectioning commands.  
+\end{Subsection}
+\end{verbatim}
+
+\begin{Subsection}{admins}[Admins-only subsection]{This subsection is
+    visible only to admins}
+We have special sectioning commands.  
+\end{Subsection}
+
+\begin{verbatim}
+\begin{Subsection}{-,admins}[Not for admins]{This subsection is not
+    visible to admins}
+  Another example.  \showto{devs}{This is visible to devs only.}
+\end{Subsection}
+\end{verbatim}
+
+\begin{Subsection}{-,admins}[Not for admins]{This subsection is not
+    visible to admins}
+  Another example.  \showto{devs}{This is visible to devs only.}
+\end{Subsection}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/multiaudience/verbatim.tex b/Master/texmf-dist/doc/latex/multiaudience/verbatim.tex
new file mode 100644
index 00000000000..261ba541418
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/multiaudience/verbatim.tex
@@ -0,0 +1,4 @@
+\begin{verbatim}
+This is a piece of verbatim text.
+Special symbols: ~!@#$%^&*<>{}"
+\end{verbatim}
\ No newline at end of file