| 1 |
.\" RCSid "$Id: neaten.1,v 1.1 2004/01/01 19:31:45 greg Exp $" |
| 2 |
.TH NEATEN 1 11/15/93 RADIANCE |
| 3 |
.SH NAME |
| 4 |
neaten - neaten up output columns |
| 5 |
.SH SYNOPSIS |
| 6 |
.B neaten |
| 7 |
[ |
| 8 |
.B format |
| 9 |
] |
| 10 |
.SH DESCRIPTION |
| 11 |
.I Neaten |
| 12 |
reads from its standard input and neatens up columns separated |
| 13 |
by white space using the specified format. |
| 14 |
The format is a string consisting of a positive integer followed |
| 15 |
by an alignment character and another integer. |
| 16 |
The alignment character is usually a decimal point ('.'), but it can |
| 17 |
be any non-digit. |
| 18 |
.PP |
| 19 |
The alignment character is used as the central point of each column. |
| 20 |
The total column field width will be the number to the |
| 21 |
left of the alignment character plus one for the alignment character |
| 22 |
itself plus the number to the right of the alignment character. |
| 23 |
.PP |
| 24 |
If a field does not contain the alignment character, it will be |
| 25 |
printed to the left of where the alignment character would have |
| 26 |
appeared. |
| 27 |
If a field is too long to print within the specified format, the entire |
| 28 |
field will be printed and that row will not be aligned with the rest. |
| 29 |
.PP |
| 30 |
The default format is "8.8". |
| 31 |
.SH EXAMPLE |
| 32 |
To examine a file with columns of numbers: |
| 33 |
.IP "" .2i |
| 34 |
neaten 10.8 < input | more |
| 35 |
.SH BUGS |
| 36 |
Columns wider than the total width of the format specification |
| 37 |
will be printed without any separating white space. |
| 38 |
.PP |
| 39 |
The program does not do anything special with tabs on the input. |
| 40 |
.SH AUTHOR |
| 41 |
Greg Ward |
| 42 |
.SH "SEE ALSO" |
| 43 |
cnt(1), rcalc(1), rcollate(1), rlam(1), total(1) |
