version 1.9, 2003/07/14 12:51:48 |
version 1.10, 2005/05/15 01:36:13 |
|
|
.\" $OpenBSD$ |
.\" $OpenBSD$ |
|
.\" $FreeBSD: src/usr.bin/rs/rs.1,v 1.4 1999/08/28 01:05:21 peter Exp $ |
.\" |
.\" |
.\" Copyright (c) 1993 |
.\" Copyright (c) 1993 |
.\" The Regents of the University of California. All rights reserved. |
.\" The Regents of the University of California. All rights reserved. |
|
|
.\" SUCH DAMAGE. |
.\" SUCH DAMAGE. |
.\" |
.\" |
.\" @(#)rs.1 8.2 (Berkeley) 12/30/93 |
.\" @(#)rs.1 8.2 (Berkeley) 12/30/93 |
.\" $FreeBSD: src/usr.bin/rs/rs.1,v 1.4 1999/08/28 01:05:21 peter Exp $ |
|
.\" |
.\" |
.Dd December 30, 1993 |
.Dd December 30, 1993 |
.Dt RS 1 |
.Dt RS 1 |
|
|
.Nd reshape a data array |
.Nd reshape a data array |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm rs |
.Nm rs |
.Oo |
.Op Fl CcSs Ns Op Ar x |
.Sm off |
.Op Fl KkGgw Ar N |
.Xo Fl Oo Op Cm csCS |
.Op Fl EejHhnnTtyz |
.Op Ar x |
|
.Op Cm kKgGw |
|
.Op Ar N |
|
.Cm tTeEnyjhHmz Oc |
|
.Xc |
|
.Oc |
|
.Sm on |
|
.Op Ar rows Op Ar cols |
.Op Ar rows Op Ar cols |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl c Ns Ar x |
.It Fl C Ns Ar x |
Input columns are delimited by the single character |
Output columns are delimited by the single character |
.Ar x . |
.Ar x . |
A missing |
A missing |
.Ar x |
.Ar x |
is taken to be |
is taken to be |
.Ql ^I . |
.Ql ^I . |
.It Fl s Ns Ar x |
.It Fl c Ns Ar x |
Like |
Input columns are delimited by the single character |
.Fl c , |
|
but maximal strings of |
|
.Ar x |
|
are delimiters. |
|
.It Fl C Ns Ar x |
|
Output columns are delimited by the single character |
|
.Ar x . |
.Ar x . |
A missing |
A missing |
.Ar x |
.Ar x |
is taken to be |
is taken to be |
.Ql ^I . |
.Ql ^I . |
|
.It Fl E |
|
Consider each character of input as an array entry. |
|
.It Fl e |
|
Consider each line of input as an array entry. |
|
.It Fl G Ns Ar N |
|
The gutter width has |
|
.Ar N |
|
percent of the maximum column width added to it. |
|
.It Fl g Ns Ar N |
|
The gutter width (inter-column space), normally 2, is taken to be |
|
.Ar N . |
|
.It Fl H |
|
Like |
|
.Fl h , |
|
but also print the length of each line. |
|
.It Fl h |
|
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. |
|
.It Fl j |
|
Right adjust entries within columns. |
|
.It Fl K Ns Ar N |
|
Like |
|
.Fl k , |
|
but print the ignored lines. |
|
.It Fl k Ns Ar N |
|
Ignore the first |
|
.Ar N |
|
lines of input. |
|
.It Fl m |
|
Do not trim excess delimiters from the ends of the output array. |
|
.It Fl n |
|
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. |
.It Fl S Ns Ar x |
.It Fl S Ns Ar x |
Like |
Like |
.Fl C , |
.Fl C , |
but padded strings of |
but padded strings of |
.Ar x |
.Ar x |
are delimiters. |
are delimiters. |
|
.It Fl s Ns Ar x |
|
Like |
|
.Fl c , |
|
but maximal strings of |
|
.Ar x |
|
are delimiters. |
.It Fl t |
.It Fl t |
Fill in the rows of the output array using the columns of the |
Fill in the rows of the output array using the columns of the |
input array, that is, transpose the input while honoring any |
input array, that is, transpose the input while honoring any |
|
|
or |
or |
.Ar cols |
.Ar cols |
specification. |
specification. |
.It Fl k Ns Ar N |
.It Fl w Ns Ar N |
Ignore the first |
The width of the display, normally 80, is taken to be the positive |
.Ar N |
integer |
lines of input. |
|
.It Fl K Ns Ar N |
|
Like |
|
.Fl k , |
|
but print the ignored lines. |
|
.It Fl g Ns Ar N |
|
The gutter width (inter-column space), normally 2, is taken to be |
|
.Ar N . |
.Ar N . |
.It Fl G Ns Ar N |
|
The gutter width has |
|
.Ar N |
|
percent of the maximum column width added to it. |
|
.It Fl e |
|
Consider each line of input as an array entry. |
|
.It Fl E |
|
Consider each character of input as an array entry. |
|
.It Fl n |
|
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. |
|
.It Fl y |
.It Fl y |
If there are too few entries to make up the output dimensions, |
If there are too few entries to make up the output dimensions, |
pad the output by recycling the input from the beginning. |
pad the output by recycling the input from the beginning. |
Normally, the output is padded with blanks. |
Normally, the output is padded with blanks. |
.It Fl h |
|
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. |
|
.It Fl H |
|
Like |
|
.Fl h , |
|
but also print the length of each line. |
|
.It Fl j |
|
Right adjust entries within columns. |
|
.It Fl w Ns Ar N |
|
The width of the display, normally 80, is taken to be the positive |
|
integer |
|
.Ar N . |
|
.It Fl m |
|
Do not trim excess delimiters from the ends of the output array. |
|
.It Fl z |
.It Fl z |
Adapt column widths to fit the largest entries appearing in them. |
Adapt column widths to fit the largest entries appearing in them. |
.El |
.El |