summaryrefslogtreecommitdiff
path: root/support/l3sys-query/l3sys-query.1
blob: 41c4127633b68ca63d994d401647a6eefdebf77a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
.TH L3SYS-QUERY 1 "2024-04-03" "LaTeX"

.SH NAME
l3sys-query

.SH SYNOPSIS
 Usage l3sys-query <cmd> [<options>] [<args>]

.SH DESCRIPTION

The l3sys-query script provides a method for TeX runs to obtain system
information via shell escape to Lua. The facilities are more limited than the
similar Java script texosquery, but since it uses Lua, l3sys-query can be
used 'out of the box' with any install TeX system. The script is written taking
account of TeX Live security requirement; it is therefore suitable for use with
restricted shell escape, the standard setting when installing a TeX system.

.SH COMMANDS
Valid <cmd>s are:
   ls  Prints a listing based on the <args> and <options>
   pwd Prints the present working directory

.SH OPTIONS
Valid <options> are:
   --exclude        [<xarg>] Exclude entries from directory listing
   --help|-h        Prints this message and exits
   --ignore-case    Ignore case when sorting directory listing
   --pattern|-p     Treat (x)args as a Lua pattern
   --recursive|-r   Activates recursive directory listing
   --reverse        Reversing sorting order
   --sort           [name|date] Method used to sort directory listing
   --type           [d|f] Select just the directories or files in a listing
   --version|-v     Prints version information and exits

.SH "SEE ALSO"
Full manual available via 'texdoc l3sys-query'.

Repository : https://github.com/latex3/l3sys-query

Bug tracker: https://github.com/latex3/l3sys-query/issues

.SH AUTHORS
Copyright (C) 2024 The LaTeX Project