Adding upstream version 2.38.1.upstream/2.38.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 135 insertions, 0 deletions

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::[]