summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-05-05 22:50:09 +0000
committerKarl Berry <karl@freefriends.org>2017-05-05 22:50:09 +0000
commitaf94f399b2a355396d222eb693423beb6294a683 (patch)
tree4c2210f7e726a226b6479a7ab3b99b036f2ac377 /Master/texmf-dist/doc/support
parent8f155cad2caac2649a6e16f1e2944998bced1975 (diff)
texosquery (5may17)
git-svn-id: svn://tug.org/texlive/trunk@44216 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/texosquery/CHANGES13
-rw-r--r--Master/texmf-dist/doc/support/texosquery/README.md36
-rw-r--r--Master/texmf-dist/doc/support/texosquery/texosquery.pdfbin490471 -> 499507 bytes
3 files changed, 47 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/support/texosquery/CHANGES b/Master/texmf-dist/doc/support/texosquery/CHANGES
index eae2c455b22..4c143633004 100644
--- a/Master/texmf-dist/doc/support/texosquery/CHANGES
+++ b/Master/texmf-dist/doc/support/texosquery/CHANGES
@@ -1,3 +1,16 @@
+1.4 (2017/05/05):
+
+ * The fallback value for 'openin_any' for texosquery-jre8
+ is now 'a' if unset.
+
+ * Added clearer instructions in texosquery.cfg and information
+ messages to the transcript.
+
+ * Added \TeXOSQueryFromFile.
+
+ * Shortcut commands only use quotes to delimit arguments
+ in the unrestricted mode.
+
1.3 (2017/03/31):
* If 'openin_any' hasn't been set, the fallback value for
diff --git a/Master/texmf-dist/doc/support/texosquery/README.md b/Master/texmf-dist/doc/support/texosquery/README.md
index c9f883ee00b..ce37682eddb 100644
--- a/Master/texmf-dist/doc/support/texosquery/README.md
+++ b/Master/texmf-dist/doc/support/texosquery/README.md
@@ -38,6 +38,36 @@ temporarily changed to 12 while reading the result. Some of the
`texosquery` output contains short markup commands (such as `\wrp`)
which are internally converted within `\TeXOSQuery`.
+## Important Notes
+
+The TeX code uses a piped shell escape to capture the result from
+`texosquery`. This means that you must have the piped shell escape
+enabled to make use of this feature. MiKTeX users need the
+`--enable-pipes` option on the TeX command line to enable this.
+The alternative is to run `texosquery` outside of TeX and
+capture the output in a temporary file, which can then be
+read using `\TeXOSQueryFromFile`.
+
+You need to correctly set up the configuration file `texosquery.cfg`
+to match your system. The TeX package managers can't do this for you
+automatically. Copy the file to either your `TEXMFHOME` or
+`TEXMFLOCAL` tree to prevent it from being overwritten by subsequent
+updates.
+
+`texosquery-jre8` is on the restricted list for TeX Live 2017. To
+take advantage of this, you must have at least Java 8 installed and
+edit the `texosquery.cfg` file to:
+```tex
+\def\TeXOSInvokerName{texosquery-jre8}
+\TeXOSQueryAllowRestricted
+```
+(Note that the second line above has been uncommented.)
+
+Note that due to TeX's security measures, quotes can't be used in the
+restricted mode's shell escape. This means that if you need to pass
+a file name containing a space as an argument to `texosquery`,
+you'll have to use the unrestricted mode.
+
## Installation
Installation is best done using your TeX package manager.
@@ -282,9 +312,11 @@ or a security exception.)
## Security
As from version 1.2, all variants of `texosquery` (JRE5, 7 and 8)
-obey TeX's `openin_any` setting. Any of the actions that involve
+obey TeX Live's `openin_any` setting. Any of the actions that involve
reading file information won't work if read access is forbidden by
-`openin_any` or by the operating system.
+`openin_any` or by the operating system. MiKTeX doesn't use the
+`openin_any` setting, so if not set `texosquery` will assume `a`
+(any).
In addition to obeying `openin_any`, the file listing actions (such
as `--list`) for the JRE7 and 8 variants also prohibit listing the
diff --git a/Master/texmf-dist/doc/support/texosquery/texosquery.pdf b/Master/texmf-dist/doc/support/texosquery/texosquery.pdf
index 7cb09b482af..92b576339ee 100644
--- a/Master/texmf-dist/doc/support/texosquery/texosquery.pdf
+++ b/Master/texmf-dist/doc/support/texosquery/texosquery.pdf
Binary files differ