[doc] add a short note about TTC subfonts

1 files changed, 13 insertions, 0 deletions

diff --git a/doc/luaotfload-main.tex b/doc/luaotfload-main.tex
index f6c7301..406595a 100644
--- a/doc/luaotfload-main.tex
+++ b/doc/luaotfload-main.tex
@@ -424,6 +424,19 @@ non-standard directory:
   \font \gfsporson = "[/tmp/GFSPorson.otf]" at 12pt
 \endlisting
 
+\identifier{TrueType} collection files (the extension is usually
+\inlinecode{.ttc}) contain more than a single font. In order to refer to these
+subfonts, the respective index may be added in parentheses after the file
+name.\footnote{%
+  Incidentally, this syntactical detail also prevents one from loading files
+  that end in balanced parentheses.
+}
+
+\beginlisting
+  \font \cambriamain = "file:cambria.ttc(0)" at 10pt
+  \font \cambriamath = "file:cambria.ttc(1)" at 10pt
+\endlisting
+
 \endsubsubsection
 
 \beginsubsubsection{Loading by Font Name}