19b50d902SRodney W. Grimes.\" Copyright (c) 1990, 1993 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" This code is derived from software contributed to Berkeley by 59b50d902SRodney W. Grimes.\" Michael Rendell. 69b50d902SRodney W. Grimes.\" 79b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 89b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 99b50d902SRodney W. Grimes.\" are met: 109b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 119b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 129b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 139b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 149b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 159b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 169b50d902SRodney W. Grimes.\" must display the following acknowledgement: 179b50d902SRodney W. Grimes.\" This product includes software developed by the University of 189b50d902SRodney W. Grimes.\" California, Berkeley and its contributors. 199b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 209b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 219b50d902SRodney W. Grimes.\" without specific prior written permission. 229b50d902SRodney W. Grimes.\" 239b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 249b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 259b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 269b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 279b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 289b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 299b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 309b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 319b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 329b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 339b50d902SRodney W. Grimes.\" SUCH DAMAGE. 349b50d902SRodney W. Grimes.\" 359b50d902SRodney W. Grimes.\" @(#)col.1 8.1 (Berkeley) 6/29/93 36c3aac50fSPeter Wemm.\" $FreeBSD$ 379b50d902SRodney W. Grimes.\" 389b50d902SRodney W. Grimes.Dd June 29, 1993 399b50d902SRodney W. Grimes.Dt COL 1 409b50d902SRodney W. Grimes.Os 419b50d902SRodney W. Grimes.Sh NAME 429b50d902SRodney W. Grimes.Nm col 439b50d902SRodney W. Grimes.Nd filter reverse line feeds from input 449b50d902SRodney W. Grimes.Sh SYNOPSIS 458fe908efSRuslan Ermilov.Nm 46844518ffSMike Heffner.Op Fl bfhpx 479b50d902SRodney W. Grimes.Op Fl l Ar num 489b50d902SRodney W. Grimes.Sh DESCRIPTION 493898680cSPhilippe CharnierThe 503898680cSPhilippe Charnier.Nm 513898680cSPhilippe Charnierutility filters out reverse (and half reverse) line feeds so that the output is 529b50d902SRodney W. Grimesin the correct order with only forward and half forward line 539b50d902SRodney W. Grimesfeeds, and replaces white-space characters with tabs where possible. 549b50d902SRodney W. GrimesThis can be useful in processing the output of 559b50d902SRodney W. Grimes.Xr nroff 1 569b50d902SRodney W. Grimesand 579b50d902SRodney W. Grimes.Xr tbl 1 . 589b50d902SRodney W. Grimes.Pp 593898680cSPhilippe CharnierThe 603898680cSPhilippe Charnier.Nm 613898680cSPhilippe Charnierutility reads from the standard input and writes to the standard output. 629b50d902SRodney W. Grimes.Pp 639b50d902SRodney W. GrimesThe options are as follows: 64a292105aSPhilippe Charnier.Bl -tag -width indent 659b50d902SRodney W. Grimes.It Fl b 669b50d902SRodney W. GrimesDo not output any backspaces, printing only the last character 679b50d902SRodney W. Grimeswritten to each column position. 689b50d902SRodney W. Grimes.It Fl f 699b50d902SRodney W. GrimesForward half line feeds are permitted (``fine'' mode). 709b50d902SRodney W. GrimesNormally characters printed on a half line boundary are printed 719b50d902SRodney W. Grimeson the following line. 7243d665c0SDima Dorfman.It Fl h 7343d665c0SDima DorfmanDon't output multiple spaces instead of tabs (default). 74844518ffSMike Heffner.It Fl p 75844518ffSMike HeffnerForce unknown control sequences to be passed through unchanged. 76844518ffSMike HeffnerNormally, 77844518ffSMike Heffner.Nm 78844518ffSMike Heffnerwill filter out any control sequences from the input other than those 79844518ffSMike Heffnerrecognized and interpreted by itself, which are listed below. 809b50d902SRodney W. Grimes.It Fl x 819b50d902SRodney W. GrimesOutput multiple spaces instead of tabs. 829b50d902SRodney W. Grimes.It Fl l Ar num 839b50d902SRodney W. GrimesBuffer at least 849b50d902SRodney W. Grimes.Ar num 859b50d902SRodney W. Grimeslines in memory. 869b50d902SRodney W. GrimesBy default, 128 lines are buffered. 879b50d902SRodney W. Grimes.El 889b50d902SRodney W. Grimes.Pp 899b50d902SRodney W. GrimesThe control sequences for carriage motion that 90a292105aSPhilippe Charnier.Nm 919b50d902SRodney W. Grimesunderstands and their decimal values are listed in the following 929b50d902SRodney W. Grimestable: 939b50d902SRodney W. Grimes.Pp 949b50d902SRodney W. Grimes.Bl -tag -width "carriage return" -compact 959b50d902SRodney W. Grimes.It ESC\-7 969b50d902SRodney W. Grimesreverse line feed (escape then 7) 979b50d902SRodney W. Grimes.It ESC\-8 989b50d902SRodney W. Grimeshalf reverse line feed (escape then 8) 999b50d902SRodney W. Grimes.It ESC\-9 1009b50d902SRodney W. Grimeshalf forward line feed (escape then 9) 1019b50d902SRodney W. Grimes.It backspace 1029b50d902SRodney W. Grimesmoves back one column (8); ignored in the first column 1039b50d902SRodney W. Grimes.It carriage return 1049b50d902SRodney W. Grimes(13) 1059b50d902SRodney W. Grimes.It newline 1069b50d902SRodney W. Grimesforward line feed (10); also does carriage return 1079b50d902SRodney W. Grimes.It shift in 1089b50d902SRodney W. Grimesshift to normal character set (15) 1099b50d902SRodney W. Grimes.It shift out 1109b50d902SRodney W. Grimesshift to alternate character set (14) 1119b50d902SRodney W. Grimes.It space 1129b50d902SRodney W. Grimesmoves forward one column (32) 1139b50d902SRodney W. Grimes.It tab 1149b50d902SRodney W. Grimesmoves forward to next tab stop (9) 1159b50d902SRodney W. Grimes.It vertical tab 1169b50d902SRodney W. Grimesreverse line feed (11) 1179b50d902SRodney W. Grimes.El 1189b50d902SRodney W. Grimes.Pp 1199b50d902SRodney W. GrimesAll unrecognized control characters and escape sequences are 1209b50d902SRodney W. Grimesdiscarded. 1219b50d902SRodney W. Grimes.Pp 1223898680cSPhilippe CharnierThe 1233898680cSPhilippe Charnier.Nm 1243898680cSPhilippe Charnierutility keeps track of the character set as characters are read and makes 1259b50d902SRodney W. Grimessure the character set is correct when they are output. 1269b50d902SRodney W. Grimes.Pp 1279b50d902SRodney W. GrimesIf the input attempts to back up to the last flushed line, 128a292105aSPhilippe Charnier.Nm 1299b50d902SRodney W. Grimeswill display a warning message. 1309b50d902SRodney W. Grimes.Sh SEE ALSO 1319b50d902SRodney W. Grimes.Xr expand 1 , 1329b50d902SRodney W. Grimes.Xr nroff 1 , 1339b50d902SRodney W. Grimes.Xr tbl 1 134debb1842STim J. Robbins.Sh STANDARDS 135debb1842STim J. RobbinsThe 136debb1842STim J. Robbins.Nm 137debb1842STim J. Robbinsutility conforms to 138debb1842STim J. Robbins.St -susv2 . 1399b50d902SRodney W. Grimes.Sh HISTORY 1409b50d902SRodney W. GrimesA 141a292105aSPhilippe Charnier.Nm 1429b50d902SRodney W. Grimescommand 1430f778506SMike Pritchardappeared in 1440f778506SMike Pritchard.At v6 . 145