summaryrefslogtreecommitdiff
path: root/support/albatross
diff options
context:
space:
mode:
Diffstat (limited to 'support/albatross')
-rw-r--r--support/albatross/README.md16
-rw-r--r--support/albatross/doc/albatross-manual.pdfbin78095 -> 79705 bytes
-rw-r--r--support/albatross/doc/albatross-manual.tex39
-rw-r--r--support/albatross/doc/albatross.14
-rw-r--r--support/albatross/doc/version.tex2
5 files changed, 55 insertions, 6 deletions
diff --git a/support/albatross/README.md b/support/albatross/README.md
index 9f411eb1d8..45c6bd543d 100644
--- a/support/albatross/README.md
+++ b/support/albatross/README.md
@@ -29,6 +29,7 @@ Options:
Set the default ANSI level
-b, --border-style [1|2|3|4|5|6]
Set the border style
+ -o, --or Look for each glyph separately
-V, --version Show the version and exit
-h, --help Show this message and exit
```
@@ -48,6 +49,21 @@ 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).
+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.
+For instance:
+
+- Look for fonts that contain both `a` and `b`:
+ ```bash
+ $ albatross a b
+ ```
+
+- Look for fonts that contain `a` and fonts that contain `b`, separately:
+ ```bash
+ $ albatross --or a b
+ ```
+
### Output
Albatross prints the results as a table. The default behaviour is to just
diff --git a/support/albatross/doc/albatross-manual.pdf b/support/albatross/doc/albatross-manual.pdf
index ec731e1f77..5953976a42 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 65f6000a31..ea0a689908 100644
--- a/support/albatross/doc/albatross-manual.tex
+++ b/support/albatross/doc/albatross-manual.tex
@@ -87,8 +87,9 @@ Options:
-d, --detailed Show a detailed font list
-a, --ansi-level [n|a16|a256|tc]
Set the default ANSI level
- -b, --border-style [1|2|2|3|4|5]
+ -b, --border-style [1|2|3|4|5|6]
Set the border style
+ -o, --or Look for each glyph separately
-V, --version Show the version and exit
-h, --help Show this message and exit
\end{Verbatim}
@@ -128,6 +129,26 @@ to \hex{df} (or any case combination thereof).
Formats can be used interchangeably.
+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 \shortopt{o} flag (or \longopt{or} for the long flag) to look for each glyph
+separately. For instance:
+
+\begin{itemize}[label={--}]
+\item Look for fonts that contain both \glyph{a} and \glyph{b}:
+
+\begin{Verbatim}[frame=single, fontsize=\small, framesep=3.5mm]
+$ albatross a b
+\end{Verbatim}
+
+\item Look for fonts that contain \glyph{a} and fonts that contain \glyph{b},
+separately:
+
+\begin{Verbatim}[frame=single, fontsize=\small, framesep=3.5mm]
+$ albatross --or a b
+\end{Verbatim}
+\end{itemize}
+
\section{Output}
\label{sec:output}
@@ -299,8 +320,6 @@ results to a terminal pager, e.g, the \command{less} utility:
$ albatross ß | less
\end{Verbatim}
-\newpage
-
\section{Coloured output}
\label{sec:colouredoutput}
@@ -441,7 +460,19 @@ Source Initiative.
\epigraph{How much is it?}{\textsc{Monty Python}}
-\section*{0.2.0 (current)}
+\section*{0.3.0 (current)}
+
+\subsection*{Changed}
+
+\begin{itemize}[label={--}]
+\item Conjunctive behavior is now default. Previously, \command{albatross a b}
+would have looked for fonts for \glyph{a} and separately for fonts for \glyph{b}.
+As we see more use cases for looking for fonts that contain \glyph{a} as well as
+\glyph{b}, we changed the default and left the previous behavior as
+\command{albatross --or a b}.
+\end{itemize}
+
+\section*{0.2.0 (2020-12-09)}
\subsection*{Added}
diff --git a/support/albatross/doc/albatross.1 b/support/albatross/doc/albatross.1
index 41b5e86f9a..1f50608e90 100644
--- a/support/albatross/doc/albatross.1
+++ b/support/albatross/doc/albatross.1
@@ -1,4 +1,4 @@
-.TH ALBATROSS 1 "09 December 2020" "v0.2.0"
+.TH ALBATROSS 1 "13 January 2021" "v0.3.0"
.SH NAME
albatross \- a tool for finding fonts that contain a given (Unicode) glyph.
.SH SYNOPSIS
@@ -28,6 +28,8 @@ Show a detailed font list
Set the default ANSI level
.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
diff --git a/support/albatross/doc/version.tex b/support/albatross/doc/version.tex
index 341cf11faf..9325c3ccda 100644
--- a/support/albatross/doc/version.tex
+++ b/support/albatross/doc/version.tex
@@ -1 +1 @@
-0.2.0 \ No newline at end of file
+0.3.0 \ No newline at end of file