From 54e53f535966d6328b828dea10d65e6e8460af33 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Thu, 12 Jan 2023 21:18:42 +0100 Subject: m doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- libfonts.h | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/libfonts.h b/libfonts.h index 242b187..02be993 100644 --- a/libfonts.h +++ b/libfonts.h @@ -72,18 +72,24 @@ enum libfonts_alias_line_type { LIBFONTS_ALIAS_LINE_ALIAS_DEFINITION, /** - * Line containing just the string ”FILE_NAMES_ALIASES” + * Line containing just the string “FILE_NAMES_ALIASES” * indicating that the file name, minus its suffix, of * each font file, in the same directory as the font alias * file, should be set as an alias for the font contained * in that file - * + * * For example, if the director contains the files - * "My Font.ttf" and "My Font Bold.ttf", the font names - * "My Font" and "My Font Bold" should be aliases for the + * “My Font.ttf” and “My Font Bold.ttf”, the font names + * “My Font” and “My Font Bold” should be aliases for the * two fonts, whose proper names are determined by their - * content and ought to be listed in the file "fonts.dir" - * in the same directory + * content and ought to be listed in the file “fonts.dir” + * in the same directory. Note fonts may be compressed + * with e.g. gzip, and therefor have an extra suffix + * (e.g. .gz), in such cases both the compression suffix + * and the font file type suffix shall be stripped, e.g. + * “My Font 16.pcf.gz” becomes “My Font 16”. You should + * however not assume that the suffixless basename does + * not contain any dot. */ LIBFONTS_ALIAS_LINE_FONT_NAMES_ALIASES }; -- cgit v1.2.3-70-g09d2