summaryrefslogtreecommitdiff
path: root/support/luafindfont/man/findfont.1
diff options
context:
space:
mode:
Diffstat (limited to 'support/luafindfont/man/findfont.1')
-rw-r--r--support/luafindfont/man/findfont.1124
1 files changed, 124 insertions, 0 deletions
diff --git a/support/luafindfont/man/findfont.1 b/support/luafindfont/man/findfont.1
new file mode 100644
index 0000000000..e2c684ed0b
--- /dev/null
+++ b/support/luafindfont/man/findfont.1
@@ -0,0 +1,124 @@
+.\" Manpage for luafindfont.
+.\" Contact hvoss@tug.org to correct errors or typos.
+.TH luafindfont 1 "29 nov 2021" "0.04" "luafindfont man page"
+.SH NAME
+luafindfont
+\- retrieve font informations of all installed system and TeX fonts.
+.SH SYNOPSIS
+luafindfont [options] <fontname>
+.SH DESCRIPTION
+This command lists informations about installed otf|ttf|ttc fonts,
+installed by the system and by the TeX distribution
+.SH OPTIONS
+.IP -h,--help
+obvious ... :-)
+.IP -o,--otfinfo (default 0)
+Use the program otfinfo for the font with the given number
+.IP -i,--info (default 0)
+List the given fontstyles (regular, bold, italic, bolditalic)
+for the font with the given number
+.IP -v,--verbose Verbosity level
+Give more informations, by now only -v works
+.IP -m,--max_string (default 90)
+The maximum of the stringlength of the full path of fonts
+.IP -n,--nosymbolicnames
+The fontlist contains only fontfile and fontpath
+.SH EXAMPLES
+
+$ luafindfont libertinssans
+
+.Pp
+Lists all fonts which have names or part of like libertinussans
+
+.nf
+.ft CW
+We are using Lua 5.3
+Check for file /usr/local/texlive/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1. LibertinusSans-Bold.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Bold.otf
+ 2. LibertinusSans-Bold.otf libertinussans /usr/local/texlive/texmf-d...onts/opentype/public/libertinus-fonts/LibertinusSans-Bold.otf
+ 3. LibertinusSans-Italic.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Italic.otf
+ 4. LibertinusSans-Italic.otf libertinussans /usr/local/texlive/texmf-d...ts/opentype/public/libertinus-fonts/LibertinusSans-Italic.otf
+ 5. LibertinusSans-Regular.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Regular.otf
+ 6. LibertinusSans-Regular.otf libertinussans /usr/local/texlive/texmf-d...s/opentype/public/libertinus-fonts/LibertinusSans-Regular.otf
+.ft R
+.fi
+
+.Pp
+The --otfinfo:
+
+$ luafindfont -o 3 libertinussans
+
+.Pp
+This produces the following output:
+
+.nf
+.ft CW
+We are using Lua 5.3
+Check for file /usr/local/texlive/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1. LibertinusSans-Bold.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Bold.otf
+ 2. LibertinusSans-Bold.otf libertinussans /usr/local/texlive/texmf-d...onts/opentype/public/libertinus-fonts/LibertinusSans-Bold.otf
+ 3. LibertinusSans-Italic.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Italic.otf
+ 4. LibertinusSans-Italic.otf libertinussans /usr/local/texlive/texmf-d...ts/opentype/public/libertinus-fonts/LibertinusSans-Italic.otf
+ 5. LibertinusSans-Regular.otf libertinussans /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Regular.otf
+ 6. LibertinusSans-Regular.otf libertinussans /usr/local/texlive/texmf-d...s/opentype/public/libertinus-fonts/LibertinusSans-Regular.otf
+
+Run otfinfo:3
+Family: Libertinus Sans
+Subfamily: Italic
+Full name: Libertinus Sans Italic
+PostScript name: LibertinusSans-Italic
+Version: Version 7.020;RELEASE
+Unique ID: 1.000;QUE ;LibertinusSans-Italic
+Designer: Philipp H. Poll, Khaled Hosny
+Manufacturer: Caleb Maclennan
+Vendor URL: https://github.com/alerque/libertinus
+Copyright: Copyright © 2012-2020 The Libertinus Project Authors.
+License URL: https://scripts.sil.org/OFL
+License Description: This Font Software is licensed under the SIL Open Font License, Version 1.1
+Vendor ID: QUE
+
+.ft R
+.fi
+
+.Pp
+The --nosymbilcnames:
+
+$ luafindfont -n
+
+.Pp
+This produces the following output:
+
+.nf
+.ft CW
+bash-3.2$ ./luafindfont.lua -n minion
+We are using Lua 5.3
+Check for file /usr/local/texlive/texmf-var/luatex-cache/generic/names/luaotfload-names
+ Nr. Fontname Path
+ 1. MinionMath-Bold.otf /Users/voss/Library/Fonts/MinionMath/
+ 2. MinionMath-Regular.otf /Users/voss/Library/Fonts/MinionMath/
+ 3. MinionPro-Bold.otf /Users/voss/Library/Fonts/MinionPro/
+ 4. MinionPro-BoldCn.otf /Users/voss/Library/Fonts/MinionPro/
+ 5. MinionPro-BoldCnIt.otf /Users/voss/Library/Fonts/MinionPro/
+ 6. MinionPro-BoldIt.otf /Users/voss/Library/Fonts/MinionPro/
+ 7. MinionPro-Capt.otf /Users/voss/Library/Fonts/MinionPro/
+ 8. MinionPro-Disp.otf /Users/voss/Library/Fonts/MinionPro/
+ 9. MinionPro-It.otf /Users/voss/Library/Fonts/MinionPro/
+ 10. MinionPro-Medium.otf /Users/voss/Library/Fonts/MinionPro/
+ 11. MinionPro-MediumIt.otf /Users/voss/Library/Fonts/MinionPro/
+ 12. MinionPro-Regular.otf /Users/voss/Library/Fonts/MinionPro/
+ 13. MinionPro-Semibold.otf /Users/voss/Library/Fonts/MinionPro/
+ 14. MinionPro-SemiboldIt.otf /Users/voss/Library/Fonts/MinionPro/
+ 15. MinionPro-Subh.otf /Users/voss/Library/Fonts/MinionPro/
+.ft R
+.fi
+
+.SH See also
+See luafindfont-doc.pdf for more details
+.SH BUGS
+No known bugs.
+.SH AUTHOR
+Herbert Voß (hvoss@tug.org)
+.SH LICENSE
+Permission is granted to copy, distribute and/or modify this software
+under the terms of the LaTeX Project Public License, version 1.3.
+