From 76d75859475de5b0b64017c9dfc11644a2ece537 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Wed, 23 Aug 2023 03:01:02 +0000
Subject: CTAN sync 202308230300

---
 macros/latex/contrib/hvextern/doc/hvextern.tex | 79 +++++++++++++-------------
 1 file changed, 41 insertions(+), 38 deletions(-)

(limited to 'macros/latex/contrib/hvextern/doc/hvextern.tex')

diff --git a/macros/latex/contrib/hvextern/doc/hvextern.tex b/macros/latex/contrib/hvextern/doc/hvextern.tex
index 7f3e7fcc86..b05f01e14a 100644
--- a/macros/latex/contrib/hvextern/doc/hvextern.tex
+++ b/macros/latex/contrib/hvextern/doc/hvextern.tex
@@ -1,4 +1,4 @@
-%% $Id: hvextern.tex 737 2023-07-03 11:28:45Z herbert $
+%% $Id: hvextern.tex 748 2023-08-22 18:03:42Z herbert $
 \RequirePackage{pdfmanagement-testphase}
 \DeclareDocumentMetadata{}
 \documentclass[ngerman,a4paper,twoside]{article}
@@ -10,11 +10,12 @@
 \usepackage{fancyhdr}
 \pagestyle{fancy}
 \usepackage{hvlogos}
-\usepackage[checkCode]{hvextern}
+\usepackage%[checkCode]
+{hvextern}
 \usepackage{hvindex}
 \usepackage{hvdoctools}
 \usepackage{listings}
-\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX,breaklines}
+\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX,breaklines}  
 \usepackage{xcolor,xspace}
 \usepackage{hyperref}
 
@@ -27,13 +28,15 @@
 \begin{document}
 \title{Writing, running and including the output of external documents 
 from within a main\newline \LaTeX\ document~--v. \hvexternFileversion}
-\author{Herbert Voß \url{herbert@dante.de}\thanks{Thanks to Karl Berry; Rolf Niepraschk}}
+\author{Herbert Voß \url{herbert@dante.de}\thanks{Thanks to Karl Berry; 
+Werner Lemberg; Rolf Niepraschk}}
 \maketitle
 \tableofcontents
 
 %\newpage
 
-\setkeys{hv}{moveToExampleDir,ExampleDir=Exa,showFilename,verbose}
+\setkeys{hv}{%moveToExampleDir,ExampleDir=Exa,
+showFilename,verbose}
 
 
 \clearpage
@@ -106,7 +109,7 @@ outside of the main document and then to insert the output
 we can do this from within this \LuaLaTeX\ document itself. The external document is compiled
 with \XeLaTeX\ and the output is insert as pdf image: 
 \begin{externalDocument}[%
-  compiler=xelatex, inline, force=false, runs=2, grfOptions={height=8pt},%
+  compiler=xelatex, inline, force=true, runs=2, grfOptions={height=8pt},%
   crop, cropmargin=0, cleanup, docType=latex]{voss}
 \documentclass{ctexart}
 \pagestyle{empty}
@@ -122,7 +125,7 @@ shown by the environment \Lenv{externalDocument}.
 \begin{minipage}{.59\linewidth}
 \begin{lstlisting}
 \begin{externalDocument}[
-  compiler=pdflatex,force=false,cleanup]{voss}
+  compiler=pdflatex,force=true,cleanup]{voss}
 \documentclass{standalone}
 %StartVisiblePreamble
 \usepackage{fontenc}
@@ -146,7 +149,7 @@ shown by the environment \Lenv{externalDocument}.
 \end{minipage}
 \begin{minipage}{.39\linewidth}
 \begin{externalDocument}[
-  compiler=pdflatex,force=false,cleanup={log,aux},showFilename=false]{voss}
+  compiler=pdflatex,force=true,cleanup={log,aux},showFilename=false]{voss}
 \documentclass{standalone}
 %StartVisiblePreamble
 \usepackage{fontenc}
@@ -202,7 +205,7 @@ catagory, which is done internally by the package. The complete definition of th
   compiler=python3,
   code,
   ext=py,
-  force=false,
+  force=true,
   docType=py,
   usefancyvrb,
   grfOptions={width=\linewidth}]{python}
