summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/multiaudience
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-08-03 22:04:47 +0000
committerKarl Berry <karl@freefriends.org>2015-08-03 22:04:47 +0000
commitb1bd2dbbfd4d6be2af62246fa1889e5470fd45f0 (patch)
treeff57789c1f0477df6b98c02c3c62253e577ef469 /Master/texmf-dist/doc/latex/multiaudience
parent8861879f68d110b9c3cbb9b4153c28e5e3799b9d (diff)
multiaudience (3aug15)
git-svn-id: svn://tug.org/texlive/trunk@38035 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/multiaudience')
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/Makefile62
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/README5
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/multiaudience.pdfbin0 -> 267154 bytes
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/sample-admins.pdfbin0 -> 144175 bytes
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/sample-devs.pdfbin0 -> 149651 bytes
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/sample-execs.pdfbin0 -> 148195 bytes
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/sample.tex174
-rw-r--r--Master/texmf-dist/doc/latex/multiaudience/verbatim.tex4
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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