From cef23abf1d583a13c00cb56db864fb7ce594965e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Fri, 13 Oct 2023 21:55:24 +0200
Subject: [PATCH] doc: list font plugins in the File Format tables.

---
 doc/file-formats.dox | 66 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 65 insertions(+), 1 deletion(-)

diff --git a/doc/file-formats.dox b/doc/file-formats.dox
index d474c222a..dcd593d65 100644
--- a/doc/file-formats.dox
+++ b/doc/file-formats.dox
@@ -621,7 +621,71 @@ To be written.
 
 @section file-formats-fonts Fonts
 
-To be written.
+@m_class{m-row m-container-inflate}
+
+@parblock
+
+@m_class{m-fullwidth m-flat}
+
+<table>
+<tr>
+<th>Format</th>
+<th>Generic plugin alias</th>
+<th>Plugin name</th>
+<th class="m-text-center">Caveats</th>
+<th class="m-text-center">Dependencies</th>
+<th class="m-text-center">License</th>
+</tr>
+<tr><td colspan="6"></td></tr>
+
+<tr>
+<th rowspan="3">OpenType (`*.otf`)</th>
+<td rowspan="3">`OpenTypeFont`</td>
+<td>@relativeref{Text,FreeTypeFont}</td>
+<td class="m-text-center m-warning">@ref Text-FreeTypeFont-behavior "some"</td>
+<td class="m-text-center m-danger">external</td>
+<td class="m-text-center m-success">FreeType</td>
+</tr>
+<tr>
+<td>@relativeref{Text,HarfBuzzFont}</td>
+<td class="m-text-center m-dim">@ref Text-HarfBuzzFont-behavior "none"</td>
+<td class="m-text-center m-danger">external</td>
+<td class="m-text-center m-success">MIT</td>
+</tr>
+<tr>
+<td>@relativeref{Text,StbTrueTypeFont}</td>
+<td class="m-text-center m-warning">@ref Text-StbTrueTypeFont-behavior "some"</td>
+<td class="m-text-center m-primary">bundled</td>
+<td class="m-text-center m-primary">public&nbsp;domain</td>
+</tr>
+<tr><td colspan="6"></td></tr>
+
+<tr>
+<th rowspan="3">TrueType (`*.ttf`)</th>
+<td rowspan="3">`TrueTypeFont`</td>
+<td>@relativeref{Text,FreeTypeFont}</td>
+<td class="m-text-center m-success">@ref Text-FreeTypeFont-behavior "minor"</td>
+<td class="m-text-center m-danger">external</td>
+<td class="m-text-center m-success">FreeType</td>
+</tr>
+<tr>
+<td>@relativeref{Text,HarfBuzzFont}</td>
+<td class="m-text-center m-dim">@ref Text-HarfBuzzFont-behavior "none"</td>
+<td class="m-text-center m-danger">external</td>
+<td class="m-text-center m-success">MIT</td>
+</tr>
+<tr>
+<td>@relativeref{Text,StbTrueTypeFont}</td>
+<td class="m-text-center m-warning">@ref Text-StbTrueTypeFont-behavior "some"</td>
+<td class="m-text-center m-primary">bundled</td>
+<td class="m-text-center m-primary">public&nbsp;domain</td>
+</tr>
+</table>
+
+@endparblock
+
+In addition to the above, @ref Text::FreeTypeFont "FreeTypeFont" supports many
+more formats.
 
 @section file-formats-font-converters Font converters