@@ -252,7 +255,7 @@ line in the above code shows how it can be done with Python.
 \begin{externalDocument}[
   compiler=python3,
   progpath=/usr/local/bin/,
-  force=false,
+  force=true,
   runs=1,
   code,
   ext=py,
@@ -312,7 +315,7 @@ e.g. \texttt{shiftFN=5ex}.
 
 \begin{externalDocument}[grfOptions={width=0.95\linewidth},
   compiler=xelatex,code,mpwidth=0.6\linewidth,
-  crop,cleanup,force=false,usefancyvrb=false,ext=tex,showFilename=false]{voss}
+  crop,cleanup,force=true,usefancyvrb=false,ext=tex,showFilename=false]{voss}
 \documentclass{article}
 %StartVisiblePreamble
 \usepackage{tikz}
@@ -424,7 +427,7 @@ runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex}
   runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex},
   ,
   verbose,
-  force=false,
+  force=true,
   cleanup={log,aux,toc,bbl,blg},
   code,docType=latex,
   lstOptions={columns=fixed}]{voss}
@@ -463,7 +466,7 @@ the environment \Lenv{externalDocument} is:
 \begin{externalDocument}[
   verbose,
   compiler=java,ext=java,code,
-  force=false,docType=java,includegraphic,
+  force=true,docType=java,includegraphic,
   usefancyvrb,grfOptions={width=0.9\linewidth}]{java}
 import java.awt.Color;
 import java.awt.Graphics;
@@ -594,7 +597,7 @@ to \Lcs{VerbatimInput}. The following example uses
   mpwidth=0.6\linewidth,
   crop,
   cleanup,
-  force=false,
+  force=true,
   docType=latex]{voss}
 \RequirePackage{pdfmanagement-testphase}
 \DeclareDocumentMetadata{}
@@ -642,7 +645,7 @@ The color of the frame is set to the same values, hence not seen. The following
   mpwidth=0.6\linewidth,
   crop,
   cleanup,
-  force=false,
+  force=true,
   usefancyvrb,
   docType=latex]{voss}
 \RequirePackage{pdfmanagement-testphase}
@@ -729,7 +732,7 @@ The following example uses:
 %  mpwidth=0.6\linewidth,
 %  crop,
   cleanup,
-  force=false,
+  force=true,
   frame,
 %  usefancyvrb,
 %  float,
@@ -782,7 +785,7 @@ which is the default. Using a caption and a label are optional.
 %  mpwidth=0.6\linewidth,
   crop,
   cleanup,
-  force=false,
+  force=true,
   usefancyvrb,
   float,
   floatsetting=!ht,
@@ -845,7 +848,7 @@ The follwoing example was created with
 %  mpwidth=0.6\linewidth,
   crop, cropmargin=5,
   cleanup,
-  force=false,
+  force=true,
   frame,
 %  usefancyvrb,
 %  float,
@@ -906,7 +909,7 @@ or \Lkeyval{b}.
   showFilename=false,
   crop,
   cleanup,
-  force=false,
+  force=true,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
 \documentclass{article}
@@ -931,7 +934,7 @@ or \Lkeyval{b}.
   code,
   crop,
   cleanup,
-  force=false,
+  force=true,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
 \documentclass{article}
@@ -957,7 +960,7 @@ or \Lkeyval{b}.
   showFilename=false,
   crop,
   cleanup,
-  force=false,
+  force=true,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
 \documentclass{article}
@@ -983,7 +986,7 @@ or \Lkeyval{b}.
   crop,
   showFilename=false,
   cleanup,
-  force=false,
+  force=true,
   mpwidth=0.5\linewidth,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
@@ -1009,7 +1012,7 @@ or \Lkeyval{b}.
   showFilename=false,
   crop,
   cleanup,
-  force=false,
+  force=true,
   mpwidth=0.5\linewidth,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
@@ -1036,7 +1039,7 @@ or \Lkeyval{b}.
   showFilename=false,
   crop,
   cleanup,
-  force=false,
+  force=true,
   mpwidth=0.5\linewidth,
   aboveskip=0pt,belowskip=0pt,
   docType=latex]{voss}
@@ -1067,7 +1070,7 @@ next  Chinese characters
 \begin{externalDocument}[
   compiler=xelatex, inline, runs=2, grfOptions={height=8pt},
   crop, cropmargin=0, 
-  cleanup, force=false, docType=latex]{voss}%
+  cleanup, force=true, docType=latex]{voss}%
 \documentclass{ctexart}
 \pagestyle{empty}
 \begin{document}
