summaryrefslogtreecommitdiff
path: root/support/albatross
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-11-28 03:00:45 +0000
committerNorbert Preining <norbert@preining.info>2021-11-28 03:00:45 +0000
commita7512cfe1987a97f46fbcaa7f90fe40356b24be5 (patch)
tree9484c3c3678e6a8da6c697697de35d678578e8c0 /support/albatross
parent96c2fb76825a51e1a74de35b2af34d4027342780 (diff)
CTAN sync 202111280300
Diffstat (limited to 'support/albatross')
-rw-r--r--support/albatross/README.md6
-rw-r--r--support/albatross/doc/albatross-manual.pdfbin79705 -> 80161 bytes
-rw-r--r--support/albatross/doc/albatross-manual.tex22
-rw-r--r--support/albatross/doc/albatross.139
-rw-r--r--support/albatross/doc/version.tex2
5 files changed, 52 insertions, 17 deletions
diff --git a/support/albatross/README.md b/support/albatross/README.md
index 45c6bd543d..1f00d4325f 100644
--- a/support/albatross/README.md
+++ b/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/support/albatross/doc/albatross-manual.pdf b/support/albatross/doc/albatross-manual.pdf
index 5953976a42..8f69bd48d2 100644
--- a/support/albatross/doc/albatross-manual.pdf
+++ b/support/albatross/doc/albatross-manual.pdf
Binary files differ
diff --git a/support/albatross/doc/albatross-manual.tex b/support/albatross/doc/albatross-manual.tex
index ea0a689908..1a3c2c5b21 100644
--- a/support/albatross/doc/albatross-manual.tex
+++ b/support/albatross/doc/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/support/albatross/doc/albatross.1 b/support/albatross/doc/albatross.1
index 1f50608e90..bc866cc693 100644
--- a/support/albatross/doc/albatross.1
+++ b/support/albatross/doc/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/support/albatross/doc/version.tex b/support/albatross/doc/version.tex
index 9325c3ccda..60a2d3e96c 100644
--- a/support/albatross/doc/version.tex
+++ b/support/albatross/doc/version.tex
@@ -1 +1 @@
-0.3.0 \ No newline at end of file
+0.4.0 \ No newline at end of file