HP-UX Reference (11i v2 03/08) - 1 User Commands N-Z (vol 2)

n
newform(1) newform(1)
NAME
newform - change or reformat a text file
SYNOPSIS
newform [-i tabspec ][-o tabspec ][
-l n ][-b n ][-e n ][-c char ][
-p n ][-a n ][-f][-s]
[ files ]
DESCRIPTION
newform reads lines from the named files, or the standard input if no input file is named, and repro-
duces the lines on the standard output. Lines are reformatted in accordance with command line options
in effect.
Except for
-s, command line options can appear in any order, can be repeated, and can be intermingled
with the optional files. Command line options are processed in the order specified. This means that
option sequences such as -e 15 -l 60
yield results different from -l 60 -e 15. Options are
applied to all files on the command line.
Options
newform recognizes the following options:
-itabspec Input tab specification: expands tabs to spaces, according to the tab specifications
given. Tabspec recognizes all tab specification forms described in tabs(1). In addi-
tion, tabspec can be
--, in which newform assumes that the tab specification is to
be found in the first line read from the standard input (see fspec (4)). If no tabspec
is given, tabspec defaults to
-8.Atabspec of -0 expects no tabs; if any are found,
they are treated as -1.
-otabspec Output tab specification: replaces spaces with tabs, according to the tab
specifications given. The tab specifications are the same as for -itabspec.Ifno
tabspec is given, tabspec defaults to
-8.Atabspec of -0 means that no spaces will
be converted to tabs on output.
-ln Set the effective line length to n characters. If n is not entered,
-l defaults to 72.
The default line length without the
-l option is 80 characters. Note that tabs and
backspaces are treated as single characters (use -i to expand tabs to spaces).
-bn Truncate n characters from the beginning of the line when the line length is greater
than the effective line length (see -ln). Default is to truncate the number of char-
acters necessary to obtain the effective line length. The default value is used when
-b with no n is used. This option can be used to delete the sequence numbers from
a COBOL program as follows:
newform -l1 -b7 file-name
The
-l1 must be used to set the effective line length shorter than any existing line
in the file so that the -b option is activated.
-en Same as -bn except that characters are truncated from the end of the line.
-ck Change the prefix/append character to k. Default character for k is a space.
-pn Prefix n characters (see -ck) to the beginning of a line when the line length is less
than the effective line length. Default is to prefix the number of characters neces-
sary to obtain the effective line length.
-an Same as -pn except characters are appended to the end of a line.
-f Write the tab specification format line on the standard output before any other lines
are output. The tab specification format line which is printed will correspond to the
format specified in the last -o option. If no -o option is specified, the line which
is printed contains the default specification of -8.
-s Shears off leading characters on each line up to the first tab and places up to 8 of
the sheared characters at the end of the line. If more than 8 characters (not count-
ing the first tab) are sheared, the eighth character is replaced by a * and any char-
acters to the right of it are discarded. The first tab is always discarded.
An error message and program exit occur if this option is used on a file without a
tab on each line. The characters sheared off are saved internally until all other
options specified are applied to that line. The characters are then added at the end
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1−−579