From 0fa046c08f691d7db06ce2955923a83f42ebef5e Mon Sep 17 00:00:00 2001
From: Khaled Hosny <khaledhosny@eglug.org>
Date: Fri, 25 Jun 2010 18:04:23 +0300
Subject: Document blacklisting feature

---
 luaotfload.dtx | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'luaotfload.dtx')

diff --git a/luaotfload.dtx b/luaotfload.dtx
index 1dbd00e..ddd12f4 100644
--- a/luaotfload.dtx
+++ b/luaotfload.dtx
@@ -346,6 +346,19 @@ and the derived files
 % the script and includes some advanced options that we have not mentioned
 % here.
 %
+% \subsection{Blacklisting fonts}
+%
+% Some fonts are problematic in \LuaTeX, if you found that your document takes
+% too long to compile, or eats all the free memory, you can find the culprit
+% file by running |mkluatexfontdb| utility with |-v| option to see which font
+% file it is stuck with. You can then instruct \textsf{luaotfload} to ignore
+% this font by adding it to the blacklist configuration file.
+%
+% 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.
+%
 % \section{Required \ConTeXt\ files}
 %
 % This package is a wrapper for several files taken from the \ConTeXt\ macro
-- 
cgit v1.2.3

