summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-11-20 23:01:11 +0000
committerKarl Berry <karl@freefriends.org>2021-11-20 23:01:11 +0000
commitcdb8cc3d9c6117cbec0b6935d177d829073b30fe (patch)
tree7f0400e0285e8e2cf66fe3d735a18ca872ba14e9 /Master/texmf-dist/doc/man
parente6136d0b484623d79a0c5dd8fe5ec1e20d970209 (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/Makefile3
-rw-r--r--Master/texmf-dist/doc/man/man1/xelatex-unsafe.11
-rw-r--r--Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdfbin0 -> 20375 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/xetex-unsafe.154
-rw-r--r--Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdfbin0 -> 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
new file mode 100644
index 00000000000..b230aa43f14
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/xelatex-unsafe.man1.pdf
Binary files differ
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
new file mode 100644
index 00000000000..e2a09b95539
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/xetex-unsafe.man1.pdf
Binary files differ