summaryrefslogtreecommitdiff
path: root/support/albatross/doc/albatross.1
blob: 4a7b32397ac42d361a88daf727b83cbc0cf8bf2b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
.TH ALBATROSS 1 "27 January 2023" "v0.5.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.
Three formats are supported:
.IP #1
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., \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]"
Set the default ANSI level
.IP "\fB--border-style\fP [0|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
.
.SH BUGS
Issue tracker at
.UR https://gitlab.com/islandoftex/albatross/-/issues
.UE .