summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-11-27 21:26:55 +0000
committerKarl Berry <karl@freefriends.org>2021-11-27 21:26:55 +0000
commitef1bc4682c35c6e499174db6cbaefbb1167e20cf (patch)
treeeddb35088a343d490bd965b2ad7001e4b935c144
parent511ac6e5b1a3cf5bf3ecdb3085625a22cf0287b0 (diff)
albatross (27nov21)
git-svn-id: svn://tug.org/texlive/trunk@61175 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/man/man1/albatross.139
-rw-r--r--Master/texmf-dist/doc/man/man1/albatross.man1.pdfbin18986 -> 19672 bytes
-rw-r--r--Master/texmf-dist/doc/support/albatross/README.md6
-rw-r--r--Master/texmf-dist/doc/support/albatross/albatross-manual.pdfbin79705 -> 80161 bytes
-rw-r--r--Master/texmf-dist/doc/support/albatross/albatross-manual.tex22
-rw-r--r--Master/texmf-dist/doc/support/albatross/version.tex2
-rwxr-xr-xMaster/texmf-dist/scripts/albatross/albatross.jarbin3131862 -> 2395011 bytes
-rw-r--r--Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zipbin6074 -> 0 bytes
-rw-r--r--Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zipbin0 -> 6245 bytes
9 files changed, 52 insertions, 17 deletions
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
--- a/Master/texmf-dist/doc/man/man1/albatross.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/albatross.man1.pdf
Binary files 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
--- a/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf
+++ b/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf
Binary files 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
--- a/Master/texmf-dist/scripts/albatross/albatross.jar
+++ b/Master/texmf-dist/scripts/albatross/albatross.jar
Binary files 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
--- a/Master/texmf-dist/source/support/albatross/albatross-0.3.0-src.zip
+++ /dev/null
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/source/support/albatross/albatross-0.4.0-src.zip
Binary files differ