


      FFFFSSSSPPPPEEEECCCC((((4444))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   FFFFSSSSPPPPEEEECCCC((((4444))))



      NNNNAAAAMMMMEEEE
           fspec - format specification in text files

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           It is sometimes convenient to maintain text files on the
           UNIX System with non-standard tabs, (i.e., 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:

             tttt_t_a_b_s    The tttt parameter specifies the tab settings for
                      the file.  The value of _t_a_b_s must be one of the
                      following:

                        1. a list of column numbers separated by
                           commas, indicating tabs set at the specified
                           columns;

                        2. a ---- followed immediately by an integer _n,
                           indicating tabs at intervals of _n columns;

                        3. a ---- followed by the name of a ``canned'' tab
                           specification.

                      Standard tabs are specified by tttt----8888, or
                      equivalently, tttt1111,,,,9999,,,,11117777,,,,22225555,,,,etc.  The canned tabs
                      which are recognized are defined by the _t_a_b_s(1)
                      command.

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

             mmmm_m_a_r_g_i_n  The mmmm parameter specifies a number of spaces to
                      be prepended to each line.  The value of _m_a_r_g_i_n
                      must be an integer.

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



      Page 1                                                   (9010-E)






      FFFFSSSSPPPPEEEECCCC((((4444))))                    ((((UUUUNNNNIIIIXXXX 5555....0000))))                   FFFFSSSSPPPPEEEECCCC((((4444))))



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

           Default values, which are assumed for parameters not
           supplied, are tttt----8888 and mmmm0000.  If the ssss parameter is not
           specified, no size checking is performed.  If the first line
           of a file does not contain a format specification, the above
           defaults are assumed for the entire file.  The following is
           an example of a line containing a format specification:

                 * <:t5,10,15 s72:> *

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

           Several UNIX System commands correctly interpret the format
           specification for a file.  Among them is _g_a_t_h (see _s_e_n_d(1C))
           which may be used to convert files to a standard format
           acceptable to other UNIX System commands.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           ed(1), newform(1), send(1C), tabs(1).































      Page 2                                                   (9010-E)



