| 1 | greg | 1.1 | .\" RCSid "$Id$" | 
| 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), rlam(1), total(1) |