summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-07-10 21:04:20 +0000
committerKarl Berry <karl@freefriends.org>2021-07-10 21:04:20 +0000
commit722320dd2cb1cb8e3aadc79b015ad958304ff9fd (patch)
tree097d6cb2f4e86e5dc2eb1b2b9fd7c95b5934b081 /Master/texmf-dist/doc/latex
parent3d27c90380ff5a36495684726a02e13a00ab5fe5 (diff)
iexec (10jul21)
git-svn-id: svn://tug.org/texlive/trunk@59891 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/iexec/DEPENDS.txt2
-rw-r--r--Master/texmf-dist/doc/latex/iexec/iexec.pdfbin103987 -> 108202 bytes
-rw-r--r--Master/texmf-dist/doc/latex/iexec/iexec.tex26
3 files changed, 20 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/latex/iexec/DEPENDS.txt b/Master/texmf-dist/doc/latex/iexec/DEPENDS.txt
new file mode 100644
index 00000000000..6645129e89c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/iexec/DEPENDS.txt
@@ -0,0 +1,2 @@
+hard shellesc
+hard xkeyval
diff --git a/Master/texmf-dist/doc/latex/iexec/iexec.pdf b/Master/texmf-dist/doc/latex/iexec/iexec.pdf
index a12a6b9d2b1..044e9bea678 100644
--- a/Master/texmf-dist/doc/latex/iexec/iexec.pdf
+++ b/Master/texmf-dist/doc/latex/iexec/iexec.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/iexec/iexec.tex b/Master/texmf-dist/doc/latex/iexec/iexec.tex
index a61b55178b9..150c8fa8821 100644
--- a/Master/texmf-dist/doc/latex/iexec/iexec.tex
+++ b/Master/texmf-dist/doc/latex/iexec/iexec.tex
@@ -21,13 +21,13 @@
% SOFTWARE.
\documentclass[12pt]{article}
+\usepackage[trace]{iexec}
\usepackage[tt=false,type1=true]{libertine}
\usepackage{multicol}
\usepackage{ffcode}
-\usepackage{iexec}
\title{\ff{iexec}: \LaTeX{} Package \\ for Inputable Shell Executions}
\author{Yegor Bugayenko}
-\date{0.1.0 2021/07/08}
+\date{0.3.0 2021/07/10}
\begin{document}
\pagenumbering{gobble}
\raggedbottom
@@ -43,25 +43,35 @@ document and then put their output to the document:
\setlength{\parskip}{0pt}
\scriptsize
\raggedcolumns
-\begin{verbatim}
+\begin{ffcode}
\documentclass{article}
\usepackage{iexec}
\begin{document}
Today is \iexec{date +\%e-\%b-\%Y}.
\end{document}
-\end{verbatim}
+\end{ffcode}
\columnbreak
Today is \iexec{date +\%e-\%b-\%Y}.
\end{multicols}
-You have to run \ff{pdflatex} with the \ff{--shell-escape} flag
+You have to run \ff{pdflatex} (or just \ff{latex}) with the \ff{--shell-escape} flag
in order to let \ff{ShellEscape} (the package we use) to run shell.
-There are two commands: \ff{\char`\\exec} and \ff{\char`\\iexec}.
-The first one executes, while the second one also inputs the output
-of the execution.
+If you don't want the output to be visible,
+use \ff{\char`\\phantom\char`\{\char`\\iexec\char`\{...\char`\}\char`\}}.
+
+The output of your code is saved into the file provided as the
+second optional argument of \ff{\char`\\iexec} (the default value is \ff{iexec.tmp}):
+
+\begin{ffcode}
+Today is \iexec[date.txt]{date +\%e-\%b-\%Y}.
+\end{ffcode}
+
+The file specified will be deleted right after its usage. If you don't
+want this to happen, use \ff{trace} package option: all files will remain
+in the directory.
More details about this package you can find
in the \ff{yegor256/iexec} GitHub repository.