albatross (13jan21)

git-svn-id: svn://tug.org/texlive/trunk@57416 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 52 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/support/albatross/README.md b/Master/texmf-dist/doc/support/albatross/README.md
index 9f411eb1d82..45c6bd543d2 100644
--- a/Master/texmf-dist/doc/support/albatross/README.md
+++ b/Master/texmf-dist/doc/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/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf b/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf
index ec731e1f771..5953976a421 100644
--- a/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf
+++ b/Master/texmf-dist/doc/support/albatross/albatross-manual.pdf
diff --git a/Master/texmf-dist/doc/support/albatross/albatross-manual.tex b/Master/texmf-dist/doc/support/albatross/albatross-manual.tex
index 65f6000a31e..ea0a689908b 100644
--- a/Master/texmf-dist/doc/support/albatross/albatross-manual.tex
+++ b/Master/texmf-dist/doc/support/albatross/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/Master/texmf-dist/doc/support/albatross/version.tex b/Master/texmf-dist/doc/support/albatross/version.tex
index 341cf11faf9..9325c3ccda9 100644
--- a/Master/texmf-dist/doc/support/albatross/version.tex
+++ b/Master/texmf-dist/doc/support/albatross/version.tex
@@ -1 +1 @@
-0.2.0
\ No newline at end of file
+0.3.0
\ No newline at end of file