summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/iexec/iexec.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/iexec/iexec.tex')
-rw-r--r--macros/latex/contrib/iexec/iexec.tex26
1 files changed, 18 insertions, 8 deletions
diff --git a/macros/latex/contrib/iexec/iexec.tex b/macros/latex/contrib/iexec/iexec.tex
index a61b55178b..150c8fa882 100644
--- a/macros/latex/contrib/iexec/iexec.tex
+++ b/macros/latex/contrib/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.