| 1 | 
greg | 
1.2 | 
.\" RCSid "$Id: neaten.1,v 1.1 2004/01/01 19:31:45 greg Exp $" | 
| 2 | 
greg | 
1.1 | 
.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 | 
greg | 
1.2 | 
cnt(1), rcalc(1), rcollate(1), rlam(1), total(1) |