From 75e49e7772c6acbd13b96e001f05c232a380f729 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <phg@phi-gamma.net>
Date: Thu, 29 Sep 2016 22:14:54 +0200
Subject: [doc] add a short note about TTC subfonts

---
 doc/luaotfload-main.tex | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'doc')

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}
-- 
cgit v1.2.3