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
54
55
56
57
58
59
60
|
.TH TG 1 2024-06-08
.SH name
tg \- TermGraph \- Text graphing utility
.SH SYNOPSIS
.B tg
[-s|--silent] [-l|--last-n \fIN\fR] [-h|--height \fIN\fR] [-w|--width \fIN\fR] [-t \fItype\fR]
.SH DESCRIPTION
.B tg
TermGraph is a utility for graphing
.SH OPTIONS
.IP "\fB-h, --help\fR"
Display help information.
.IP "\fB-s, --silent\fR"
Disable distracting elements, such as axis and non-graph text.
.IP "\fB-a, --ascii\fR"
Shorthand for -t ascii, if multiple options setting mode is specified,
the last will likely be respected.
.IP "\fB-b, --braille\fR"
Shorthand for -t braille, if multiple options setting mode is specified,
the last will likely be respected.
.IP "\fB-n, --last-n\fR \fIcount\fR"
If specified, only the newest \fIcount\fR samples will be plotted.
This can be useful if you want to follow the latest state of a graph that is piped in.
.IP "\fB-c, --cut\fR"
This is a special case of \fB--last-n\fR. Where the number of columns
\fB--width\fI will be used for the count.
.IP "\fB-t\fR \fItype\fR"
The type of graph to draw,
it defaults to \fBstar\fR, which is the fastest one.
Options are \fBstar\fR, \fBascii\fR and \fBbraille\fR.
Ascii is slightly prettier to look at.
.IP "\fB-w, --width\fR \fIwidth\fR"
Specify a width for the output.
If not specified, it will attempt to determine the TTY width and use that.
If it cannot be automatically determined, it will fail.
.IP "\fB-h, --height\fR \fIheight\fR"
Specify a height for the output.
If not specified, it will attempt to determine the TTY height and use that.
If it cannot be automatically determined, it will fail.
.SH EXAMPLES
The simplest version is if you have a text file of values
.PP
.nf
.RS
cat \fIfile\fR | tg
.RE
.fi
.PP
|
