From 6fd5badc41b8e1fa1c009c1331554c189c8a4884 Mon Sep 17 00:00:00 2001
From: Karl Berry
• Introduction | Overview and history.
@@ -209,7 +209,7 @@ Next: unixtex.ftp, Previ
This manual corresponds to version 6.3.1 of the Kpathsea -library, released in February 2019. +library, released in March 2019. The library’s fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -1352,6 +1352,7 @@ searches the disk in the big system directory, the casefolding is not done, and a search for ‘stix-regular.otf’ will fail (on case-sensitive systems), as it always has. +The caveat about not searching the disk amounts to saying that casefolding does not happen in the trees specified with ‘!!’ (see ls-R), that is, where only database (ls-R) searching @@ -1447,14 +1448,19 @@ Next: Filename aliases, 5.5.1 ls-R-As mentioned above, you must name the main filename database
ls-R. You can put one at the root of each TeX installation
-hierarchy you wish to search ( Kpathsea looks for ls-R files along the The recommended way to create and maintain ‘ls-R’ is to run the
Regardless of whether you use the supplied script or your own, you will
-almost certainly want to invoke it via Regardless of whether you use the supplied script or your own, you
+will almost certainly want to invoke it via Because the database may be out-of-date for a particular run, if a file
-is not found in the database, by default Kpathsea goes ahead and
-searches the disk. If a particular path element begins with ‘!!’,
-however, only the database will be searched for that element,
-never the disk. If the database does not exist, nothing will be
-searched. Because this can surprise users (“I see the font
-foo.tfm when I do an If a particular path element begins with ‘!!’, only the +database will be searched for that element, never the disk; and if the +database does not exist, nothing at all will be searched. In TeX +Live, most of the trees are specified with ‘!!’. + +For path elements that do not begin with ‘!!’, if the database
+exists, it will be used, and the disk will not be searched. However,
+in this case, if the database does not exist, the disk will be
+searched. In TeX Live, the most notable case of this is the
+ (Aside: there are uncommon cases where a ‘!!’ tree will be
+searched on disk even if the To sum up: do not create an @@ -4419,7 +4440,9 @@ Previous: Reporting bugs, Index Entry | | Section | | ! | !! and casefolding : | Casefolding examples | !! in path specifications : | ls-R | !! in : | ls-R | | $ | $ expansion : | Variable expansion | |