Merge pull request #40 from pgundlach/whitelist

Black-/whitelist documentation update

2 files changed, 13 insertions, 2 deletions

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 5bb9b6a..7e4d8ed 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -379,7 +379,18 @@ and the derived files
 % Simply, create a file named |otfl-blacklist.cnf| and added the to be
 % blacklisted files, one per line. Then put the file some where \textsf{kpse}
 % can find. You can either use the base name or the full path. Any thing after
-% a |%| sign is ignored.
+% a |%| sign is ignored. \textsf{luaotfload} reads all files named named
+% |otfl-blacklist.cnf|, so you can add your own fonts to the global blacklist
+% by creating a local file |otfl-blacklist.cnf| with the entries you need.
+% You can also remove a font from this blacklist by prepending the name with
+% a dash (|-|).
+%
+% \begin{verbatim}
+% % example otf-blacklist.cnf
+% /Library/Fonts/GillSans.ttc  % luaotfload ignores this font
+% -/Library/Fonts/Optima.ttc   % it is usable again, even if it
+%                              % is blacklisted somewhere else
+% \end{verbatim}
 %
 % \section{Required \context files}
 %
diff --git a/otfl-blacklist.cnf b/otfl-blacklist.cnf
index f77de5b..6f9171b 100644
--- a/otfl-blacklist.cnf
+++ b/otfl-blacklist.cnf
@@ -1,4 +1,4 @@
-% Tackes ages to load
+% Takes ages to load
 LastResort.ttf % a MacOSX font, but also available for free from unicode.org 
 
 % Mac OS X TTC fonts, this list need to be filtered out