| 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)
|
