diff options
Diffstat (limited to '')
| -rw-r--r-- | text-utils/col.1 | 163 | ||||
| -rw-r--r-- | text-utils/col.1.adoc | 135 |
2 files changed, 298 insertions, 0 deletions
diff --git a/text-utils/col.1 b/text-utils/col.1 new file mode 100644 index 0000000..5b6a5a5 --- /dev/null +++ b/text-utils/col.1 @@ -0,0 +1,163 @@ +'\" t +.\" Title: col +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.15 +.\" Date: 2022-05-11 +.\" Manual: User Commands +.\" Source: util-linux 2.38.1 +.\" Language: English +.\" +.TH "COL" "1" "2022-05-11" "util\-linux 2.38.1" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.ss \n[.ss] 0 +.nh +.ad l +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} +.SH "NAME" +col \- filter reverse line feeds from input +.SH "SYNOPSIS" +.sp +\fBcol\fP \fIoptions\fP +.SH "DESCRIPTION" +.sp +\fBcol\fP filters out reverse (and half\-reverse) line feeds so the output is in the correct order, with only forward and half\-forward line feeds. It also replaces any whitespace characters with tabs where possible. This can be useful in processing the output of \fBnroff\fP(1) and \fBtbl\fP(1). +.sp +\fBcol\fP reads from standard input and writes to standard output. +.SH "OPTIONS" +.sp +\fB\-b\fP, \fB\-\-no\-backspaces\fP +.RS 4 +Do not output any backspaces, printing only the last character written to each column position. +.RE +.sp +\fB\-f\fP, \fB\-\-fine\fP +.RS 4 +Permit half\-forward line feeds. Normally characters destined for a half\-line boundary are printed on the following line. +.RE +.sp +\fB\-h\fP, \fB\-\-tabs\fP +.RS 4 +Output tabs instead of multiple spaces. +.RE +.sp +\fB\-l\fP, \fB\-\-lines\fP \fInumber\fP +.RS 4 +Buffer at least \fInumber\fP lines in memory. By default, 128 lines are buffered. +.RE +.sp +\fB\-p\fP, \fB\-\-pass\fP +.RS 4 +Force unknown control sequences to be passed through unchanged. Normally \fBcol\fP will filter out any control sequences other than those recognized and interpreted by itself, which are listed below. +.RE +.sp +\fB\-x\fP, \fB\-\-spaces\fP +.RS 4 +Output multiple spaces instead of tabs. +.RE +.sp +\fB\-h\fP, \fB\-\-help\fP +.RS 4 +Display help text and exit. +.RE +.sp +\fB\-V\fP, \fB\-\-version\fP +.RS 4 +Print version and exit. +.RE +.SH "CONFORMING TO" +.sp +The \fBcol\fP utility conforms to the Single UNIX Specification, Version 2. The \fB\-l\fP option is an extension to the standard. +.SH "NOTES" +.sp +The control sequences for carriage motion that \fBcol\fP understands and their decimal values are listed in the following table: +.sp +\fBESC\-7\fP +.RS 4 +reverse line feed (escape then 7) +.RE +.sp +\fBESC\-8\fP +.RS 4 +half reverse line feed (escape then 8) +.RE +.sp +\fBESC\-9\fP +.RS 4 +half forward line feed (escape then 9) +.RE +.sp +\fBbackspace\fP +.RS 4 +moves back one column (8); ignored in the first column +.RE +.sp +\fBnewline\fP +.RS 4 +forward line feed (10); also does carriage return +.RE +.sp +\fBcarriage return\fP +.RS 4 +(13) +.RE +.sp +\fBshift in\fP +.RS 4 +shift to normal character set (15) +.RE +.sp +\fBshift out\fP +.RS 4 +shift to alternate character set (14) +.RE +.sp +\fBspace\fP +.RS 4 +moves forward one column (32) +.RE +.sp +\fBtab\fP +.RS 4 +moves forward to next tab stop (9) +.RE +.sp +\fBvertical tab\fP +.RS 4 +reverse line feed (11) +.RE +.sp +All unrecognized control characters and escape sequences are discarded. +.sp +\fBcol\fP keeps track of the character set as characters are read and makes sure the character set is correct when they are output. +.sp +If the input attempts to back up to the last flushed line, \fBcol\fP will display a warning message. +.SH "HISTORY" +.sp +A \fBcol\fP command appeared in Version 6 AT&T UNIX. +.SH "SEE ALSO" +.sp +\fBexpand\fP(1), +\fBnroff\fP(1), +\fBtbl\fP(1) +.SH "REPORTING BUGS" +.sp +For bug reports, use the issue tracker at \c +.URL "https://github.com/util\-linux/util\-linux/issues" "" "." +.SH "AVAILABILITY" +.sp +The \fBcol\fP command is part of the util\-linux package which can be downloaded from \c +.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file diff --git a/text-utils/col.1.adoc b/text-utils/col.1.adoc new file mode 100644 index 0000000..cb9790f --- /dev/null +++ b/text-utils/col.1.adoc @@ -0,0 +1,135 @@ +//po4a: entry man manual +//// +Copyright (c) 1990 The Regents of the University of California. +All rights reserved. + +This code is derived from software contributed to Berkeley by +Michael Rendell. + +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. + + @(#)col.1 6.8 (Berkeley) 6/17/91 +//// += col(1) +:doctype: manpage +:man manual: User Commands +:man source: util-linux {release-version} +:page-layout: base +:command: col + +== NAME + +col - filter reverse line feeds from input + +== SYNOPSIS + +*col* _options_ + +== DESCRIPTION + +*col* filters out reverse (and half-reverse) line feeds so the output is in the correct order, with only forward and half-forward line feeds. It also replaces any whitespace characters with tabs where possible. This can be useful in processing the output of *nroff*(1) and *tbl*(1). + +*col* reads from standard input and writes to standard output. + +== OPTIONS + +*-b*, *--no-backspaces*:: +Do not output any backspaces, printing only the last character written to each column position. + +*-f*, *--fine*:: +Permit half-forward line feeds. Normally characters destined for a half-line boundary are printed on the following line. + +*-h*, *--tabs*:: +Output tabs instead of multiple spaces. + +*-l*, *--lines* _number_:: +Buffer at least _number_ lines in memory. By default, 128 lines are buffered. + +*-p*, *--pass*:: +Force unknown control sequences to be passed through unchanged. Normally *col* will filter out any control sequences other than those recognized and interpreted by itself, which are listed below. + +*-x*, *--spaces*:: +Output multiple spaces instead of tabs. + +include::man-common/help-version.adoc[] + +== CONFORMING TO + +The *col* utility conforms to the Single UNIX Specification, Version 2. The *-l* option is an extension to the standard. + +== NOTES + +The control sequences for carriage motion that *col* understands and their decimal values are listed in the following table: + +*ESC-7*:: +reverse line feed (escape then 7) +*ESC-8*:: +half reverse line feed (escape then 8) +*ESC-9*:: +half forward line feed (escape then 9) +*backspace*:: +moves back one column (8); ignored in the first column +*newline*:: +forward line feed (10); also does carriage return +*carriage return*:: +(13) +*shift in*:: +shift to normal character set (15) +*shift out*:: +shift to alternate character set (14) +*space*:: +moves forward one column (32) +*tab*:: +moves forward to next tab stop (9) +*vertical tab*:: +reverse line feed (11) + +All unrecognized control characters and escape sequences are discarded. + +*col* keeps track of the character set as characters are read and makes sure the character set is correct when they are output. + +If the input attempts to back up to the last flushed line, *col* will display a warning message. + +== HISTORY + +A *col* command appeared in Version 6 AT&T UNIX. + +== SEE ALSO + +*expand*(1), +*nroff*(1), +*tbl*(1) + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] |