-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathlingth.mdoc
96 lines (96 loc) · 2.54 KB
/
lingth.mdoc
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
91
92
93
94
95
96
.Dd $Mdocdate$
.Dt LINGTH 1
.Os
.Sh NAME
.Nm lingth
.Nd Identify lines longer than a given character length.
.Sh SYNOPSIS
.Nm lingth
.Op Fl chHlnp
.Op Fl m Ar num
.Op Fl t Ar num
.Op Ar
.Sh DESCRIPTION
The
.Nm
utility processes text and reports on lines that are longer than a given number
of characters. It's useful for keeping to coding standards which, for example,
specify an 80-character maximum.
.Pp
The command line options are as follows:
.Bl -tag -width Ds
.It Fl c
Don't show the content of each matching line.
.It Fl h
Don't show filenames alongside reported lines.
.It Fl H
Show filenames of all reported lines.
.It Fl l
Don't show the character length of reported lines.
.It Fl L
Show the character length of all reported lines.
.It Fl m Ar num
Set length limit. Any line containing more than
.Ar num
characters will be reported in the output.
.It Fl n
Don't show line numbers of reported lines.
.It Fl N
Print the line number of each reported line.
.It Fl p
Don't replace tabs with spaces.
.It Fl P
Replace leading tabs with spaces.
.It Fl Fl help
Print the help text and silently exit.
.It Fl t Ar num
Set tab width to
.Ar num
spaces. This option only affects leading tabs, each of which will be replaced by
the specified number of spaces, for length comparison only.
.El
.Pp
The following operands are available:
.Bl -tag -width indent
.It Ar file
The pathname of a file to be scanned for long lines. If no
.Ar file
arguments are specified, the standard input is used.
.El
.\" .Sh CONTEXT
.\" For section 9 functions only.
.\" .Sh IMPLEMENTATION NOTES
.\" Not used in OpenBSD.
.\" .Sh RETURN VALUES
.\" For sections 2, 3, and 9 function return values only.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev XDB_CONFIG_DIRS
A set of preference ordered base directories relative to which configuration files should be searched.
.It Ev XDG_CONFIG_HOME
A single base directory relative to which user-specific configuration files should be written.
.It Ev HOME
The pathname of the user's home directory.
.El
.Sh FILES
.Bl -tag -width Pa -compact
.It Pa config.json
Located in a configuration directory (see ENVIRONMENT), this file should contain a JSON object of configuration name/pairs.
.El
.Sh EXIT STATUS
.Ex -std
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
.\" .Sh ERRORS
.\" For sections 2, 3, 4, and 9 errno settings only.
.\" .Sh SEE ALSO
.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
.An Bobby Jack Aq Mt [email protected]
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS
.\" Not used in OpenBSD.