diff options
Diffstat (limited to 'usr.bin/rs/rs.1')
-rw-r--r-- | usr.bin/rs/rs.1 | 197 |
1 files changed, 0 insertions, 197 deletions
diff --git a/usr.bin/rs/rs.1 b/usr.bin/rs/rs.1 deleted file mode 100644 index 07de48c..0000000 --- a/usr.bin/rs/rs.1 +++ /dev/null @@ -1,197 +0,0 @@ -.\" Copyright (c) 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)rs.1 8.2 (Berkeley) 12/30/93 -.\" -.TH RS 1 "December 30, 1993" -.UC 4 -.SH NAME -rs \- reshape a data array -.SH SYNOPSIS -\fBrs [ \-[csCS][\fRx\fB][kKgGw][\fRN\fB]tTeEnyjhHm ] [ \fRrows\fB [ \fRcols\fB ] ]\fR -.SH DESCRIPTION -.I Rs -reads the standard input, interpreting each line as a row -of blank-separated entries in an array, -transforms the array according to the options, -and writes it on the standard output. -With no arguments it transforms stream input into a columnar -format convenient for terminal viewing. -.PP -The shape of the input array is deduced from the number of lines -and the number of columns on the first line. -If that shape is inconvenient, a more useful one might be -obtained by skipping some of the input with the \fB\-k\fP option. -Other options control interpretation of the input columns. -.PP -The shape of the output array is influenced by the -.I rows -and -.I cols -specifications, which should be positive integers. -If only one of them is a positive integer, -.I rs -computes a value for the other which will accommodate -all of the data. -When necessary, missing data are supplied in a manner -specified by the options and surplus data are deleted. -There are options to control presentation of the output columns, -including transposition of the rows and columns. -.PP -The options are described below. -.IP \fB\-c\fRx -Input columns are delimited by the single character \fIx\fP. -A missing \fIx\fP is taken to be `^I'. -.IP \fB\-s\fRx -Like \fB\-c\fR, but maximal strings of \fIx\fP are delimiters. -.IP \fB\-C\fRx -Output columns are delimited by the single character \fIx\fP. -A missing \fIx\fP is taken to be `^I'. -.IP \fB\-S\fRx -Like \fB\-C\fR, but padded strings of \fIx\fP are delimiters. -.IP \fB\-t\fR -Fill in the rows of the output array using the columns of the -input array, that is, transpose the input while honoring any -.I rows -and -.I cols -specifications. -.IP \fB\-T\fR -Print the pure transpose of the input, ignoring any -.I rows -or -.I cols -specification. -.IP \fB\-k\fRN -Ignore the first \fIN\fR lines of input. -.IP \fB\-K\fRN -Like \fB\-k\fR, but print the ignored lines. -.IP \fB\-g\fRN -The gutter width (inter-column space), normally 2, is taken to be \fIN\fR. -.IP \fB\-G\fRN -The gutter width has \fIN\fR percent of the maximum -column width added to it. -.IP \fB\-e\fR -Consider each line of input as an array entry. -.IP \fB\-n\fR -On lines having fewer entries than the first line, -use null entries to pad out the line. -Normally, missing entries are taken from the next line of input. -.IP \fB\-y\fR -If there are too few entries to make up the output dimensions, -pad the output by recycling the input from the beginning. -Normally, the output is padded with blanks. -.IP \fB\-h\fR -Print the shape of the input array and do nothing else. -The shape is just the number of lines and the number of -entries on the first line. -.IP \fB\-H\fR -Like \fB\-h\fR, but also print the length of each line. -.IP \fB\-j\fR -Right adjust entries within columns. -.IP \fB\-w\fRN -The width of the display, normally 80, is taken to be the positive -integer \fIN\fP. -.IP \fB\-m\fR -Do not trim excess delimiters from the ends of the output array. -.PP -With no arguments, -.I rs -transposes its input, and assumes one array entry per input line -unless the first non-ignored line is longer than the display width. -Option letters which take numerical arguments interpret a missing -number as zero unless otherwise indicated. -.SH EXAMPLES -.de IC -.IP -.ss 36 -.ft B -.. -.de NC -.br -.ss 12 -.PP -.. -.I Rs -can be used as a filter to convert the stream output -of certain programs (e.g., -.IR spell , -.IR du , -.IR file , -.IR look , -.IR nm , -.IR who , -and -.IR wc (1)) -into a convenient ``window'' format, as in -.IC -who | rs -.NC -This function has been incorporated into the -.IR ls (1) -program, though for most programs with similar output -.I rs -suffices. -.PP -To convert stream input into vector output and back again, use -.IC -rs 1 0 | rs 0 1 -.NC -A 10 by 10 array of random numbers from 1 to 100 and -its transpose can be generated with -.IC -jot \-r 100 | rs 10 10 | tee array | rs \-T > tarray -.NC -In the editor -.IR vi (1), -a file consisting of a multi-line vector with 9 elements per line -can undergo insertions and deletions, -and then be neatly reshaped into 9 columns with -.IC -:1,$!rs 0 9 -.NC -Finally, to sort a database by the first line of each 4-line field, try -.IC -rs \-eC 0 4 | sort | rs \-c 0 1 -.NC -.SH SEE ALSO -jot(1), vi(1), sort(1), pr(1) -.SH BUGS -Handles only two dimensional arrays. - -The algorithm currently reads the whole file into memory, -so files that do not fit in memory will not be reshaped. - -Fields cannot be defined yet on character positions. - -Re-ordering of columns is not yet possible. - -There are too many options. |