summaryrefslogtreecommitdiff
path: root/support/luafindfont/doc/luafindfont-doc.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-05-06 03:00:50 +0000
committerNorbert Preining <norbert@preining.info>2022-05-06 03:00:50 +0000
commit3e3ecb7f722d0904c12ee0648c343b865dc99187 (patch)
tree8c13ed895e7191ed6c6a583a9730bde9cdd2a92f /support/luafindfont/doc/luafindfont-doc.tex
parentc8185bb3cd55c24b45c9b19c4ea36b8c7057199d (diff)
CTAN sync 202205060300
Diffstat (limited to 'support/luafindfont/doc/luafindfont-doc.tex')
-rw-r--r--support/luafindfont/doc/luafindfont-doc.tex209
1 files changed, 73 insertions, 136 deletions
diff --git a/support/luafindfont/doc/luafindfont-doc.tex b/support/luafindfont/doc/luafindfont-doc.tex
index be0ea0c3c8..90d0c57d94 100644
--- a/support/luafindfont/doc/luafindfont-doc.tex
+++ b/support/luafindfont/doc/luafindfont-doc.tex
@@ -37,7 +37,9 @@
\usepackage{xltabular,pdflscape}
\usepackage{hvlogos} % for Wikipedia W
\usepackage{listings}
-\usepackage{hvextern} % for Wikipedia W
+\usepackage{hvextern}
+
+\setkeys{hv}{moveToExampleDir,ExampleDir=Examples,showFilename=false}
\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX}
\usepackage{ragged2e}
\usepackage{makeidx}\makeindex
@@ -77,9 +79,9 @@
\def\setVersion#1{\setVVersion#1!!}
\def\setVVersion#1=#2!!{\def\luafindfontVersion{#2}}
-\setVersion{version = 0.07}% can be automatically changed by perl
+\setVersion{version = 0.08}% can be automatically changed by perl
-\setkeys{hv}{cleanup=true,force}
+\setkeys{hv}{cleanup={},force}
\title{Program \texttt{luafindfont} \\--\\ \normalsize \luafindfontVersion\ (\today)}
\author{\shortstack{Herbert Voß\\\small \href{mailto:hvoss@tug.org}{hvoss@tug.org}}}
@@ -93,6 +95,7 @@
\vfill
Thanks to: \\
Gerhard Bachmaier;
+Karl Berry;
Rolf Niepraschk;
\clearpage
@@ -103,53 +106,31 @@ The already existing Lua program \Lprog{luaotfload-tool} can also be used for se
the search-interface is somewhat cryptic and too complex for a user, who wants only to know
if a font is present or not. And if present, where can it be found. For example:
-\begin{Verbatim}[frame=lines,label=luaotfload-tool]
-H-MacBook:~ voss$
-H-MacBook:~ voss$ luaotfload-tool --find=times
-luaotfload | resolve : Font "times" found!
-luaotfload | resolve : Resolved file name "/System/Library/Fonts/Times.ttc", subfont nr. 0
-H-MacBook:~ voss
-H-MacBook:~ voss$ luaotfload-tool --fuzzy --find="times new roman"
-luaotfload | resolve : Font "times new roman" found!
-luaotfload | resolve : Resolved file name "/System/Library/Fonts/Supplemental/Times New Roman.ttf"
-H-MacBook:~ voss$
-\end{Verbatim}
+
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luaotfload-tool --find=times
+#StopVisibleMain
+\end{externalDocument}
+
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luaotfload-tool --fuzzy --find="times new roman"
+#StopVisibleMain
+\end{externalDocument}
+
+
+
But that are not \emph{all} Times fonts. Compare it with the output of \Lprog{luafindfont},
where the searchname \emph{times} must only be a part of a longer name:
-\begin{Verbatim}[frame=lines,label=luafindfont times]
-bash-3.2$ luafindfont times
-We are using Lua 5.3
-Check for file /usr/local/texlive/texmf-var/luatex-cache/generic/names/luaotfload-names
- Nr. Fontname Symbolic Name Path
- 1. Times New Roman Bold Italic.ttf timesnewroman /Users/voss/Library/Fonts/Times/
- 2. Times New Roman Bold Italic.ttf timesnewroman /System/Library/Fonts/Supplemental/
- 3. Times New Roman Bold.ttf timesnewroman /System/Library/Fonts/Supplemental/
- 4. Times New Roman Bold.ttf timesnewroman /Users/voss/Library/Fonts/Times/
- 5. Times New Roman Italic.ttf timesnewroman /System/Library/Fonts/Supplemental/
- 6. Times New Roman Italic.ttf timesnewroman /Users/voss/Library/Fonts/Times/
- 7. Times New Roman.ttf timesnewroman /System/Library/Fonts/Supplemental/
- 8. Times New Roman.ttf timesnewroman /Users/voss/Library/Fonts/Times/
- 9. Times.ttc times /System/Library/Fonts/
- 10. Times_Sans_Serif.ttf timessansserif /Users/voss/Library/Fonts/Times/
- 11. TimesNewRomanMTStd-Bold.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 12. TimesNewRomanMTStd-BoldCond.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 13. TimesNewRomanMTStd-BoldIt.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 14. TimesNewRomanMTStd-Cond.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 15. TimesNewRomanMTStd-CondIt.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 16. TimesNewRomanMTStd-Italic.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 17. TimesNewRomanMTStd.otf timesnewromanmtstd /Users/voss/Library/Fonts/Times/
- 18. TimesNewRomanPS-BoldItalicMT.otf timesnewromanpsmt /Users/voss/Library/Fonts/Times/
- 19. TimesNewRomanPS-BoldMT.otf timesnewromanpsmt /Users/voss/Library/Fonts/Times/
- 20. TimesNewRomanPSMT.otf timesnewromanpsmt /Users/voss/Library/Fonts/Times/
- 21. TimesNewRomanPSStd-Bold.otf timesnewromanpsstd /Users/voss/Library/Fonts/Times/
- 22. TimesNewRomanPSStd-BoldIt.otf timesnewromanpsstd /Users/voss/Library/Fonts/Times/
- 23. TimesNewRomanPSStd-Italic.otf timesnewromanpsstd /Users/voss/Library/Fonts/Times/
- 24. TimesNewRomanPSStd-Regular.otf timesnewromanpsstd /Users/voss/Library/Fonts/Times/
-\end{Verbatim}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont times
+#StopVisibleMain
+\end{externalDocument}
-%$
\subsection{Syntax}
@@ -167,10 +148,10 @@ long form which, of course, can be mixed:
-o,--otfinfo (default 0)
-i,--info (default 0)
-x,--xetex
- -n,--nosymbolicnames
+ -n,--no-symbolic-names
-v... Verbosity output
-m,--max_string (default 90)
- <font> (string)
+ <(partial) fontname>
\end{Verbatim}
For example:
@@ -225,41 +206,13 @@ The possible options are (i is the default):
\end{Verbatim}
-\begin{Verbatim}[frame=lines,label=luafindfont -o 2f "myriad \& semibold"]
-bash-3.2$ luafindfont -o 2f "myriad & semibold"
-We are using Lua 5.3
-Looking for font "myriad & semibold"
-Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
- No. Fontname Symbolic Name Path
- 1. MyriadPro-Semibold.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 2. MyriadPro-SemiboldCond.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 3. MyriadPro-SemiboldCondIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 4. MyriadPro-SemiboldIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 5. MyriadPro-SemiboldSemiCn.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 6. MyriadPro-SemiboldSemiCnIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 7. MyriadPro-SemiboldSemiExt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 8. MyriadPro-SemiboldSemiExtIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
-
-Run otfinfo -f: 2
-otfinfo -f "/Users/voss/Library/Fonts/MyriadPro/MyriadPro-SemiboldCond.otf"
-aalt Access All Alternates
-case Case-Sensitive Forms
-cpsp Capital Spacing
-dnom Denominators
-fina Terminal Forms
-frac Fractions
-kern Kerning
-liga Standard Ligatures
-lnum Lining Figures
-numr Numerators
-onum Oldstyle Figures
-ordn Ordinals
-pnum Proportional Figures
-sinf Scientific Inferiors
-sups Superscript
-tnum Tabular Figures
-zero Slashed Zero
-\end{Verbatim}
+
+
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -o 2f "myriad & semibold"
+#StopVisibleMain
+\end{externalDocument}
if no parameter is given, then \texttt{-i} is assumed.
@@ -269,25 +222,13 @@ For a given font number \texttt{luafindfont} will list the font styles which wer
and which correspond to the font number. This is useful if a fontname doesn't has the style in its name or
only in short form.
-\begin{Verbatim}[frame=lines,label=luafindfont -i 4 "myriad \& semibold"]
-bash-3.2$ luafindfont -i 4 "myriad & semibold"
-We are using Lua 5.3
-Looking for font "myriad & semibold"
-Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
- No. Fontname Symbolic Name Path
- 1. MyriadPro-Semibold.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 2. MyriadPro-SemiboldCond.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 3. MyriadPro-SemiboldCondIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 4. MyriadPro-SemiboldIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 5. MyriadPro-SemiboldSemiCn.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 6. MyriadPro-SemiboldSemiCnIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 7. MyriadPro-SemiboldSemiExt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
- 8. MyriadPro-SemiboldSemiExtIt.otf myriadpro /Users/voss/Library/Fonts/MyriadPro/
-
-Font: myriadpro
-
-Fonttype otf(system) --> | Regular | Bold | Italic | BoldItalic |
-\end{Verbatim}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -i 4 "myriad & semibold"
+#StopVisibleMain
+\end{externalDocument}
+
+
For the font number 4 there also exists a Regular, Bold, and a Italic font. The font no 4 itself
is a BoldItalic version.
@@ -303,14 +244,11 @@ the usual way by running \texttt{texhash} or via a menu entry if using a file ma
-\begin{Verbatim}
-bash-3.2$ ./luafindfont.lua -x PStricksdotfont
-We are using Lua 5.3
-Looking for font "pstricksdotfont"
-No. Fontname Symbolic Name Path X
- 1. myFont.otf pstricksdotfont /usr/local/texlive/texmf-local/fonts/opentype/ 0
- 2. PSTricksDotFont.otf pstricksdotfont /usr/local/texlive/texmf-local/fonts/opentype/ 1
-\end{Verbatim}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -x PStricksdotfont
+#StopVisibleMain
+\end{externalDocument}
The font \texttt{myFont.otf} is found by \LuaTeX\ but not by \XeTeX.
@@ -320,32 +258,41 @@ The font \texttt{myFont.otf} is found by \LuaTeX\ but not by \XeTeX.
\section{Examples}
-\begin{Verbatim}
-bash-3.2$ luafindfont segoe
-\end{Verbatim}
-\VerbatimInput{Examples/exa01.txt}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont segoe
+#StopVisibleMain
+\end{externalDocument}
-\begin{Verbatim}
-bash-3.2$ luafindfont -m 40 libertinus
-\end{Verbatim}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -m 40 libertinus
+#StopVisibleMain
+\end{externalDocument}
-\VerbatimInput{Examples/exa02.txt}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -i 9 sego
+#StopVisibleMain
+\end{externalDocument}
-\begin{Verbatim}
-bash-3.2$ luafindfont -i 9 sego
-\end{Verbatim}
+\begin{landscape}
-\VerbatimInput{Examples/exa04.txt}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont -o 6 arial
+#StopVisibleMain
+\end{externalDocument}
-\begin{landscape}
-\begin{Verbatim}[fontsize=\small]
-bash-3.2$ luafindfont -o 6 arial
-\end{Verbatim}
+\begin{externalDocument}[redirect,includegraphic=false,force,code,docType=sh,ext=sh,compiler=sh]{exa}
+#StartVisibleMain
+luafindfont --no-symbolic-names minion
+#StopVisibleMain
+\end{externalDocument}
-\VerbatimInput[fontsize=\small]{Examples/exa03.txt}
\section{List of all fonts}
@@ -363,16 +310,6 @@ This list maybe really long and is shortend here!
\end{landscape}
-\begin{Verbatim}[fontsize=\small]
-bash-3.2$ luafindfont -n minion
-\end{Verbatim}
-
-\VerbatimInput[fontsize=\small]{Examples/exa06.txt}
-
-
-
-
-
\printindex
\end{document}