--- sh.table 2004/01/01 16:54:20 1.19
+++ sh.table 2004/02/12 16:06:27 1.20
@@ -1,7 +1,6 @@
##
## table -- Pretty-print a field-separated list as a table
## Copyright (c) 1998-2004 Ralf S. Engelschall <rse@engelschall.com>
-## Originally written for Apache
##
## This file is part of shtool and free software; you can redistribute
## it and/or modify it under the terms of the GNU General Public
@@ -87,3 +86,68 @@
}"
IFS="$OIFS"
+shtool_exit 0
+
+##
+## manual page
+##
+
+=pod
+
+=head1 NAME
+
+B<shtool table> - B<GNU shtool> pretty-print a field-separated list
+
+=head1 SYNOPSIS
+
+B<shtool table>
+[B<-F>|B<--field-sep> I<sep>]
+[B<-w>|B<--width> I<width>]
+[B<-c>|B<--columns> I<cols>]
+[B<-s>|B<--strip> I<strip>]
+I<str>B<sep>I<str>...
+
+=head1 DESCRIPTION
+
+This pretty-prints a list of strings as a table.
+
+=head1 OPTIONS
+
+The following command line options are available.
+
+=over 4
+
+=item B<-F>, B<--field-sep> I<sep>
+
+Separate columns using I<sep>. Default is C<:>.
+
+=item B<-w>, B<--width> I<width>
+
+Width of each column. Default is 15 characters.
+
+=item B<-c>, B<--columns> I<cols>
+
+Number of columns. Default is C<3>.
+
+=item B<-s>, B<--strip> I<strip>
+
+Strip off any characters past I<strip>. Default is C<79>.
+
+=back
+
+=head1 EXAMPLE
+
+ # shell script
+ shtool table -F , -w 5 -c 4 "1,2,3,4,5,6,7,8,9,10,11,12"
+
+=head1 HISTORY
+
+The B<GNU shtool> B<table> command was originally written by Ralf S.
+Engelschall E<lt>rse@engelschall.comE<gt> in 1999 for B<GNU shtool>.
+
+=head1 SEE ALSO
+
+shtool(1), tr(1), fmt(1), sh(1), awk(1), sed(1).
+
+=cut
+
|
