fspec(F)


fspec -- format specification in text files

Format

<:[d][e][mmargin][ssize][ttabs]:>

Description

It is sometimes convenient to maintain text files on the UNIX system with non-standard tabs, (that is, tabs which are not set at every eighth column). Such files must generally be converted to a standard format, frequently by replacing all tabs with the appropriate number of spaces, before they can be processed by UNIX system commands. A format specification occurring in the first line of a text file specifies how tabs are to be expanded in the remainder of the file.

A format specification consists of a sequence of parameters separated by blanks and surrounded by the brackets <: and :>. Each parameter consists of a keyletter, possibly followed immediately by a value. The following parameters are recognized:


d
The d parameter takes no value. Its presence indicates that the line containing the format specification is to be deleted from the converted file.

If a format specification can be disguised as a comment, it is not necessary to code the d parameter.


e
The e parameter takes no value. Its presence indicates that the current format is to prevail only until another format specification is encountered in the file.

mmargin
The m parameter specifies a number of spaces to be prepended to each line. The value of margin must be an integer.

ssize
The s parameter specifies a maximum line size. The value of size must be an integer. Size checking is performed after the tabs have been expanded, but before the margin is prepended.

ttabs
The t parameter specifies the tab settings for the file. The value of tabs must be one of the following:

Standard tabs are specified by t-8, or equivalently, t1,9,17,25, and so on. The canned tabs that are recognized are defined by the tabs command.

Default values, which are assumed for parameters not supplied, are t-8 and m0. If the s parameter is not specified, no size checking is performed. If the first line of a file does not contain a format specification, these defaults are assumed for the entire file.

Examples

The following is an example of a line containing a format specification:
   /* <:t5,10,15 s72:> */

See also

ed(C), newform(C), tabs(C)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005