First commit1.0

Signed-off-by: Mattias Andrée <m@maandree.se>

1 files changed, 51 insertions, 0 deletions

diff --git a/semicolons.1 b/semicolons.1
new file mode 100644
index 0000000..a3cd082
--- /dev/null
+++ b/semicolons.1
@@ -0,0 +1,51 @@
+.TH SEMICOLONS 1 SEMICOLONS
+.SH NAME
+semicolons - count number of semicolons in code
+
+.SH SYNOPSIS
+.B semicolons
+[-s]
+.RI [ file "] ..."
+
+.SH DESCRIPTION
+.B semicolons
+counts the number of semicolons in code for each specified
+file.
+.B semicolons
+will treat each file as a C source code or
+C header file. If
+.I file
+is
+.BR - ,
+or if a
+.I file
+is not specified, the standard input is read.
+.PP
+If more than one file is specified, each successfully
+processed file will have its line count output in the format
+.RS
+.nf
+
+\fB\(dq%s:%*s%zu\en\(dq,\fP <\fIfile\fP>\fB,\fP <\fIsome positive integer\fP>\fB, \(dq\(dq,\fP <\fI#semicolons in code\fP>
+
+.fi
+.RE
+The total for all processed files is printed on the last line
+with the format
+.RS
+.nf
+
+\fB\(dq%zu\en\(dq,\fP <\fItotal #semicolons in code\fP>
+
+.fi
+.RE
+If exactly one or no files are specified, this will be the
+only line output.
+
+.SH OPTIONS
+.TP
+.B -s
+Only output the last line. (The total over all files.)
+
+.SH SEE ALSO
+.BR braces (1)