diff options
Diffstat (limited to 'support/albatross')
-rw-r--r-- | support/albatross/README.md | 16 | ||||
-rw-r--r-- | support/albatross/doc/albatross-manual.pdf | bin | 78095 -> 79705 bytes | |||
-rw-r--r-- | support/albatross/doc/albatross-manual.tex | 39 | ||||
-rw-r--r-- | support/albatross/doc/albatross.1 | 4 | ||||
-rw-r--r-- | support/albatross/doc/version.tex | 2 |
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 Binary files differindex ec731e1f77..5953976a42 100644 --- a/support/albatross/doc/albatross-manual.pdf +++ b/support/albatross/doc/albatross-manual.pdf 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 |