Package: texlive-base Version: 2022.20230122-3 Severity: wishlist Tags: patch
Dear Maintainer,
I've created a manual page for simpdftex. Consider to include
it into our package.
Hilmar
-- Package-specific info:
IMPORTANT INFORMATION: We will only consider bug reports concerning
the packaging of TeX Live as relevant. If you have problems with
combination of packages in a LaTeX document, please consult your
local TeX User Group, the comp.text.tex user group, the author of
the original .sty file, or any other help resource.
In particular, bugs that are related to up-upstream, i.e., neither
Debian nor TeX Live (upstream), but the original package authors,
will be closed immediately.
*** The Debian TeX Team is *not* a LaTeX Help Desk ***
If you report an error when running one of the TeX-related binaries
(latex, pdftex, metafont,...), or if the bug is related to bad or wrong
output, please include a MINIMAL example input file that produces the
error in your report.
Please run your example with
(pdf)latex -recorder ...
(or any other program that supports -recorder) and send us the generated
file with the extension .fls, it lists all the files loaded during
the run and can easily explain problems induced by outdated files in
your home directory.
Don't forget to also include minimal examples of other files that are
needed, e.g. bibtex databases. Often it also helps
to include the logfile. Please, never send included pictures!
If your example file isn't short or produces more than one page of
output (except when multiple pages are needed to show the problem),
you can probably minimize it further. Instructions on how to do that
can be found at
http://www.minimalbeispiel.de/mini-en.html (english)
or
http://www.minimalbeispiel.de/mini.html (german)
##################################
minimal input file
##################################
other files
######################################
List of ls-R files
lrwxrwxrwx 1 root root 31 Apr 9 2023 /usr/share/texlive/texmf-dist/ls-R ->
/var/lib/texmf/ls-R-TEXLIVEDIST
######################################
Config files
-rw-r--r-- 1 root root 475 Mar 17 22:43 /etc/texmf/web2c/texmf.cnf
lrwxrwxrwx 1 root root 33 Apr 9 2023 /usr/share/texmf/web2c/fmtutil.cnf ->
/var/lib/texmf/fmtutil.cnf-DEBIAN
lrwxrwxrwx 1 root root 32 Apr 9 2023 /usr/share/texmf/web2c/updmap.cfg ->
/var/lib/texmf/updmap.cfg-DEBIAN
-rw-r--r-- 1 root root 2738 Mar 17 22:45
/var/lib/texmf/tex/generic/config/language.dat
######################################
Files in /etc/texmf/web2c/
total 8
-rw-r--r-- 1 root root 283 Apr 1 2019 mktex.cnf
-rw-r--r-- 1 root root 475 Mar 17 22:43 texmf.cnf
######################################
md5sums of texmf.d
ca40c66f144b4bafc3e59a2dd32ecb9c /etc/texmf/texmf.d/00debian.cnf
-- System Information:
Debian Release: 12.5
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 'stable')
Architecture: arm64 (aarch64)
Foreign Architectures: armhf
Kernel: Linux 6.6.28+rpt-rpi-v8 (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_CRAP
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
Versions of packages texlive-base depends on:
ii debconf [debconf-2.0] 1.5.82
ii libpaper-utils 1.1.29
ii sensible-utils 0.0.17+nmu1
ii tex-common 6.18
ii texlive-binaries 2022.20220321.62855-5.1+deb12u1
ii ucf 3.0043+nmu1
ii xdg-utils 1.1.3-4.1
Versions of packages texlive-base recommends:
pn lmodern <none>
Versions of packages texlive-base suggests:
ii ghostscript [postscript-viewer] 10.0.0~dfsg-11+deb12u3
pn perl-tk <none>
pn xpdf | pdf-viewer <none>
pn xzdec <none>
Versions of packages tex-common depends on:
ii ucf 3.0043+nmu1
Versions of packages tex-common suggests:
ii debhelper 13.11.4
Versions of packages texlive-base is related to:
ii tex-common 6.18
ii texlive-binaries 2022.20220321.62855-5.1+deb12u1
-- debconf information excluded
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH SIMPDFTEX "1" "April 2024" "" ""
.SH NAME
simpdftex \- is a way to do pdf{e}{la}tex without having pdf{e}{la}tex
.SH SYNOPSIS
.B simpdftex
\fI\,formatname \/\fR[\fI\,--mode modestring\/\fR]
.SH DESCRIPTION
This is simpdftex, 20221012
.IP
[\-\-dvipsopts dvipsoptstring] [\-\-extradvipsopts dvipsoptstring] [\-\-pdf]
[\-\-default] [\-\-maxpk] [\-\-maxpfb] [\-\-extendedname]
[\-\-no\-echo\-version]
[\-\-tex\-path dir] [\-\-keep\-psfile] [\-\-distiller\-path dir] [\-\-debug]
[\-\-distiller prog] [\-\-distiller\-filter prog] [\-\-distilleropts opts]
[\-\-help] [\-\-outdir dir] [\-\-extratexopts texoptsstring]
[\-\-dvipdfmopts dvipdfmoptstring] tex\-or\-dvi\-file
.PP
simpdftex is a way to do pdf{e}{la}tex without having pdf{e}{la}tex. It needs a
working TeX environment and one of three ways to turn DVI file into PDF:
.IP \[bu]
dvips + a distiller like ghostscript
.IP \[bu]
dvipdfm
.IP \[bu]
dvipdfmx
.PP
Since pdf{e}{la}tex cannot handle insertion of .eps graphics, simpdftex gives an
alternative when using dvips mode. The output for both systems is comparable.
.PP
simpdftex compiles the file with {La}TeX, processes the DVI file with dvips into
PostScript and uses gs to produce pdf (with ps2pdf). Or it uses dvipdfm or
dvipdfmx to turn the DVI file into PDF. There is finegrained control over the
resulting filename and the options with which dvips produces the PostScript
intermediary file.
.PP
Dvips will call Metafont to produce bitmaps or include PostScript .pfb files
depending on the flags. See below.
.PP
The default setting is normal name, maximal use of pfb's, just like pdf{la}tex,
in other words, "pdftex file.tex" and "altpdftex file.tex" both produce an
output file file.pdf. For pdftex, output options are controlled by pdftex.cfg,
for altpdftext by config.ps (unless \fB\-\-pdf\fR is given).
.SS "Arguments:"
.IP
tex\-or\-dvi\-file
.IP
If a .dvi file is given, skip the TeX process. Otherwise, TeX
the input file, dvips the resulting dvi file and ps2pdf the
resulting ps file
.HP
\fB\-\-mode\fR
.IP
Tell simpdftex how to go from DVI to PDF. There are three modes:
\- dvips
\- dvipdfm
\- dvipdfmx
.HP
\fB\-\-dpx\fR
.IP
Compatibility flag with simpdftex_dpmx. Equal to \fB\-\-mode\fR dvipdfmx
.HP
\fB\-\-dpm\fR
.IP
Compatibility flag with simpdftex_dpmx. Equal to \fB\-\-mode\fR dvipdfm
.HP
\fB\-\-help\fR
.IP
Display this message and exit
.HP
\fB\-\-no\-echo\-version\fR
.IP
Do not echo location and version of this script. Does not exit
so can be used to change info to the output of a real run
.HP
\fB\-\-debug\fR
.IP
Add some debug output
.HP
\fB\-\-extendedname\fR
.IP
Depending on the mode, adds intermediary extensions to the
output filename. If the mode is \fB\-\-pdf\fR, .pdfmode is added. If
the mode is \fB\-\-maxpk\fR, ,maxpk is added and if the mode is
\fB\-\-maxpfb\fR, .maxpfb is added. Example:
.IP
tex\-or\-dvi\-file\-basename.maxpfb.pdf
.HP
\fB\-\-maxpk\fR
.IP
Use Metafont bitmaps (pk files) when possible. Only real
PostScript fonts (like Times Roman) are included as
PostScript fonts. All other fonts are included as bitmaps
for the default printer resolution. This options produces
optimal results for the chosen printer.
For file contents (not name) equivalent to:
\fB\-\-dvipsopts\fR "\-Ppk"
Not yet functional for the other modes.
.HP
\fB\-\-maxpfb\fR
.IP
Use PostScript pfb files whenever possible. This produces
optimal results for the screen.
For file contents (not name) equivalent to:
\fB\-\-dvipsopts\fR "\-Poutline"
If any font is included as TeX pk bitmap, it is rendered
at the default resolution.
Not yet functional for the other modes.
.HP
\fB\-\-pdf\fR
.IP
Select .pdfmode extension for the output file name if
\fB\-\-extendedname\fR has been set. Use printer definition
config.pdf. For file contents (not name) equivalent to
\fB\-\-dvipsopts\fR "\-Ppdf"
Note that the default config.pdf assumes resolution 8000
for bitmaps and bitmap generation fails at this resolution
because there exists no known mode for that resolution.
.HP
\fB\-\-default\fR
.IP
Select no extension for the output file name, even if
\fB\-\-extendedfilename\fR has been set. Use standard printer
definition config.ps. For file contents (not name) equivalent
to:
\fB\-\-dvipsopts\fR "" \fB\-\-noextendedname\fR
.HP
\fB\-\-dvipsopts\fR
.IP
Give arbitrary arguments to dvips, e.g.
\fB\-\-dvipsopts\fR "\-M"
Sets extension for \fB\-\-extendedfilename\fR to .custom. \fB\-\-dvipsopts\fR
overrides other flags that set dvipsopts.
.HP
\fB\-\-extratexopts\fR
.IP
Give extra arbitrary arguments to tex, e.g.
\fB\-\-extratexopts\fR "\-\-interaction=nonstopmode"
Sets extra options for the tex command that is used.
.HP
\fB\-\-extradvipsopts\fR
.IP
Give extra arbitrary arguments to dvips, e.g.
\fB\-\-extradvipsopts\fR "\-M"
Sets extra options for dvips and does not set extension
or override other options. Options will be added to the end
of the options for dvips
.HP
\fB\-\-keep\-psfile\fR
.IP
After running dvips, copy the ps file over to the directory
where the tex file is, possibly overwriting a ps file
that is there. Use with caution, a ps file could be input
as well.
.HP
\fB\-\-tex\-path\fR
.IP
Give path of TeX binaries, use directory of this script
otherwise
.HP
\fB\-\-distiller\fR prog
.IP
Use a distiller different from ps2pdf which is the default.
Argument must be an executable or executable script that
gets called with two arguments: input file (PS) and output
file (PDF). E.g.:
\fB\-\-distiller=\fR/usr/local/alternate/bin/ps2pdf
\fB\-\-distiller\fR=\fI\,pstill\/\fR
Using this flag sets the distiller filter mode to off
This flag only makes sense in dvips mode
.HP
\fB\-\-distiller\-filter\fR prog
.IP
Use a distiller executable or executable script which is
called with the PS input as standard input and which writes
the PDF output to standard output. E.g.:
\fB\-\-distiller\-filter\fR=\fI\,u\-psbuild\/\fR
This flag only makes sense in dvips mode
.HP
\fB\-\-distilleropts\fR optionlist
.IP
special options to pass to the distiller
.HP
\fB\-\-distiller\-path\fR
.IP
Give path needed by the distiller binary. This path is added
to the begin of you PATH environment before the distiller is
run. The reason is that for instance ps2pdf uses the path to
find gs and sets the path to something with \fI\,/sw/bin\/\fP at the
beginning. Thus, installing gs from fink would make
\fI\,/usr/local/bin/ps2pdf\/\fP find another gs than intended. By giving
an empty path, the path is not changed before the distiller
program is run. The default is empty.
This flag only makes sense in dvips mode
.HP
\fB\-\-dvipdfmopts\fR
.IP
Give arbitrary arguments to dvipdfm or dvipdfmx, e.g.
\fB\-\-dvipdfmopts\fR "\-c"
Sets extension for \fB\-\-extendedfilename\fR to .custom. \fB\-\-dvipdfmopts\fR
overrides other flags that set dvipdfmopts.
.HP
\fB\-\-outdir\fR dir
.IP
Write files here *if* our current directory is unwritable. This
mimics the TEXMFOUTPUT environment variable of TeX, but
differently. The current dir becomes the value of \fB\-\-outdir\fR and
the directory where the old current dir is added to TEXINPUTS.
This is more robust for reading and locating files.
You can also set TEXMFOUTPUT instead, but with a disadvantage:
you will be running TeXin the current dir. And you will not be
able to read files in the outdir unless you also adapt
TEXINPUTS.
.IP
The defaults for the distiller are
.IP
Path addition: "/usr/local/bin"
Filter mode: "no"
Program: "ps2pdf \fB\-dCompatibilityLevel\fR=\fI\,1\/\fR.5"
.IP
Later flags override settings of earlier flags.
signature.asc
Description: PGP signature
