IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > newform man page

newform man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





User Commands                                          newform(1)



NAME
     newform - change the format of a text file

SYNOPSIS
     newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an]
     [-f] [-cchar] [-ln] [filename...]

DESCRIPTION
     newform reads lines from the named filenames, or  the  stan-
     dard  input  if  no  input file is named, and reproduces the
     lines on the  standard  output.  Lines  are  reformatted  in
     accordance with command line options in effect.

     Except for -s, command line options may appear in any order,
     may  be  repeated, and may be intermingled with the optional
     filenames. Command line options are processed in  the  order
     specified.  This  means  that  option  sequences like ``-e15
     -l60'' will yield  results  different  from  ``-l60  -e15''.
     Options are applied to all filenames on the command line.

OPTIONS
     The following options are supported:

     -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 charac-
                     ters to the right of it are  discarded.  The
                     first tab is always discarded.

                     An error message and program exit will 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 of the
                     processed line.

                     For example, to convert a file with  leading
                     digits,  one  or more tabs, and text on each
                     line, to a file beginning with the text, all
                     tabs  after  the  first  expanded to spaces,
                     padded with spaces  out  to  column  72  (or
                     truncated  to  column  72),  and the leading
                     digits placed starting  at  column  73,  the
                     command would be:



                     newform -s -i -l -a -e filename



SunOS 5.10          Last change: 21 Jul 1997                    1






User Commands                                          newform(1)



     -itabspec       Input tab  specification:  expands  tabs  to
                     spaces,  according to the tab specifications
                     given. Tabspec recognizes all tab specifica-
                     tion  forms  described  in tabs(1). In addi-
                     tion, tabspec may be  -,  in  which  newform
                     assumes  that the tab specification is to be
                     found in the first line read from the  stan-
                     dard  input (see fspec(4)). If no tabspec is
                     given, tabspec defaults to -8. A tabspec  of
                     -0  expects  no tabs; if any are found, they
                     are treated as -1.



     -otabspec       Output tab specification: replaces spaces by
                     tabs,  according  to  the tab specifications
                     given. The tab specifications are  the  same
                     as  for  -itabspec.  If no tabspec is given,
                     tabspec defaults to  -8.  A  tabspec  of  -0
                     means  that  no  spaces will be converted to
                     tabs on output.



     -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 charac-
                     ters 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 filename



     -en             Same as -bn except that characters are trun-
                     cated from the end of the line.



     -pn             Prefix n  characters  (see  -cchar)  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.





SunOS 5.10          Last change: 21 Jul 1997                    2






User Commands                                          newform(1)



     -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 will contain the default  specifica-
                     tion of -8.



     -cchar          Change the prefix/append character to  char.
                     Default character for char is a space.



     -ln             Set the effective line length to  n  charac-
                     ters.  If  n  is not entered, -l defaults to
                     72. The default line length without  the  -l
                     option  is  80  characters.  Note:  Tabs and
                     backspaces are considered to be one  charac-
                     ter (use -i to expand tabs to spaces).

                     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.



OPERANDS
     The following operand is supported:

     filename        Input file



EXIT STATUS
     The following exit values are returned:

     0        Successful operation.



     1        Operation failed.





SunOS 5.10          Last change: 21 Jul 1997                    3






User Commands                                          newform(1)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWesu                     |
    |_____________________________|_____________________________|


SEE ALSO
     csplit(1), tabs(1), fspec(4), attributes(5)

DIAGNOSTICS
     All diagnostics are fatal.

     usage:  ...

         newform was called with a bad option.



     "not -s format"

         There was no tab on one line.



     "can't open file"

         Self-explanatory.



     "internal line too long"

         A line exceeds 512 characters after  being  expanded  in
         the internal work buffer.



     "tabspec in error"

         A tab specification is incorrectly formatted, or  speci-
         fied tab stops are not ascending.



     "tabspec indirection illegal"

         A tabspec read from a file (or standard input)  may  not
         contain  a tabspec referencing another file (or standard



SunOS 5.10          Last change: 21 Jul 1997                    4






User Commands                                          newform(1)



         input).



NOTES
     newform normally only keeps track  of  physical  characters;
     however,  for the -i and -o options, newform will keep track
     of backspaces in order to line up tabs  in  the  appropriate
     logical columns.

     newform will not prompt the user if a tabspec is to be  read
     from the standard input (by use of -i- or -o-).

     If the -f option is used, and the last -o  option  specified
     was  -o-, and was preceded by either a -o- or a -i-, the tab
     specification format line will be incorrect.







































SunOS 5.10          Last change: 21 Jul 1997                    5





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:25:07 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5334 hits)
(openSUSE 10.2)

svn man page (5208 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)

CPAN man page (4607 hits)
(Suse Linux 10.1)

ssh man page (4342 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2876 hits)
(Solaris 10 11_06)

netcat man page (2717 hits)
(Suse Linux 10.1)

pprosetup man page (2487 hits)
(Solaris 10 11_06)

startproc man page (2471 hits)
(Suse Linux 10.1)

signal man page (2407 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Summer Activities :: PCB CAD Design, UK :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum