aboutsummaryrefslogtreecommitdiff
path: root/man/man1/fmt.1
blob: 511860018929bf36b0a23c49bea16f35a921017a (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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.TH FMT 1
.SH NAME
fmt, htmlfmt \- simple text formatters
.SH SYNOPSIS
.B fmt
[
.I option ...
]
[
.I file ...
]
.PP
.B htmlfmt
[
.B -a
] [
.B -c
.I charset
] [
.B -u
.I url
] [
.I file ...
]
.SH DESCRIPTION
.I Fmt
copies the given
.I files
(standard input by default)
to its standard output, filling and indenting lines.
The options are
.TP
.BI -l " n
Output line length is
.IR n ,
including indent (default 70).
.TP
.BI -w " n
A synonym for
.BR -l .
.TP
.BI -i " n
Indent
.I n
spaces (default 0).
.TP
.BI -j
Do not join short lines: only fold long lines.
.PP
Empty lines and initial white space in input lines are preserved.
Empty lines are inserted between input files.
.PP
.I Fmt
is idempotent: it leaves already formatted text unchanged.
.PP
.I Htmlfmt
performs a similar service, but accepts as input text formatted with
HTML tags.
It accepts
.IR fmt 's
.B -l
and
.B -w
flags and also:
.TP
.BI -a
Normally
.I htmlfmt
suppresses the contents of form fields and anchors (URLs and image files); this flag
causes it to print them, in square brackets.
.TP
.BI -c " charset
change the default character set from iso-8859-1 to
.IR charset .
This is the character set assumed if there isn't one
specified by the html itself in a <meta> directive.
.TP
.BI -u " url
Use
.I url
as the base URL for the document when displaying anchors; sets
.BI -a .
.SH SOURCE
.B /sys/src/cmd/fmt.c
.PP
.B /sys/src/cmd/htmlfmt
.SH BUGS
.I Htmlfmt
makes no attempt to render the two-dimensional geometry of tables;
it just treats the table entries as plain, to-be-formatted text.