diff options
author | Karl Berry <karl@freefriends.org> | 2021-11-20 23:01:11 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-11-20 23:01:11 +0000 |
commit | cdb8cc3d9c6117cbec0b6935d177d829073b30fe (patch) | |
tree | 7f0400e0285e8e2cf66fe3d735a18ca872ba14e9 /Master/texmf-dist/doc/man | |
parent | e6136d0b484623d79a0c5dd8fe5ec1e20d970209 (diff) |
scripts xetex-unsafe and xelatex-unsafe, for xetex+pstricks+transparency
git-svn-id: svn://tug.org/texlive/trunk@61101 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/Makefile | 3 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/xelatex-unsafe.1 | 1 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdf | bin | 0 -> 20375 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/xetex-unsafe.1 | 54 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdf | bin | 0 -> 20375 bytes |
5 files changed, 58 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/Makefile b/Master/texmf-dist/doc/man/man1/Makefile index e5691a16ed1..b5aa6c6ee11 100644 --- a/Master/texmf-dist/doc/man/man1/Makefile +++ b/Master/texmf-dist/doc/man/man1/Makefile @@ -200,5 +200,8 @@ man1/xdvipdfmx.man1.pdf: man1/xdvipdfmx.1 man1/dvipdfmx.1 man1/xelatex-dev.man1.pdf: man1/xelatex-dev.1 man1/latex-dev.1 $(MKPDF) +man1/xelatex-unsafe.man1.pdf: man1/xelatex-unsafe.1 man1/xetex-unsafe.1 + $(MKPDF) + man1/xelatex.man1.pdf: man1/xelatex.1 man1/latex.1 $(MKPDF) diff --git a/Master/texmf-dist/doc/man/man1/xelatex-unsafe.1 b/Master/texmf-dist/doc/man/man1/xelatex-unsafe.1 new file mode 100644 index 00000000000..288cbb65307 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/xelatex-unsafe.1 @@ -0,0 +1 @@ +.so man1/xetex-unsafe.1 diff --git a/Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdf b/Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdf Binary files differnew file mode 100644 index 00000000000..b230aa43f14 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xetex-unsafe.1 b/Master/texmf-dist/doc/man/man1/xetex-unsafe.1 new file mode 100644 index 00000000000..0813c8a295a --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/xetex-unsafe.1 @@ -0,0 +1,54 @@ +.TH XETEX-UNSAFE 1 "20 November 2021" +.SH NAME +xetex-unsafe, xelatex-unsafe \- run xe(la)latex unsafely +.SH SYNOPSIS +.B xetex-unsafe +.RI [ xetex-options ] +.B xelatex-unsafe +.RI [ xetex-options ] +.SH DESCRIPTION +\fBxetex-unsafe\fP (\fBxelatex-unsafe\fP) runs XeTeX (XeLaTeX) unsafely; +specifically, using the \fBdvipdfmx-unsafe.cfg\fP configuration file. +.PP +As of TeX Live 2022, doing this is necessary only when running XeTeX on +documents using PSTricks features which require transparency. We strongly +recommend using Lua(La)TeX with PSTricks instead of XeTeX in this case. +.PP +At all costs, avoid using this, or any, unsafe invocation with documents +off the net or that are otherwise untrusted in any way. +.SH WHY? +You might well ask why using transparency features is unsafe in XeTeX. +The answer lies in the implementation history of Ghostscript, starting +as a PostScript interpreter before PDF was invented, when it was +acceptable to abort on an error, whereas with PDF, it must keep going. +The transparency operators, if abused in relation to this error +recovery, can cause internal inconsistencies in Ghostscript's state. +.PP +Thus, to be safe, we must disallow transparency with Ghostscript by +default. The \fBxdvipdfmx\fP backend for XeTeX calls Ghostscript under +certain circumstances, notably when using PSTricks. +\fB(x)dvipdfmx\fP itself is not a PostScript interpreter, which is +exactly what PSTricks requires. +.PP +Thus, to enable transparency, \fBxe(la)tex-unsafe\fP run XeTeX with +arguments to the \fBxdvipdfmx\fP backend (-output-driver="xdvipdfmx -i +dvipdfmx-unsafe.cfg -q -E") to use \fBdvipdfmx-unsafe.cfg\fP, which in +turn tells Ghostscript to enable the transparency operators +(-dALLOWPSTRANSPARENCY). They're disabled by default. +.PP +There have been further complications related to reading from the +filesystem, but as of TL22, these have been solved. The transparency +issue cannot be solved without a different Ghostscript implementation, +and the Ghostscript developers say they have no timeline for this. +.PP +To repeat the above: when using PSTricks and transparency, we strongly +recommend playing it safe and using Lua(La)TeX instead of Xe(La)TeX. +.SH OPTIONS +All command-line arguments except \fB--help\fP and \fB--version\fP are +passed to Xe(La)TeX. +.SH BUGS +For more about XeTeX: https://tug.org/xetex +.PP +For more about PSTricks: https://tug.org/PSTricks +.PP +Email for xe(la)tex-unsafe specifically: https://lists.tug.org/dvipdfmx diff --git a/Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdf b/Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdf Binary files differnew file mode 100644 index 00000000000..e2a09b95539 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdf |