Debian Codegraph @

texmf-dist/doc/kpathsea/NEWS

raw
1 $Id: NEWS 77444 2026-01-22 01:51:10Z karl $
2 This file records noteworthy changes. (Public domain.)
3
4 6.4.2 (for TeX Live 2026)
5 * New configuration value texmf_nlink_for_leaf to specify whether the
6 st_nlink=2 (stat member for number of links, only on Unix-ish systems)
7 check is made to decide whether we're in a leaf directory; in the
8 default texmf.cnf, the check is disabled.
9
10 * Configuration value openin_any no longer has any effect; any filename
11 is always considered ok for reading. This is because in practice no
12 value but `a' was ever useful anyway, to the best of anyone's knowledge.
13 (More comments about this in texmf.cnf and tex-file.c.)
14
15 * kpsewhich: add abbreviations all for file type formats that have a
16 space in their names, and "src" as a shorter abbreviation for "source",
17 for completeness. The practical benefit is minimal.
18
19 6.4.1 (for TeX Live 2025, 7 March 2025)
20 * kpsewhich outputs a blank line when a given file cannot be found,
21 if more than one file to search for is specified.
22
23 * A file named ".tex" can no longer be written from TeX; previously this
24 was allowed as a special case. (The LaTeX 2024-11-01 release changes
25 their build process so as not to write it from TeX.)
26
27 6.4.0 (for TeX Live 2024, 10 March 2024)
28 * Support an extended check for safe filenames which also allows
29 TEXMF[SYS]VAR, for Lua(La)TeX; new functions and corresponding
30 kpsewhich options.
31 * Support a new variable TEXMF_OUTPUT_DIRECTORY (alongside the
32 traditional TEXMFOUTPUT), so that subprograms can have access to an
33 --output-directory setting in an engine invocation.
34
35 6.3.5 (for TeX Live 2023, 9 March 2023)
36 * Support guessing input file encodings for Unix-ish platforms, as on
37 Windows; enabled for (e)p(la)tex, pbibtex, mendex.
38
39 6.3.4 (for TeX Live 2022, 21 March 2022)
40 * First return path from kpsewhich -all is now the same as non-all.
41 (Internally, str_list_uniqify retains ordering.)
42
43 6.3.3 (for TeX Live 2021, 23 March 2021)
44 * The library does not emit warnings for unrecognized filenames,
45 leaving it up to the caller.
46 * Double save_size limit to 200,000 for tex4ht, l3regex, etc.
47
48 6.3.2 (for TeX Live 2020, 27 March 2020)
49 * New option --cnf-line for kpsewhich (and tex and mf) to support
50 arbitrary configuration settings on the command line.
51 * Warn about unusual program name qualifiers.
52 * The mktex* programs are no longer maintained or present here, but in
53 TeX Live's Master/texmf-dist/scripts/texlive (with copies in
54 Build/source/texk/texlive/linked_scripts as usual).
55
56 6.3.1 (for TeX Live 2019, 7 April 2019)
57 * kpsewhich --var-value does brace expansion as well as variable and
58 tilde expansion.
59 * The kpathsea_path_search() and related functions always recognize either
60 common path separator (: or ;) when splitting paths into elements.
61 (Before, there were some unusual contexts where this did not happen.)
62
63 6.3.0 (for TeX Live 2018, 14 April 2018)
64 * New configuration value texmf_casefold_search to fall back to
65 case-insensitive search in non-system directories if there is no exact
66 match; only relevant on Unix.
67
68 6.2.3 (for TeX Live 2017, 19 May 2017)
69 * .OTF treated like .otf.
70 * texmf.cnf: mpost removed from default shell_escape_commands.
71 * texmf.cnf: TEXINPUTS.luajitlatex added.
72 * texmf.cnf: default bibtex capacities increased.
73
74 6.2.2 (for TeX Live 2016, 21 May 2016)
75 * gregorio added to default shell_escape_commands.
76
77 6.2.1 (for TeX Live 2015, 21 May 2015)
78 * search path information output with new option --help-formats to kpsewhich,
79 no longer with --help.
80 * install <kpathsea/c-auto.h> in an architecture dependent location
81 and use pkg-config to get the required flags.
82
83 6.2.0 (for TeX Live 2014, 30 May 2013)
84 * mktexlsr outputs normal msgs to stdout instead of stderr.
85 * do not ignore a non-terminated last line of a file.
86 * new texmf.cnf variables SELFAUTOGRANDPARENT, guess_input_kanji_encoding.
87 * Numerous changes for Windows.
88
89 6.1.1 (for TeX Live 2013, 30 May 2013)
90 * just one tree: merge texmf into texmf-dist.
91
92 6.1.0 (for TeX Live 2012, 1 July 2012)
93 * texmf.cnf is found in the great-grandparent's texmf-local,
94 corresponding to the default TeX Live installation.
95 * New formats for .ris, .bltxml.
96 * Merge with W32TeX.
97
98 6.0.1 (for TeX Live 2011, 5 July 2011)
99 * Trailing comments and whitespace omitted from config values.
100 * Add .tlu to type lua suffixes, and .dfont to truetype suffixes.
101 * Prefix program_invocation{,_short}_name with kpse_.
102 * Finally remove kpse_set_progname (deprecated since 1998).
103
104 6.0.0 (for TeX Live 2010, 4 June 2010)
105 * Change xmalloc and friends to use size_t, unfortunately changing the ABI.
106
107 5.0.0 (for TeX Live 2009, 13 October 2009)
108 * Make shared library version and general package version the same.
109 * Make library re-entrant, thus unavoidable binary API changes.
110 * Change build system to Automake.
111
112 3.5.7 (for TeX Live 2008, 8 July 2008)
113 * kpsewhich has new options --all (to report all matches) and --subdir
114 (to limit matches).
115 * more file suffixes (.dtx, et al.) and special files (updmap.cfg, et al.)
116 found automatically.
117 * add basic Lua support.
118 * add 64-bit functions for pdftex.
119 * autoconf support finally modernized.
120
121 3.5.6 (for TeX Live 2006-07, 30 December 2006)
122 * longstanding minor portability/warnings problems.
123
124 3.5.5
125 * Copyrights of some source files were erroneously attributed to FSF.
126 * On Unix, accept the semicolon as well as the colon in environment
127 variables like TEXINPUTS.
128 * Keep metafont from choking on large literals (> 4000) when calling
129 mktexpk.
130
131 3.5.4 (7 March 2005)
132 * Change of some standard environment/texmf.cnf variables:
133 HOMETEXMF -> TEXMFHOME
134 VARTEXMF -> TEXMFVAR
135 TEXMFVAR, TEXMFCONFIG: Always defined for the sake of teTeX 3.0.
136 TEXMFSYSVAR, TEXMFSYSCONFIG: Added for the sake of teTeX 3.0.
137 * mktex*: A new option for MT_FEATURES in mktex.cnf: texmfvar. If
138 selected, files that would be written into a system texmf tree go
139 to the TEXMFVAR tree. Overriden by varfonts.
140
141 3.5.3 (28 November 2004)
142 * New options for kpsewhich
143 -var-value=VARIABLE to expand $VARIABLE without having to give an $
144 on the command line.
145 -engine=ENGINE to set the engine name, used in some search paths.
146 * New formats: kpse_enc_format, kpse_cmap_format, kpse_sfd_format,
147 kpse_opentype_fomat, kpse_pdftex_config_format, kpse_lig_format,
148 kpse_texmfscript_format.
149 * Add .afmt to the suffixes for kpse_fmt_format. Aleph uses this.
150 * Rename access to kpseaccess.
151 * Rename readlink to kpsereadlink.
152 * Stop search early if we're given absolute or explicit relative names.
153 * Add 'angle(0,0)' to the metafont errors mktexpk will ignore.
154 * The withenable.ac script (used in configure) will fall back on using
155 kpsewhich to look for texmf trees.
156 * If ls-R is not found check for ls-r as well.
157 * kpsewhich: add -var-value option.
158
159 3.5.2 (19 February 2003)
160 * Critical bugfix to db.c.
161
162 3.5.1 (17 February 2003)
163 * No news.
164
165 3.5.0 (15 February 2003)
166 * Use libtool.
167 * Do absolute searches again.
168 * Retain '${prefix}' in Makefile for texmf if that's how we found the tree.
169
170 3.4.6 (7 February 2003)
171 * Support for e-Omega.
172 * Change to the search algorithm: when there are several possibilities, look
173 for all of them in one directory before moving to the next directory.
174
175 3.4.5 (28 January 2003)
176 * Remove "." from the TEXCONFIG path.
177
178 3.4.4 (16 January 2003)
179 * Add VARTEXMF HOMETEXMF to the default paths of texmf.in.
180
181 3.4.3 (11 January 2003)
182 * Minor fixes.
183 * Use both .w and .web suffixes for cweb.
184
185 3.4.2 (23 December 2002)
186 * Minor fixes to makefiles.
187 * A Win32 implementation of the fork/exec path in mktex. This leaves
188 MSDOS to be done.
189
190 3.4.1 (20 December 2002)
191 * A couple of fixes for the fork/exec code.
192
193 3.4.0 (14 December 2002)
194 * 3.4.x number as ABI is certainly broken now.
195 * Change the way the mktex* command lines are set up on unix systems.
196 Now we call fork/exec directly instead of using popen.
197 This code is not yet implemented for Windows/DOS.
198 * We're now (un?)fairly restrictive on what names are allowed for fonts.
199 That part of the code probably need improvement.
200 * When reading names from the ls-R file, they are no longer case-smashed.
201 So on platforms where this matters, the case-smashing should occur before
202 names are inserted into the ls-R file -- only lowercase should be used in
203 that file.
204
205 3.3.11 (13 November 2002)
206 * Minor fixes.
207
208 3.3.10 (11 November 2002)
209 * Minor fixes.
210
211 3.3.9 (22 October 2002)
212 * New extension: .oft for Omega formats.
213
214 3.3.8 (11 October 2002)
215 * Add support for mktexfmt (which is normally a link to fmtutil).
216 * Check both VAR.progname and VAR_progname in the environment.
217
218 3.3.7 (27 November 2001)
219 * Minor fixes/changes to assist Omega development.
220
221 3.3.6 (18 November 2001)
222 * Minor fixes/changes to assist Omega development.
223
224 3.3.5 (10 November 2001)
225 * Minor bug fixes.
226
227 3.3.4 (30 October 2001)
228 * Minor bug fixes.
229
230 3.3.3 (5 August 2000)
231 * On NeXT, 'rm -rf' will not fail, but uses the cwd as its argument.
232 mktexlsr counted on it to fail, with sometimes disastrous results.
233
234 3.3.2 (25 April 1999)
235 * Minor bug fixes.
236
237 3.3.1 (29 May 1999)
238 * Minor bug fixes.
239
240 3.3 (26 March 1999)
241 * Minor bugfixes.
242
243 3.2 (15 March 1998)
244 * Brace expansion will accept the path separator as well as the comma,
245 e.g., {foo:bar}.
246 * For TeX, we only recognize one suffix, because there is no such thing
247 as a canonical list of TeX suffixes.
248 * We distinguish between two kinds of suffixes in the code: the standard
249 suffixes which may be appended to filenames when searching; and the
250 alternative suffixes which are never appended, but when found this
251 prevents a search with one of the standard suffixes.
252 * kpse_reset_program_name: change assumed program name, resets the search
253 paths, so that searches will work as expected for the new name.
254 * kpse_set_program_name: new function, replaces kpse_set_progname.
255 * The MakeTeX* scripts have been renamed to mktex* forms.
256
257 3.1 (10 November 1997)
258 * The support for multiple texmf trees is much improved.
259 * New MakeTeX* scripts, based on teTeX's. These scripts now use
260 heuristics to decide where generated files are placed and which
261 permissions they should have.
262 * The varfonts feature is enabled by default.
263 * Some MSDOS/Win32 support added to the sources.
264 * Change in searching algorithm: if a name doesn't have the default suffix
265 we append it for the first search. Then we search for the bare name.
266 Thus if you have foo.bar and foo.bar.tex, the latter will now be found
267 first. Under the old system, you had to specify boo.bar.tex.tex to get
268 foo.bar.tex instead of foo.bar.
269 * Prepend the value of KPSE_DOT to relative paths from texmf.cnf if it
270 defined in the environment. This means we can use . instead of
271 $KPSE_DOT in paths.
272 * Define brace expansion so that {a,b}{1,2} expands to a1:b1:a2:b2. This
273 is different from how shells do it, and exploited in texmf.in.
274 * Renamed texmf.cnf.in to texmf.in.
275 * New value for debugging: DEBUG_VARS, equal to 64.
276 * If a file format has no suffix, allow its long name as the argument to
277 kpsewhich --format.
278
279 3.0 (7 February 1997)
280 * Distribution terms changed to the GNU Library General Public License.
281 * Default directory structure matches the TDS standard. The most
282 important change is in the fonts/ directory: the file type (tfm, pk)
283 is now directly underneath fonts/. Also, mft/ is now at the top level.
284 `modeless' is used for gsftopk/ps2pk/etc.-generated fonts.
285 * Change in searching algorithm: if the name already has a suffix
286 (foo.sty), search for it by itself first, before appending the default
287 suffix (foo.sty.tex). This loses if you have an executable named
288 foo.bar, with documentation in foo.bar.tex (foo.bar will be found
289 first). But this is unusual, and the other case is common.
290 * Environment variables PATH_program (e.g., TEXINPUTS_latex) checked
291 for, as with configuration file values (TEXINPUTS.latex).
292 * Multiple TEXMF trees supported, via the following new facility:
293 * Shell brace expansion {foo,bar} implemented, thanks to Bash.
294 * Multiple ls-R files supported via the TEXMFDBS path.
295 * An ``alias'' database for files in ls-R supported, to handle 8.3 problems.
296 * Directories in the ls-R file can be relative (./) as well as absolute (/).
297 * New MakeTeX{PK,TFM,MF} scripts with more features, based on teTeX's.
298 * DVIPSMAKEPK (etc.) actually overrides the name `MakeTeXPK', as documented.
299 * MakeTeX* can be globally disabled via configure options.
300 * Support for building as a shared library with configure --enable-shared.
301 * Directories whose names begin with `.' are ignored.
302 * Some warnings can be suppressed by TEX_HUSH cnf value or envvar.
303 * kpsewhich has many new capabilities, documented via --help and in the manual.
304 * texfonts.map parsing has an include directive, and @c is a comment.
305 * Input lines in texmf.cnf can be continued with \.
306 * TEXMFLOG can be set in texmf.cnf, as previously documented.
307 * SELFAUTODIR and SELFAUTOPARENT are defined according to the location
308 of the binary, and used to search for texmf.cnf.
309 * /// (or more) is equivalent to //.
310 * If $HOME = / (as with root on some systems), avoid creating // in paths.
311 * Support for AFM, PostScript Type 1 font, source, documentation, Omega,
312 and MetaPost-related file formats.
313 * New header kpathsea.h with all #include files.
314 * Under DOS, ls-R lines need not start with . or / or \ (e.g., c:).
315 * Amiga support.
316
317 2.6 (9 January 1995)
318 * MakeTeXPK installed from kpathsea, instead of each driver.
319 * MakeTeXPK.site looked for in texmf/web2c, instead of texmf/dvips.
320 * texmf.cnf installed and looked for in texmf/web2c, instead of texmf.
321 * If a mode is not explicitly specified, search all subdirectories (this
322 was actually in a previous release).
323 * install-sh only looked for in the top-level directory.
324 * kpsewhich replaces and generalizes kpsexpand.
325
326 2.5 (15 December 1994)
327 * Go back to calling db_insert after a successful MakeTeXPK, and check
328 for lack of an ls-R.
329 * Handle case of magstep -.5 for MakeTeXPK properly.
330
331 2.4 (28 October 1994)
332 * Avoid calling db_insert, which caused a segmentation fault.
333
334 2.3 (26 October 1994)
335 * Extra :'s in an envvar value, referring to the texmf.cnf value, work.
336 * Names like dpi600/cmr10.pk can be found in ls-R.
337 * KPATHSEA_DEBUG environment variable checked.
338 * Directories like pk/ljfour directly under $TEXMF/fonts are found.
339 * New standalone program, kpsexpand, optionally compiled and installed,
340 to do variable expansion (not path searching).
341 * Debugging output written to stderr instead of stdout.
342 * pxlNNN support removed; I never intended to support `pxl1500', and
343 pxl300 is never used.
344
345 2.2 (14 October 1994)
346 * MakeTeXPK invoked for the any_glyph type; this is for xdvik.
347 * MakeTeXPK sources $(psheaderdir)/MakeTeXPK.site if it exists.
348 * pxlNNN/cmr10.pk searched for (as well as dpiNNN/cmr10.pk and cmr10.NNNpk)
349
350 2.1 (12 September 1994)
351 * Manual goes through TeX, and .cps/.aux files are in the distribution.
352 * INSTALL* variables set at the top level.
353 * Dependency on GNU tr making paths.h and texmf.sed (->texmf.cnf) removed.
354 * texmf.cnf installed if it didn't previously exist.
355
356 2.0 (8 September 1994)
357 * Runtime configuration file support; see the manual.
358 * Both dpi600/cmr10.pk and cmr10.600pk are searched for.
359 * ls-R matches $TEXMF//latex2e vs. $TEXMF//latex209.
360 * $TEXMFLOG, if set, specifies a filename for logging successful searches.
361 * All directory entries beginning with `.' are ignored, not just `.' and `..'.
362 * Default path for PK and GF fonts includes the mode name.
363 * ls-R is in $TEXMFROOT instead of hardwired at compile time.
364 * More debugging flags, and they can be set with client program options.
365 * If MakeTeX{PK,TFM} fail, or aren't invoked, a file missfont.log is
366 written with the requisite commands, as in dvips.
367 * More 328/329/330 fixes, maybe for the last time.
368 * The override font paths (XDVIFONTS etc.) apply only to glyph (PK/GF)
369 searches, not TFM or VF.
370 * -g is not the default when linking, to avoid unnecessarily large binaries
371 (due to static libraries) under Linux.
372 * configure checks for a smart putenv.
373 * Stat results are cached to speed up disk searches.
374
375 1.8 (2 April 1994)
376 * New target install-info, so the documentation can be installed without
377 the headers.
378 * Existing but unreadable files are complained about, instead of just ignored.
379 * A leading %% in a path element forbids searching the disk for that
380 element; only a db will be searched (if it exists).
381 * The db is only used if it might be relevant to a given path element,
382 not searched first regardless.
383
384 1.7 (1 March 1994)
385 * Searches can use an externally-built ls-R ``database'', for speed.
386 * `VPATH = .' lines removed from generated Makefile, for broken Sun make.
387 * A path foo//tfm finds foo/tfm as well as foo/*/tfm.
388
389 1.6 (3 February 1994)
390 * Memory fault in copying long paths fixed.
391 * More variables passed down from the top-level Makefile.
392 * Mention SMART_PUTENV in the INSTALL file, and fix bug in xputenv.c
393 when one envvar is a proper prefix of another.
394 * More attempts at eliminating magstephalf annoyances.
395 * Directory name substitutions are done globally when creating paths.h.
396 * Various changes for DOS.
397
398 1.5 (24 January 1994)
399 * Default paths changed.
400 * Defining GCC_WCHAR lets GCC define wchar_t.
401 * EXIT_FAILURE and EXIT_SUCCESS defined in all cases (if they're not already).
402 * str[r]chr never redefined (I hope).
403
404 1.4 (3 November 1993)
405 * Check closest fallback font size.
406 * All default paths (including dvips') in paths.h.in, not the Makefile.
407 * Rearrange directory lists so that dirs in which a file is found
408 migrate to the top.
409 * Update for Autoconf 1.7.
410
411 1.3 (6 October 1993)
412 * Fix free of non-malloced memory bug.
413 * Fix uninitialized gf path bug.
414 * mkdirchain invoked as an absolute filename.
415
416 1.2 (27 September 1993)
417 * Running MakeTeXPK is tried before the fallback resolutions.
418 * The final bitmap name uses a variable spec, so DOS & OS/2 can get
419 dpi300/cmr10.pk.
420 * Document TeX-specific features.
421 * Dpi passed to MakeTeXPK via the envvar KPATHSEA_DPI instead of MAKETEX_DPI.
422
423 1.1 (26 August 1993)
424 * Installation fixes.
425
426 1.0 (5 August 1993)
427 * Routines to look up TeX font files, default path specifications, etc.
428 * Sort-of pattern matching: /foo//bar matches subdirectories
429 /foo/a/bar, /foo/b/bar, /foo/a1/a2/bar, etc.
430 * $var and ${var} expansion.
431 * Support for MakeTeX... scripts.
432 * Support for fallback resolutions and font.
433 * Lazy evaluation of path elements.
434 * Some runtime debugging support.
435
436 0.2 (12 May 1993)
437
438 First general release as a standalone library.