manuals, sum-down, radix

1 files changed, 41 insertions, 0 deletions

diff --git a/man/man1/spt.1 b/man/man1/spt.1
new file mode 100644
index 0000000..ba1d8d5
--- /dev/null
+++ b/man/man1/spt.1
@@ -0,0 +1,41 @@
+.TH spt 1 2022-05-27 utils
+
+.SH NAME
+spt \- single pass tabulate
+
+.SH SYNOPSIS
+.B spt
+
+.SH DESCRIPTION
+.B spt
+reads a grid-aligned table from stdin
+and outputs the same data on stdout
+as tab-separated values.
+
+Only the first line is used to guess where in the grid
+are the column separators.
+Any sequence of more than one blank character
+is taken to separate columns, so if in the first line
+two colum values happen to be separated by a single space,
+.B spt
+will guess wrong.
+
+.RB ( vd (1)
+uses the first 1000 lines, which is a lot safer,
+but with grid separated values there can be no guarantee.)
+
+In addition, if the input data contains tabs already,
+those are not escaped, but preserved.
+If that is a problem, you'll need to escape them beforehand, for example using
+.BR sed (1)
+like so:
+.RS
+.BI sed \ 's:\et:\e\et:g'
+.RE
+
+.SH EXAMPLES
+.B spt
+.RI <\  grid-table\  >\  table.tsv
+
+.SH SEE ALSO
+.BR col (1),\  vd (1)