home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d747 / aush.lha / AUSH / ExtraCmds.lha / englishdocs / newform.doc < prev    next >
Text File  |  1992-09-04  |  3KB  |  81 lines
  1. NAME
  2.     newform - change the format of a text file
  3.  
  4. SYNOPSIS
  5.     newform [-s][-in][-on][-bn][-en][-pn][-an][-ck][-ln][-z][files...]
  6.  
  7. DESCRIPTION
  8.     newform reads lines from the named files, or the standard input  if
  9.     no input file is named, and reproduces the lines  on  the  standard
  10.     output. Lines are  reformatted    in  accordance    with  command  line
  11.     options in effect. Except for -s, command line options    may  appear
  12.     in any order,  and  may  be  repeated.    Command  line  options    are
  13.     processed in the order specified, this means that option  sequences
  14.     like "-e15 -l60" will yield results different from "-l60 -e15".
  15.     Options are applied to all  files  on  the  command  line.  If    you
  16.     specify "-" as a file name, standard input will be used.
  17.  
  18.     -s    Shears off leading characters on each line up to the  first
  19.         tab and places up to 8 of the sheared characters at the end
  20.         of the line. If more than 8 characters    (not  counting  the
  21.         first tab) are sheared, the eighth character is replaced by
  22.         a * and any characters to the right of    it  are  discarded.
  23.         The first tab is always discarded.
  24.         An error message and program exit will occur if this option
  25.         is used on a file without a tab on each line.  The  sheared
  26.         off characters are saved internally until all other options
  27.         specified are applied to that line. The characters are then
  28.         added at the end of the processed line.
  29.  
  30.     -in    Input tab specification : expands tabs to spaces, according
  31.         to the given tab width. n may be 0 to stop tab expansion.
  32.  
  33.     -on    Output    tab  specification  :  replaces  spaces  by   tabs,
  34.         according to the given tab width. n may be 0 to stop  space
  35.         conversion on output.
  36.  
  37.     -bn    Truncate n characters from the beginning of the  line  when
  38.         the line length is greater than the effective  line  length
  39.         (see -l). Default is to truncate the number  of  characters
  40.         necessary to obtain the effective line length. The  default
  41.         value is used when -b with no n is used.
  42.  
  43.     -en    Same as -bn except that characters are truncated  from    the
  44.         end of the line.
  45.  
  46.     -pn    Prefix n characters (see -c) to the  beginning  of  a  line
  47.         when the line  length  is  less  than  the  effective  line
  48.         length. Default is  to    prefix    the  number  of  characters
  49.         necessary to obtain the effective line length.
  50.  
  51.     -an    Same as -pn except characters are appended to the end of  a
  52.         line.
  53.  
  54.     -ck    Change the prefix/append character to k. Default  character
  55.         is a space. If k is missing, space is assumed.
  56.  
  57.     -ln    Set the effective line length to n characters. If n is    not
  58.         entered, -l defaults to 80. The default line length without
  59.         the -l    option    is  80    characters.   Note  that  tabs    are
  60.         considered to be one character (use -i to  expand  tabs  to
  61.         spaces).
  62.  
  63.     -z    Delete spaces and tabs at the beginning of a line.
  64.  
  65. RETURN CODES
  66.     0 if all went well
  67.     1 in case of bad argument (fatal)
  68.     2 if at least one file couldn't be opened (non fatal)
  69.     13 if there's no tab in an input line with -s option (fatal)
  70.  
  71. CHANGES FROM UNIX VERSION
  72.     -f option not supported
  73.     n cannot be -- for -i and -o option
  74.     added -z option
  75.  
  76. AUTHOR
  77.     Denis GOUNELLE
  78.     Last modified 04-Sep-92
  79.  
  80.  
  81.