.\" Manpage for runtexfile.
.\" Contact hvoss@tug.org to correct errors or typos.
.TH runtexfile 1 "18 june 2025" "0.02" "runtexfile man page"
.SH NAME
runtexfile
\- running a LaTeX document and get the command sequence from the document itself
.SH SYNOPSIS
runtexfile [options] <filename>
.SH DESCRIPTION
This command parses comment lines in a latex document which
start with 
%! HV 
and executes the following commands. For example
%! HV lualatex --shell-escape
In this case the <filename> given by the script will be used.

.SH OPTIONS
.IP -h,--help
obvious ... :-)
.IP -V,--version
obvious ... :-)
.IP -v,--verbose  Verbosity level
Give more informations into a log file
.IP <filename> 
Must be the name of the main LaTeX document without the extension
if it is .tex.
.SH EXAMPLES

$ runtexfile test2

.Pp 
runs the testfile test2.tex

.nf
.ft CW
voss>examples:$ runtexfile test2
runtexfile version 0.02
Main file: test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: biber  test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: xindex  test2
Special filename = test2.vwx
running: xindex  --config DIN2 -l DE -o test2.vwd test2.vwx
Special filename = test2.dbx
running: xindex  --config DIN2 -l DE -o test2.dbd test2.dbx
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
.ft R
.fi


.SH See also
See runtexfile-doc.pdf for more details
.SH BUGS
No known bugs.
.SH AUTHOR
Herbert Voß (hvoss@tug.org)
.SH LICENSE
Permission is granted to copy, distribute and/or modify this software
under the terms of the LaTeX Project Public License, version 1.3.