summaryrefslogtreecommitdiff
path: root/support/albatross
diff options
context:
space:
mode:
Diffstat (limited to 'support/albatross')
-rw-r--r--support/albatross/doc/albatross-manual.pdfbin76990 -> 78095 bytes
-rw-r--r--support/albatross/doc/albatross-manual.tex17
-rw-r--r--support/albatross/doc/albatross.138
-rw-r--r--support/albatross/doc/version.tex2
-rw-r--r--support/albatross/scripts/albatross.sh2
5 files changed, 56 insertions, 3 deletions
diff --git a/support/albatross/doc/albatross-manual.pdf b/support/albatross/doc/albatross-manual.pdf
index e03ff5d2f6..ec731e1f77 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 6c23400735..65f6000a31 100644
--- a/support/albatross/doc/albatross-manual.tex
+++ b/support/albatross/doc/albatross-manual.tex
@@ -441,7 +441,22 @@ Source Initiative.
\epigraph{How much is it?}{\textsc{Monty Python}}
-\section*{1.0.0 (current)}
+\section*{0.2.0 (current)}
+
+\subsection*{Added}
+
+\begin{itemize}[label={--}]
+\item Inclusion of a man page.
+\end{itemize}
+
+\subsection*{Fixed}
+
+\begin{itemize}[label={--}]
+\item Windows paths were incorrectly parsed, causing font names and styles to be
+displayed incorrectly.
+\end{itemize}
+
+\section*{0.1.0 (2020-12-07)}
\begin{itemize}[label={--}]
\item Initial release.
diff --git a/support/albatross/doc/albatross.1 b/support/albatross/doc/albatross.1
new file mode 100644
index 0000000000..41b5e86f9a
--- /dev/null
+++ b/support/albatross/doc/albatross.1
@@ -0,0 +1,38 @@
+.TH ALBATROSS 1 "09 December 2020" "v0.2.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.
+.PP
+Albatross takes a list of glyphs as input. Two formats are supported:
+.IP #1
+The glyph itself, e.g, ß (Eszett).
+Internally, the tool will convert 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).
+.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]
+Set the default ANSI level
+.IP \fB--border-style\fP [1|2|3|4|5|6]
+Set the border style
+.IP \fB--version\fP
+Show the version and exit
+.IP \fB--help\fP
+Show a help message and exit.
+.SH BUGS
+Issue tracker at
+.UR https://gitlab.com/islandoftex/albatross/-/issues
+.UE .
diff --git a/support/albatross/doc/version.tex b/support/albatross/doc/version.tex
index 6c6aa7cb09..341cf11faf 100644
--- a/support/albatross/doc/version.tex
+++ b/support/albatross/doc/version.tex
@@ -1 +1 @@
-0.1.0 \ No newline at end of file
+0.2.0 \ No newline at end of file
diff --git a/support/albatross/scripts/albatross.sh b/support/albatross/scripts/albatross.sh
index 323713ca4b..4c636c6a03 100644
--- a/support/albatross/scripts/albatross.sh
+++ b/support/albatross/scripts/albatross.sh
@@ -14,4 +14,4 @@ if echo "$kernel" | grep CYGWIN >/dev/null; then
jarpath=`cygpath -w "$jarpath"`
fi
-exec java -jar "$jarpath" "$@" \ No newline at end of file
+exec java -jar "$jarpath" "$@"