From ef1bc4682c35c6e499174db6cbaefbb1167e20cf Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 27 Nov 2021 21:26:55 +0000 Subject: albatross (27nov21) git-svn-id: svn://tug.org/texlive/trunk@61175 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/albatross.1 | 39 ++++++++++++++------- Master/texmf-dist/doc/man/man1/albatross.man1.pdf | Bin 18986 -> 19672 bytes Master/texmf-dist/doc/support/albatross/README.md | 6 +++- .../doc/support/albatross/albatross-manual.pdf | Bin 79705 -> 80161 bytes .../doc/support/albatross/albatross-manual.tex | 22 ++++++++++-- .../texmf-dist/doc/support/albatross/version.tex | 2 +- Master/texmf-dist/scripts/albatross/albatross.jar | Bin 3131862 -> 2395011 bytes .../support/albatross/albatross-0.3.0-src.zip | Bin 6074 -> 0 bytes .../support/albatross/albatross-0.4.0-src.zip | Bin 0 -> 6245 bytes 9 files changed, 52 insertions(+), 17 deletions(-) delete mode 100644 Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zip create mode 100644 Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zip diff --git a/Master/texmf-dist/doc/man/man1/albatross.1 b/Master/texmf-dist/doc/man/man1/albatross.1 index 1f50608e900..bc866cc6934 100644 --- a/Master/texmf-dist/doc/man/man1/albatross.1 +++ b/Master/texmf-dist/doc/man/man1/albatross.1 @@ -1,39 +1,52 @@ -.TH ALBATROSS 1 "13 January 2021" "v0.3.0" +.TH ALBATROSS 1 "27 November 2021" "v0.4.0" +. .SH NAME albatross \- a tool for finding fonts that contain a given (Unicode) glyph. +. .SH SYNOPSIS .B albatross .RI [ options ] .IR glyphs ... +. .SH DESCRIPTION \fBalbatross\fP is a command line tool for finding fonts that contain a given -(Unicode) glyph. It relies on Fontconfig, a library for configuring and -customizing font access. +(Unicode) glyph. +It relies on Fontconfig, a library for configuring and customizing font +access. .PP -Albatross takes a list of glyphs as input. Two formats are supported: +Albatross takes a list of glyphs as input. +Three formats are supported: .IP #1 -The glyph itself, e.g, ß (Eszett). -Internally, the tool will convert it to the corresponding Unicode code point. +The glyph itself, e.g., \fBß\fP (Eszett). +Internally, the tool converts it to the corresponding Unicode code point. .IP #2 -The glyph as a Unicode code point in the hexadecimal notation, e.g, \fC0xDF\fP. -The \fC0x\fP prefix is mandatory. Note that the tool takes the value as case -insensitive, e.g, \fC0xDF\fP is equal to \fC0xdf\fP (or any case combination -thereof). +The glyph as a Unicode code point in the hexadecimal notation, +e.g., \fB0xDF\fP. +The \fB0x\fP prefix is mandatory. +Note that the tool takes the value as case insensitive, e.g., +\fB0xDF\fP is equal to \fB0xdf\fP (or any case combination thereof). +.IP #3 +The glyph as a Unicode code point using the multiset union notation, +e.g, \fBU+DF\fP. +The \fBU+\fP prefix is mandatory. +Be mindful that this notation expects an uppercase \fBU\fP. +. .SH OPTIONS .IP \fB--show-styles\fP Show available font styles .IP \fB--detailed\fP Show a detailed font list -.IP \fB--ansi-level\fP [n|a16|a256|tc] +.IP "\fB--ansi-level\fP [n|a16|a256|tc]" Set the default ANSI level -.IP \fB--border-style\fP [1|2|3|4|5|6] +.IP "\fB--border-style\fP [1|2|3|4|5|6]" Set the border style .IP \fB--or\fP Look for each glyph separately .IP \fB--version\fP Show the version and exit .IP \fB--help\fP -Show a help message and exit. +Show a help message and exit +. .SH BUGS Issue tracker at .UR https://gitlab.com/islandoftex/albatross/-/issues diff --git a/Master/texmf-dist/doc/man/man1/albatross.man1.pdf b/Master/texmf-dist/doc/man/man1/albatross.man1.pdf index 1868a61ee12..4237b1ab4be 100644 Binary files a/Master/texmf-dist/doc/man/man1/albatross.man1.pdf and b/Master/texmf-dist/doc/man/man1/albatross.man1.pdf differ diff --git a/Master/texmf-dist/doc/support/albatross/README.md b/Master/texmf-dist/doc/support/albatross/README.md index 45c6bd543d2..1f00d4325fd 100644 --- a/Master/texmf-dist/doc/support/albatross/README.md +++ b/Master/texmf-dist/doc/support/albatross/README.md @@ -40,7 +40,7 @@ the tool usage. ### Glyphs -Albatross takes a list of glyphs as input. Two formats are supported: +Albatross takes a list of glyphs as input. Three formats are supported: - The glyph itself, e.g, `ß` ([Eszett](https://en.wikipedia.org/wiki/%C3%9F)). Internally, the tool will convert it to the corresponding Unicode code point. @@ -49,6 +49,10 @@ Albatross takes a list of glyphs as input. Two formats are supported: The `0x` prefix is mandatory. Note that the tool takes the value as case insensitive, e.g, `0xDF` is equal to `0xdf` (or any case combination thereof). +- The glyph as a Unicode code point using the multiset union notation, e.g, + `U+DF`. The `U+` prefix is mandatory. Be mindful that this notation expects + an uppercase `U`. + When a list of glyphs is provided, the tool will take a conjunctive approach and look for fonts that contain all elements in such list (default behaviour). Use the `-o` flag (or `--or` for the long flag) to look for each glyph separately. diff --git a/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf b/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf index 5953976a421..8f69bd48d29 100644 Binary files a/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf and b/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf differ diff --git a/Master/texmf-dist/doc/support/albatross/albatross-manual.tex b/Master/texmf-dist/doc/support/albatross/albatross-manual.tex index ea0a689908b..1a3c2c5b214 100644 --- a/Master/texmf-dist/doc/support/albatross/albatross-manual.tex +++ b/Master/texmf-dist/doc/support/albatross/albatross-manual.tex @@ -21,6 +21,7 @@ \newcommand{\command}[1]{{\ttfamily#1}} \newcommand{\glyph}[1]{{\ttfamily#1}} \newcommand{\hex}[1]{{\ttfamily0x#1}} +\newcommand{\uno}[1]{{\ttfamily U+#1}} \newcommand{\val}[1]{{\ttfamily#1}} \newcommand{\shortopt}[1]{{\ttfamily-#1}} \newcommand{\longopt}[1]{{\ttfamily{-}{-}#1}} @@ -105,7 +106,7 @@ tool usage. \epigraph{What flavour is it?}{\textsc{Monty Python}} -\albatross\ takes a list of glyphs, separated by spaces, as input. Two formats +\albatross\ takes a list of glyphs, separated by spaces, as input. Three formats are supported by the command line tool: \begin{itemize}[label={--}] @@ -125,6 +126,15 @@ $ albatross 0xDF Note that the tool takes the value as case insensitive, e.g, \hex{DF} is equal to \hex{df} (or any case combination thereof). + +\item The glyph as a Unicode code point using the multiset union notation, e.g, +\uno{DF}. The \uno{} prefix is mandatory. + +\begin{Verbatim}[frame=single, fontsize=\small, framesep=3.5mm] +$ albatross U+DF +\end{Verbatim} + +Be mindful that this notation expects an uppercase \glyph{U}. \end{itemize} Formats can be used interchangeably. @@ -460,7 +470,15 @@ Source Initiative. \epigraph{How much is it?}{\textsc{Monty Python}} -\section*{0.3.0 (current)} +\section*{0.4.0 (current)} + +\begin{itemize}[label={--}] +\item Included support for the Unicode code point using the \uno{} multiset union +notation, which behaves exactly the same as the \hex{} counterpart. So \glyph{ß}, +\hex{DF} and \uno{DF} denote the same Unicode entity. +\end{itemize} + +\section*{0.3.0 (2021-01-13)} \subsection*{Changed} diff --git a/Master/texmf-dist/doc/support/albatross/version.tex b/Master/texmf-dist/doc/support/albatross/version.tex index 9325c3ccda9..60a2d3e96c8 100644 --- a/Master/texmf-dist/doc/support/albatross/version.tex +++ b/Master/texmf-dist/doc/support/albatross/version.tex @@ -1 +1 @@ -0.3.0 \ No newline at end of file +0.4.0 \ No newline at end of file diff --git a/Master/texmf-dist/scripts/albatross/albatross.jar b/Master/texmf-dist/scripts/albatross/albatross.jar index 3ffc544977c..df92afb94b0 100755 Binary files a/Master/texmf-dist/scripts/albatross/albatross.jar and b/Master/texmf-dist/scripts/albatross/albatross.jar differ diff --git a/Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zip b/Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zip deleted file mode 100644 index 05756e28b3c..00000000000 Binary files a/Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zip and /dev/null differ diff --git a/Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zip b/Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zip new file mode 100644 index 00000000000..010677c64dc Binary files /dev/null and b/Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zip differ -- cgit v1.2.3