luafindfont

git-svn-id: svn://tug.org/texlive/trunk@61207 c570f23f-e606-0410-a88d-b1316a301751

10 files changed, 425 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/support/luafindfont/CHANGELOG b/Master/texmf-dist/doc/support/luafindfont/CHANGELOG
new file mode 100644
index 00000000000..9f6e801161a
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/CHANGELOG
@@ -0,0 +1,9 @@
+0.04  2021-11-29  - rename the lua file to luafindfont
+                  - do not use xindex-lapp, handle the options by
+                    standard arg field
+0.03  2021-11-27  - added manpage
+                  - added "*" for output of all fonts
+                  - added option -n for no output of symbolic names
+                  - updated documentation
+0.02  2021-11-24  - correct README.md file
+0.01  2021-11-24  - first CTAN version
diff --git a/Master/texmf-dist/doc/support/luafindfont/README.md b/Master/texmf-dist/doc/support/luafindfont/README.md
new file mode 100644
index 00000000000..1148ac3b78a
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/README.md
@@ -0,0 +1,41 @@
+# luafindfont
+
+Searching for fonts in the font database. It needs Lua 5.3 which
+will be included in at least LuaTeX 1.09 (TeXLive 2019)
+
+## Usage
+The syntax of `luafindfont`
+
+```
+luafindfont [options] <font name> 
+```
+
+parameter handling
+-    -h,--help
+-    -o,--otfinfo (default 0)
+-    -i,--info (default 0)
+-    -v,--verbose
+-    -m,--max_string (default 90)
+-    -n,--nosymbolicnames
+-    <font> (string)  
+
+
+## Examples:
+
+```
+-luafindfont times 
+-luafindfont palatino -o 3
+-luafindfont -i 3 -m 50 arial
+```
+
+## copyright
+%% This file may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3c
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%%    http://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+
+
+hvoss@tug.org
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa01.txt b/Master/texmf-dist/doc/support/luafindfont/exa01.txt
new file mode 100644
index 00000000000..e530f26082d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa01.txt
@@ -0,0 +1,11 @@
+We are using Lua 5.3
+Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1.      Segoe UI Symbol.ttf segoeuisymbol       /Users/voss/Library/Fonts/Segoe/Segoe UI Symbol.ttf
+ 2.          Segoe_Print.ttf    segoeprint           /Users/voss/Library/Fonts/Segoe/Segoe_Print.ttf
+ 3.     Segoe_Print_Bold.ttf    segoeprint      /Users/voss/Library/Fonts/Segoe/Segoe_Print_Bold.ttf
+ 4.         Segoe_Script.ttf   segoescript          /Users/voss/Library/Fonts/Segoe/Segoe_Script.ttf
+ 5.    Segoe_Script_Bold.ttf   segoescript     /Users/voss/Library/Fonts/Segoe/Segoe_Script_Bold.ttf
+ 6.             Segoe_UI.ttf       segoeui              /Users/voss/Library/Fonts/Segoe/Segoe_UI.ttf
+ 7.        Segoe_UI_Bold.ttf       segoeui         /Users/voss/Library/Fonts/Segoe/Segoe_UI_Bold.ttf
+ 8. Segoe_UI_Bold_Italic.ttf       segoeui  /Users/voss/Library/Fonts/Segoe/Segoe_UI_Bold_Italic.ttf
+ 9.      Segoe_UI_Italic.ttf       segoeui       /Users/voss/Library/Fonts/Segoe/Segoe_UI_Italic.ttf
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa02.txt b/Master/texmf-dist/doc/support/luafindfont/exa02.txt
new file mode 100644
index 00000000000..8c113341de4
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa02.txt
@@ -0,0 +1,16 @@
+We are using Lua 5.3
+Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1.      LibertinusKeyboard-Regular.otf      libertinuskeyboard  /usr/local/texlive/2021/te...Regular.otf
+ 2.          LibertinusMath-Regular.otf          libertinusmath  /usr/local/texlive/2021/te...Regular.otf
+ 3.          LibertinusMono-Regular.otf          libertinusmono  /usr/local/texlive/2021/te...Regular.otf
+ 4.             LibertinusSans-Bold.otf          libertinussans  /usr/local/texlive/2021/te...ns-Bold.otf
+ 5.           LibertinusSans-Italic.otf          libertinussans  /usr/local/texlive/2021/te...-Italic.otf
+ 6.          LibertinusSans-Regular.otf          libertinussans  /usr/local/texlive/2021/te...Regular.otf
+ 7.            LibertinusSerif-Bold.otf         libertinusserif  /usr/local/texlive/2021/te...if-Bold.otf
+ 8.      LibertinusSerif-BoldItalic.otf         libertinusserif  /usr/local/texlive/2021/te...dItalic.otf
+ 9.          LibertinusSerif-Italic.otf         libertinusserif  /usr/local/texlive/2021/te...-Italic.otf
+10.         LibertinusSerif-Regular.otf         libertinusserif  /usr/local/texlive/2021/te...Regular.otf
+11.        LibertinusSerif-Semibold.otf         libertinusserif  /usr/local/texlive/2021/te...emibold.otf
+12.  LibertinusSerif-SemiboldItalic.otf         libertinusserif  /usr/local/texlive/2021/te...dItalic.otf
+13.  LibertinusSerifDisplay-Regular.otf  libertinusserifdisplay  /usr/local/texlive/2021/te...Regular.otf
+14. LibertinusSerifInitials-Regular.otf libertinusserifinitials  /usr/local/texlive/2021/te...Regular.otf
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa03.txt b/Master/texmf-dist/doc/support/luafindfont/exa03.txt
new file mode 100644
index 00000000000..2bb02df1a6a
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa03.txt
@@ -0,0 +1,34 @@
+We are using Lua 5.3
+Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1.              Arial Black.ttf               arialblack               /System/Library/Fonts/Supplemental/Arial Black.ttf
+ 2.        Arial Bold Italic.ttf                    arial         /System/Library/Fonts/Supplemental/Arial Bold Italic.ttf
+ 3.               Arial Bold.ttf                    arial                /System/Library/Fonts/Supplemental/Arial Bold.ttf
+ 4.             Arial Italic.ttf                    arial              /System/Library/Fonts/Supplemental/Arial Italic.ttf
+ 5. Arial Narrow Bold Italic.ttf              arialnarrow  /System/Library/Fonts/Supplemental/Arial Narrow Bold Italic.ttf
+ 6.        Arial Narrow Bold.ttf              arialnarrow         /System/Library/Fonts/Supplemental/Arial Narrow Bold.ttf
+ 7.      Arial Narrow Italic.ttf              arialnarrow       /System/Library/Fonts/Supplemental/Arial Narrow Italic.ttf
+ 8.             Arial Narrow.ttf              arialnarrow              /System/Library/Fonts/Supplemental/Arial Narrow.ttf
+ 9.       Arial Rounded Bold.ttf       arialroundedmtbold        /System/Library/Fonts/Supplemental/Arial Rounded Bold.ttf
+10.            Arial Unicode.ttf           arialunicodems                                 /Library/Fonts/Arial Unicode.ttf
+11.            Arial Unicode.ttf           arialunicodems             /System/Library/Fonts/Supplemental/Arial Unicode.ttf
+12.                    Arial.ttf                    arial                     /System/Library/Fonts/Supplemental/Arial.ttf
+13.                    Arial.ttf                    arial                        /Users/voss/Library/Fonts/Arial/Arial.ttf
+14.                  ArialHB.ttc              arialhebrew                                /System/Library/Fonts/ArialHB.ttc
+15.                  ArialHB.ttc arialhebrewdeskinterface                                /System/Library/Fonts/ArialHB.ttc
+16.                  ArialHB.ttc       arialhebrewscholar                                /System/Library/Fonts/ArialHB.ttc
+17.                  ArialHB.ttc              arialhebrew                                /System/Library/Fonts/ArialHB.ttc
+
+Run otfinfo:6
+Family:              Arial Narrow
+Subfamily:           Bold
+Full name:           Arial Narrow Bold
+PostScript name:     ArialNarrow-Bold
+Version:             Version 2.38.1x
+Unique ID:           Arial Narrow Bold : 2007
+Description:         Monotype Drawing Office 1982. A contemporary sans serif design, Arial contains more humanist characteristics than many of its predecessors and as such is more in tune with the mood of the last decades of the twentieth century. The overall treatment of curves is softer and fuller than in most industrial-style sans serif faces. Terminal strokes are cut on the diagonal which helps to give the face a less mechanical appearance. Arial is an extremely versatile family of typefaces which can be used with equal success for text setting in reports, presentations, magazines etc, and for display use in newspapers, advertising and promotions.
+Designer:            Robin Nicholas, Patricia Saunders
+Manufacturer:        The Monotype Corporation
+Trademark:           Arial is a trademark of The Monotype Corporation in the United States and/or other countries.
+Copyright:           © 2007 The Monotype Corporation. All Rights Reserved.
+License Description: You may use this font to display and print content as permitted by the license terms for the product in which this font is included. You may only (i) embed this font in content as permitted by the embedding restrictions included in this font; and (ii) temporarily download this font to a printer or other output device to help print content.
+Vendor ID:           TMC
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa04.txt b/Master/texmf-dist/doc/support/luafindfont/exa04.txt
new file mode 100644
index 00000000000..5de45e30c6a
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa04.txt
@@ -0,0 +1,14 @@
+We are using Lua 5.3
+Check for file /usr/local/texlive/2021/texmf-var/luatex-cache/generic/names/luaotfload-names
+ 1.      Segoe UI Symbol.ttf segoeuisymbol       /Users/voss/Library/Fonts/Segoe/Segoe UI Symbol.ttf
+ 2.          Segoe_Print.ttf    segoeprint           /Users/voss/Library/Fonts/Segoe/Segoe_Print.ttf
+ 3.     Segoe_Print_Bold.ttf    segoeprint      /Users/voss/Library/Fonts/Segoe/Segoe_Print_Bold.ttf
+ 4.         Segoe_Script.ttf   segoescript          /Users/voss/Library/Fonts/Segoe/Segoe_Script.ttf
+ 5.    Segoe_Script_Bold.ttf   segoescript     /Users/voss/Library/Fonts/Segoe/Segoe_Script_Bold.ttf
+ 6.             Segoe_UI.ttf       segoeui              /Users/voss/Library/Fonts/Segoe/Segoe_UI.ttf
+ 7.        Segoe_UI_Bold.ttf       segoeui         /Users/voss/Library/Fonts/Segoe/Segoe_UI_Bold.ttf
+ 8. Segoe_UI_Bold_Italic.ttf       segoeui  /Users/voss/Library/Fonts/Segoe/Segoe_UI_Bold_Italic.ttf
+ 9.      Segoe_UI_Italic.ttf       segoeui       /Users/voss/Library/Fonts/Segoe/Segoe_UI_Italic.ttf
+
+Font: segoeui
+Fonttype ttf(system) --> | Regular | Bold | Italic | BoldItalic |
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa05.txt b/Master/texmf-dist/doc/support/luafindfont/exa05.txt
new file mode 100644
index 00000000000..ddcd0b86a34
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa05.txt
@@ -0,0 +1,28 @@
+We are using Lua 5.3
+Looking for font "*"
+Check for file /usr/local/texlive/texmf-var/luatex-cache/generic/names/luaotfload-names
+ Nr.                                     Fontname                                                                        Path
+   1.                        Aboensis-Regular.otf               /usr/local/texlive/texmf-dist/fonts/opentype/public/aboensis/
+   2.                             academicons.ttf            /usr/local/texlive/texmf-dist/fonts/truetype/public/academicons/
+   3.              Academy Engraved LET Fonts.ttf                                         /System/Library/Fonts/Supplemental/
+   4.                         ACaslonPro-Bold.otf                                           /Users/voss/Library/Fonts/Caslon/
+   5.                   ACaslonPro-BoldItalic.otf                                           /Users/voss/Library/Fonts/Caslon/
+   6.                       ACaslonPro-Italic.otf                                           /Users/voss/Library/Fonts/Caslon/
+   7.                      ACaslonPro-Regular.otf                                           /Users/voss/Library/Fonts/Caslon/
+   8.                     ACaslonPro-Semibold.otf                                           /Users/voss/Library/Fonts/Caslon/
+   9.               ACaslonPro-SemiboldItalic.otf                                           /Users/voss/Library/Fonts/Caslon/
+  10.                        Acathist-Regular.otf   /usr/local/texlive/texmf-dist/fonts/opentype/public/fonts-churchslavonic/
+  11.                 AccanthisADFStdNo3-Bold.otf            /usr/local/texlive/texmf-dist/fonts/opentype/arkandis/accanthis/
+  12.           AccanthisADFStdNo3-BoldItalic.otf            /usr/local/texlive/texmf-dist/fonts/opentype/arkandis/accanthis/
+  13.               AccanthisADFStdNo3-Italic.otf            /usr/local/texlive/texmf-dist/fonts/opentype/arkandis/accanthis/
+  14.              AccanthisADFStdNo3-Regular.otf            /usr/local/texlive/texmf-dist/fonts/opentype/arkandis/accanthis/
+  15.                                     ACE.ttc                                     /Users/voss/Library/Fonts/AppleSymbols/
+  16.                                     ACE.ttc                                     /Users/voss/Library/Fonts/AppleSymbols/
+  17.                    AdineKirnberg-Script.otf                                      /Users/voss/Library/Fonts/AdineScript/
+  18.                        AdobeArabic-Bold.otf                                            /Users/voss/Library/Fonts/Adobe/
+  19.                  AdobeArabic-BoldItalic.otf                                            /Users/voss/Library/Fonts/Adobe/
+[...]                               [...]                                                         [...]
+6847.                                儷宋_Pro.ttf                                        /Users/voss/Library/Fonts/KozukaPro/
+6848.                                华文仿宋.ttf                                        /Users/voss/Library/Fonts/KozukaPro/
+6849.                                华文宋体.ttf                                        /Users/voss/Library/Fonts/KozukaPro/
+6850.                                华文楷体.ttf                                        /Users/voss/Library/Fonts/KozukaPro/
diff --git a/Master/texmf-dist/doc/support/luafindfont/exa06.txt b/Master/texmf-dist/doc/support/luafindfont/exa06.txt
new file mode 100644
index 00000000000..c076ffffd3d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/exa06.txt
@@ -0,0 +1,19 @@
+We are using Lua 5.3
+Looking for font "minion"
+Check for file /usr/local/texlive/2021/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/
diff --git a/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.pdf b/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.pdf
new file mode 100644
index 00000000000..79608402a1b
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.pdf
diff --git a/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.tex b/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.tex
new file mode 100644
index 00000000000..b051447e549
--- /dev/null
+++ b/Master/texmf-dist/doc/support/luafindfont/luafindfont-doc.tex
@@ -0,0 +1,253 @@
+ %% $Id: findfont-doc.tex 16 2021-11-07 19:42:57Z hvoss $
+%
+\listfiles\setcounter{errorcontextlines}{100}
+\documentclass[paper=a4,fontsize=11pt,DIV=14,parskip=half-,
+               captions=tableabove,twoside=on]{scrartcl}
+\usepackage{fontspec}
+%\usepackage{libertinus-otf}
+\setmainfont{AccanthisADFStdNo3}[
+  UprightFont   =*-Regular,
+  BoldFont      =*-Bold,
+  ItalicFont    =*-Italic,
+  BoldItalicFont=*-BoldItalic,
+  RawFeature    = -rlig,
+]
+\setsansfont{GilliusADF}[
+  UprightFont   =*-Regular,
+  BoldFont      =*-Bold,
+  ItalicFont    =*-Italic,
+  BoldItalicFont=*-BoldItalic,
+  RawFeature    = -rlig,
+]
+\setmonofont{DejaVu Sans Mono}[Scale=MatchLowercase,FakeStretch=0.9]
+%\setmonofont{Anonymous Pro}[Scale=MatchLowercase,FakeStretch=0.9]
+
+\usepackage[english]{babel}
+\usepackage{scrlayer-scrpage}
+\automark[section]{section}
+\automark*[subsection]{}
+\pagestyle{scrheadings}
+
+{\catcode`\%=12 
+ \gdef\perCent{%}
+ \gdef\DoubleperCent{%%}
+}
+
+\usepackage{xcolor,fancyvrb,varioref}
+\usepackage{xltabular,pdflscape}
+\usepackage{hvlogos} % for Wikipedia W
+\usepackage{listings}
+\usepackage{dtk-extern} % for Wikipedia W
+\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX}
+\usepackage{ragged2e}
+\usepackage{makeidx}\makeindex
+\usepackage{hvindex}
+\def\Lfile#1{\texttt{#1}\index{#1 file@\texttt{#1} file}}
+\def\Lext#1{\texttt{.#1}\index{#1 file extension@\texttt{.#1} file extension}}
+\def\Lcs#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}}
+\def\Lenv#1{\texttt{#1}\index{#1 environment@\texttt{#1} environment}}
+\def\Lpack#1{\texttt{#1}\index{#1 package@\texttt{#1} package}}
+\def\Lprog#1{\texttt{#1}\index{#1 program@\texttt{#1} program}}
+\def\Loption#1{\texttt{#1}\index{#1@\texttt{#1} package option}}
+\def\Largb#1{\emph{\{#1\}}}
+
+%\usepackage[bibstyle=dtk]{biblatex}
+%\addbibresource{\jobname.bib}
+
+\raggedbottom
+\usepackage{url}
+\usepackage[colorlinks,linktocpage]{hyperref}
+
+\makeatletter% from: doc.sty
+\newcommand*\GetFileInfo[1]{%
+  \def\filename{#1}%
+  \def\@tempb##1 ##2 ##3\relax##4\relax{%
+    \def\filedate{##1}%
+    \def\fileversion{##2}%
+    \def\fileinfo{##3}}%
+  \edef\@tempa{\csname ver@#1\endcsname}%
+  \expandafter\@tempb\@tempa\relax? ? \relax\relax}
+\makeatother
+
+%\GetFileInfo{xltabular.sty}
+\usepackage{xspace}
+
+\newcommand\FF{\texttt{luafindfont}\xspace}
+
+\def\setVersion#1{\setVVersion#1!!}
+\def\setVVersion#1=#2!!{\def\luafindfontVersion{#2}} 
+
+\setVersion{version = 0.04}%  can be automatically changed by perl
+
+\setkeys{dtk}{cleanup=true,force}
+
+\title{Program \texttt{luafindfont} \\--\\ \normalsize \luafindfontVersion\ (\today)}
+\author{\shortstack{Herbert Voß\\\small \href{mailto:hvoss@tug.org}{hvoss@tug.org}}}
+\date{}
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+\enlargethispage{1cm}
+\tableofcontents
+
+\vfill
+Thanks to: \\
+Rolf Niepraschk;
+\clearpage
+
+\section{Introduction}
+The Lua program
+\FF is a  program for searching installed fonts which are usable for \LuaLaTeX\ and \XeLaTeX.
+The already existing Lua program \Lprog{luaotfload-tool} can also be used for searching, but
+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, wher can it be found. For example:
+
+\begin{verbatim}
+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}
+
+But this 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}
+bash-3.2$ ./luafindfont.lua 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}
+
+
+\subsection{Syntax}
+
+The \Index{syntax} is 
+
+\verb|luafindfont [...] <font>| 
+
+where \verb|[...]|  are optional \Index{argument}s, either in short or
+long form which, of course, can be mixed:
+
+\begin{verbatim}
+  parameter handling
+    -q,--quiet
+    -h,--help
+    -o,--otfinfo (default 0)
+    -i,--info (default 0)
+    -n,--nosymbolicnames
+    -v...          Verbosity output
+    -m,--max_string (default 90)
+    <font> (string)  
+\end{verbatim}
+
+For example:
+
+\begin{verbatim}
+luafindfont times 
+luafindfont palatino -o 3
+luafindfont -i 3 -m 50 arial
+\end{verbatim}
+
+\begin{enumerate}
+\item \texttt{-q}: quiet; 
+\item \texttt{-m <columns>}: How many columns are used for the font with full path. This can be really long, but with e.g. \verb|-m 50| 
+the length is limited to 50 characters.
+\item \texttt{-o <number>}: For the font with the given number from the font list the program \Lprog{otfinfo} is called
+    for some generell font informations.
+\item \texttt{-i <number>}: For the font with the given number from the font list the existing font styles are listed.
+\end{enumerate}
+
+\section{How it works}
+\FF uses the data file \Lfile{luaotfloadtool-names.lua} which is created by \LuaTeX. If it is
+missing it will be created by \FF itself. The name of the font should be in lowercase
+characters and must not be the complete name. A \verb|time| for finding all fonts with
+time in its names is sufficiant.
+
+\section{Examples}
+
+\begin{Verbatim}
+bash-3.2$ luafindfont segoe
+\end{Verbatim}
+
+\VerbatimInput{Examples/exa01.txt}
+
+\begin{Verbatim}
+bash-3.2$ luafindfont -m 40 libertinus
+\end{Verbatim}
+
+\VerbatimInput{Examples/exa02.txt}
+
+
+\begin{Verbatim}
+bash-3.2$ luafindfont -i 9 sego
+\end{Verbatim}
+
+\VerbatimInput{Examples/exa04.txt}
+
+
+\begin{landscape}
+\begin{Verbatim}[fontsize=\small]
+bash-3.2$ luafindfont -o 6 arial
+\end{Verbatim}
+
+\VerbatimInput[fontsize=\small]{Examples/exa03.txt}
+
+
+\section{List of all fonts}
+This possible with the symbolic fontname "*" instead of a real fontname:
+
+\begin{Verbatim}[fontsize=\small]
+bash-3.2$ luafindfont "*"
+\end{Verbatim}
+
+This list maybe really long and is shortend here!
+
+\VerbatimInput[fontsize=\small]{Examples/exa05.txt}
+
+
+\end{landscape}
+
+
+\begin{Verbatim}[fontsize=\small]
+bash-3.2$ luafindfont -n minion
+\end{Verbatim}
+
+\VerbatimInput[fontsize=\small]{Examples/exa06.txt}
+
+
+
+
+
+\printindex
+
+\end{document}