@@ -1083,7 +1086,7 @@ With \Lkeyset{inline} the optional argument \Lkeyword{code} is
 automatically set to false. The next  Chinese characters 
 \begin{externalDocument}[
   compiler=xelatex, inline, runs=2, grfOptions={height=8pt},
-  crop, cropmargin=0, cleanup, force=false, docType=latex]{voss}
+  crop, cropmargin=0, cleanup, force=true, docType=latex]{voss}
 \documentclass{ctexart}
 \pagestyle{empty}
 \begin{document}
@@ -1122,7 +1125,7 @@ sorted digits of the number $A$: $495=954-459$.
 
 
 \begin{externalDocument}[
-  compiler=perl, force=false, docType=pl, ext=pl, includegraphic=false,
+  compiler=perl, force=true, docType=pl, ext=pl, includegraphic=false,
   code, mpwidth=0.6\linewidth]{voss}
 #!/usr/bin/perl
 #
@@ -1177,7 +1180,7 @@ outFile = io.open(shortFN..".txt","w+") -- open external file
 
 
 \begin{externalDocument}[
-  compiler=lua, force=false, docType=lua, ext=lua, includegraphic=false, 
+  compiler=lua, force=true, docType=lua, ext=lua, includegraphic=false, 
   code, usefancyvrb=false,textOptions={basicstyle=\ttfamily\footnotesize},
   shiftFN=6ex]{voss}
 #!/usr/bin/env lua
@@ -1252,7 +1255,7 @@ The following examples uses
   pages=2,
   crop,
   cleanup,
-  force=false,
+  force=true,
   xindex,
   xindexOptions={-l DE --config AU},
   mpwidth=0.6\linewidth,
@@ -1308,7 +1311,7 @@ runsequence={lualatex,biber,{xindex -l de -c AU},lualatex,lualatex}
   frame,
   runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex},
   verbose,
-  force=false,
+  force=true,
   cleanup={log,aux,toc,bbl,blg},
   code,docType=latex,
   lstOptions={columns=fixed}]{voss}
@@ -1348,7 +1351,7 @@ The default is using \Lcs{lstinputlisting} for the printed code sequences.
   pages={1,3},
   frame,compiler=pdflatex,
 %  crop,
-  force=false,runs=2,code,docType=latex,
+  force=true,runs=2,code,docType=latex,
   frame,
   lstOptions={columns=fixed}]{voss}
 %StartVisiblePreamble
@@ -1408,7 +1411,7 @@ it makes no difference using the optional argument \Lkeyword{usefancyvrb} or not
   frame,compiler=pdflatex,
   showFilename,
 %  crop,
-  force=false,runs=2,code,docType=latex,
+  force=true,runs=2,code,docType=latex,
   frame,framesep=0pt,usefancyvrb]{voss}
 %StartVisiblePreamble
 \documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrbook}
@@ -1502,7 +1505,7 @@ other examples, you can set \Lkeyword{showoutput} to false.
   showoutput=false,
   frame,compiler=pdflatex,
   crop,
-  force=false,runs=2,code,docType=latex,
+  force=true,runs=2,code,docType=latex,
   frame,usefancyvrb]{voss}
 %StartVisiblePreamble
 \documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrbook}
@@ -1578,7 +1581,7 @@ Whith this definition and the setting \Lkeyset{docType=ltx} the last example loo
   frame,
   compiler=pdflatex,
   showFilename,
-  force=false,
+  force=true,
   runs=2,code,docType=ltx,
   usefancyvrb]{voss}
 \documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrreprt}
@@ -1642,7 +1645,7 @@ It is already internally defined.
   compiler=mpost,
   showFilename,
 %  crop,
-  force=false,
+  force=true,
   cleanup,
   code,
   docType=mp,
@@ -1678,7 +1681,7 @@ It is already internally defined.
   compiler=tex,
   showFilename,
 %  crop,
-  force=false,
+  force=true,
   code,
   docType=tex,
   ext=tex,]{voss}
@@ -1744,7 +1747,7 @@ not needed. The \texttt{pdf} is directly created.
   compiler=lualatex,
   showFilename,
   crop,
-  force=false,
+  force=true,
   code,
   docType=latex,
   ext=tex,]{voss}
@@ -1786,7 +1789,7 @@ not needed. The \texttt{pdf} is directly created.
   compiler=context,
   showFilename,
   runs=2,
-  force=false, 
+  force=true, 
   code,
   docType=context,
   ext=tex,]{voss}
-- 
cgit v1.2.3

