From 6e7b9389e21c149a667f8db07f9e77723a8ffbe5 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Tue, 25 Jun 2013 11:14:23 +0200
Subject: document kpse: and my: lookups

---
 luaotfload.dtx | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 70edf8c..9e57bac 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -400,7 +400,23 @@ and the derived files
 % \begin{quote}
 %   |\font\fontname=|\meta{prefix}|:|\meta{fontname}\dots
 % \end{quote}
-% where \meta{prefix} is either \verb|file:| or \verb|name:|.
+% where \meta{prefix} is either \verb|file:| or \verb|name:|.\footnote{%
+%   The development version also knows two further prefixes,
+%   \verb|kpse:| and \verb|my:|.
+%   A \verb|kpse| lookup is restricted to files that can be found by
+%   \identifier{kpathsea} and
+%   will not attempt to locate system fonts.
+%   This behavior can be of value when an extra degree of encapsulation is
+%   needed, for instance when supplying a customized tex distribution.
+%
+%   The \verb|my| lookup takes this a step further: it lets you define
+%   a custom resolver function and hook it into the \luafunction{resolve_font}
+%   callback.
+%   This ensures full control over how a file is located.
+%   For a working example see the
+%   \href{https://bitbucket.org/phg/lua-la-tex-tests/src/5f6a535d/pln-lookup-callback-1.tex}
+%        {test repo}.
+% }
 % It determines whether the font loader should interpret the request as
 % a \emphasis{file name} or
 %   \emphasis{font name}, respectively,
-- 
cgit v1.2.3


From b4417d6f046b254fa18ee9dc740beabe42508aa1 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Tue, 25 Jun 2013 11:31:29 +0200
Subject: [doc] add note concerning unreliability of font names

---
 luaotfload.dtx | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 9e57bac..8ebd8ec 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -426,7 +426,26 @@ and the derived files
 %             “GFS Bodoni Rg”, and
 %             “PT Serif Caption”
 % -- they are the human readable identifiers
-% usually listed in drop-down menus and the like.
+% usually listed in drop-down menus and the like.\footnote{%
+%   Font names may appear like a great choice at first because they
+%   offer seemingly more intuitive identifiers in comparison to arguably
+%   cryptic file names:
+%   “PT Sans Bold” is a lot more descriptive than \fileent{PTS75F.ttf}.
+%   On the other hand, font names are quite arbitrary and there is no
+%   universal method to determine their meaning.
+%   While \identifier{luaotfload} provides fairly sophisticated heuristic
+%   to figure out a matching font style, weight, and optical size, it
+%   cannot be relied upon to work satisfactorily for all font files.
+%   For an in-depth analysis of the situation and how broken font names
+%   are, please refer to
+%   \href{http://www.ntg.nl/pipermail/ntg-context/2013/073889.html}
+%        {this post}
+%   by Hans Hagen, the author of the font loader.
+%   If in doubt, use filenames.
+%   \fileent{luaotfload-tool} can perform the matching for you with the
+%   option \verb|--find=<name>|, and you can use the file name it returns
+%   in your font definition.
+% }
 % In order for fonts installed both in system locations and in your
 % \fileent{texmf} to be accessible by font name, \identifier{luaotfload} must
 % first collect the metadata included in the files.
-- 
cgit v1.2.3


From 7a6b20715c61f6da1c2aa67e728935e9b83e5f47 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Tue, 2 Jul 2013 15:52:46 +0200
Subject: stop including luaotfload-lib-dir.lua

---
 luaotfload.dtx | 1 -
 1 file changed, 1 deletion(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 8ebd8ec..7a2710d 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -1805,7 +1805,6 @@ add_to_callback("hpack_filter",
 add_to_callback("find_vf_file",
                 find_vf_file, "luaotfload.find_vf_file")
 
-loadmodule"lib-dir.lua"    --- required by luaofload-database.lua
 loadmodule"override.lua"   --- “luat-ovr”
 
 logs.set_loglevel(config.luaotfload.loglevel)
-- 
cgit v1.2.3


From a31d6dab37752be4cac12e61cf819a88a6a628b4 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Tue, 2 Jul 2013 15:55:39 +0200
Subject: remove references to lib-dir from docs

---
 luaotfload.dtx | 3 ---
 1 file changed, 3 deletions(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 7a2710d..b66a88f 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -1194,9 +1194,6 @@ and the derived files
 %     \ouritem {luaotfload-features.lua}   font feature handling;
 %                                          incorporates some of the code from
 %                                          \fileent{font-otc} from \CONTEXT;
-%     \ouritem {luaotfload-lib-dir.lua}    \fileent{l-dir} from \CONTEXT;
-%                                          contains functionality required
-%                                          by \fileent{luaotfload-font-nms.lua}.
 %     \ouritem {luaotfload-override.lua}   overrides the \CONTEXT logging
 %                                          functionality.
 %     \ouritem {luaotfload-loaders.lua}    registers the \OpenType
-- 
cgit v1.2.3


From 6a30d02676f81dfae238b4ac47463c5781c34576 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Wed, 3 Jul 2013 11:09:03 +0200
Subject: adapt luaotfload.lua to new dir system

---
 luaotfload.dtx | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index b66a88f..bccdc0c 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -1460,8 +1460,8 @@ and the derived files
 %<*lua>
 % \fi
 %    \begin{macrocode}
-luaotfload                  = luaotfload or {}
-local luaotfload            = luaotfload
+luaotfload                        = luaotfload or {}
+local luaotfload                  = luaotfload
 
 config                            = config or { }
 config.luaotfload                 = config.luaotfload or { }
@@ -1472,7 +1472,9 @@ config.luaotfload.compatibility   = config.luaotfload.compatibility    or false
 config.luaotfload.loglevel        = config.luaotfload.loglevel         or 1
 config.luaotfload.color_callback  = config.luaotfload.color_callback   or "pre_linebreak_filter"
 config.luaotfload.prioritize      = config.luaotfload.prioritize       or "sys"
---luaotfload.prefer_merge     = config.luaotfload.prefer_merge or true
+config.luaotfload.names_dir       = config.luaotfload.names_dir        or "names"
+config.luaotfload.cache_dir       = config.luaotfload.cache_dir        or "fonts"
+config.luaotfload.names_file      = config.luaotfload.names_file       or "luaotfload-names.lua"
 
 luaotfload.module = {
     name          = "luaotfload",
-- 
cgit v1.2.3


From 4adcf7591ed8104b0b846d500a5d30d4ff32512e Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg42.2a@gmail.com>
Date: Wed, 3 Jul 2013 18:24:50 +0200
Subject: bump version

---
 luaotfload.dtx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index bccdc0c..b8bee75 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -40,7 +40,7 @@
 \input docstrip.tex
 \Msg{************************************************************************}
 \Msg{* Installation}
-\Msg{* Package: luaotfload v2.2 OpenType layout system}
+\Msg{* Package: luaotfload v2.3 OpenType layout system}
 \Msg{************************************************************************}
 
 \keepsilent
@@ -111,7 +111,7 @@ and the derived files
 %<*driver>
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesFile{luaotfload.drv}%
-  [2013/05/23 v2.2d OpenType layout system]%
+  [2013/05/23 v2.3d OpenType layout system]%
 \documentclass{ltxdoc}
 \usepackage{metalogo,multicol,mdwlist,fancyvrb,xspace}
 \usepackage[x11names]{xcolor}
@@ -231,7 +231,7 @@ and the derived files
 % \GetFileInfo{luaotfload.drv}
 %
 % \title{The \identifier{luaotfload} package}
-% \date{2013/05/23 v2.2d}
+% \date{2013/05/23 v2.3d}
 % \author{Elie Roux · Khaled Hosny · Philipp Gesang\\
 %         Home:      \url{https://github.com/lualatex/luaotfload}\\
 %         Support:   \email{lualatex-dev@tug.org}}
@@ -2069,7 +2069,7 @@ loadmodule"auxiliary.lua"   --- additionaly high-level functionality (new)
 \else
   \NeedsTeXFormat{LaTeX2e}
   \ProvidesPackage{luaotfload}%
-    [2013/05/23 v2.2d OpenType layout system]
+    [2013/05/23 v2.3d OpenType layout system]
   \RequirePackage{luatexbase}
 \fi
 \ifnum\luatexversion<76
-- 
cgit v1.2.3

