summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/texosquery/CHANGES
blob: 4cc0c383bcec9273665bfdc02701c76ae0c68076 (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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
1.2.1 (2017/03/28):

 * Minor bug fix in texosquery.tex (fixed decimal separator
   for numeric patterns with all # in the fractional part)

1.2 (2017/03/23):

 * Now has three .jar files depending on the Java installation:

   - texosquery-jre8.jar

     Full application. May be used with the CLDR locale provider
     (Unicode Consortium's Common Locale Data Repository).
     Requires at least Java 8 (use with
     java -Djava.locale.providers=CLDR,JRE or
     add "java.locale.providers=CLDR,JRE" to the 
     JAVA_TOOLS_OPTIONS environment variable to access the CLDR)

   - texosquery.jar

     The default version of the application. Can't be used with
     CLDR. Less locale support. Requires at least Java 7.

   - texosquery-jre5.jar

     Cut-down version of the application with significantly less
     locale support. Provided for old systems that can't upgrade,
     but not recommended. (Use of Java 5 or 6 is deprecated.)
     Requires at least Java 5.

  * Corresponding scripts that run the appropriate .jar file
    are bundled in texosquery.dtx and extracted using:

    tex texosquery.ins

    - Unix-like (run `chmod +x texosquery*.sh`): 

      texosquery-jre8.sh : runs texosquery-jre8.jar with
      -Djava.locale.providers=CLDR,JRE

      texosquery.sh : runs texosquery.jar

      texosquery-jre5.sh : runs texosquery-jre5.jar

     (I recommend the removal of the '.sh' extension
      for more convenient invocation.)

    - Windows (rename texosquery*.batch to texosquery*.bat):

      texosquery-jre8.bat : runs texosquery-jre8.jar with
      -Djava.locale.providers=CLDR,JRE

      texosquery.bat : runs texosquery.jar

      texosquery-jre5.bat : runs texosquery-jre5.jar

    You can edit these files if additional Java settings
    are required (e.g. -Dfile.encoding=UTF-8). Alternatively
    set the JAVA_TOOLS_OPTIONS environment variable.

  * New texosquery.cfg configuration file. Edit the definition
    of \TeXOSInvokerName to indicate which application you
    need to use. For example, if Java 8 is installed:

    \def\TeXOSInvokerName{texosquery-jre8}

  See the installation section of the manual.

  * New command line switches:

  Actions:

  --bcp47 / -b
  --codeset-lcs / -C
  --locale-data / -D 
  --numeric / -N 
  --date-time / -M
  --time-zones / -Z
  --list-dir / -ld
  --list-regular / -lr
  --filterlist-dir / -fd
  --filterlist-regular / -fr
  --walk / -w

  Options:

  --debug [⟨n⟩]
  --nodebug
  --compatible ⟨n⟩ / -compat ⟨n⟩

  * Actions --list (-i) and --filterlist (-f) now have an
    optional argument to indicate the sort order.

  * When accessing file information, the TEXMF openin_any
    setting is first checked to determine if read access is 
    permitted.

  * Returned values now include some shorthand markup that's
    internally converted when read in by \TeXOSQuery. For
    example "texosquery -n" now returns

    \pdfd \fcln 20161113161156\fpls 00\fcsq 00\fcsq 

    instead of

    D:20161113161156+00'00'

    To restore the original behaviour use --compatible 1

    See the manual for further details.

1.1 (2016-07-14):

 * texosquery.jar:

   - Added --dirname (-e)

   - Multiline results add braces to each line
     (to make it easier to parse the results in TeX).

   - Code refactored.

   - Code now compiled for Java 5 to support users with 
     old versions of the JRE.

 * texosquery.tex:

   - \TeXOSQueryNow and \TeXOSQueryFileDate set the category
     code of D to 12 (to match \pdfcreationdate).

   - new command \TeXOSQueryDirName

   - dry run mode is now by default on unless shell escape=1
     (unrestricted mode)

1.0 (2016-07-08):

 * Initial release