ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.6)
_______________________________________________________________________________
    tf [-l <n>] [-r <n>] [-c] [-b] [-p]
    "text flow"
    
    DESCRIPTION:
        The 'tf' command rearranges text in two ways:
        
            tf -l n -r n [-b]
                Rearrange  the  text  in  the specified region so that all text
                within the region will appear  between  the  specific  margins.
                The  text  is  treated  as  one single line and then split into
                portions that each fit within the  specified  margins.   Splits
                take  place  only  where  blanks and tabs are found.  Lines are
                left-justified. 
                
                The only instance in  which  text  might  end  up  outside  the
                specified  margins  is when a single 'token' (that is, a string
                of characters containing neither  blanks  nor  tabs)  has  more
                characters  than  can possibly fit between the two margins.  In
                such cases, the token is aligned with the left margin and  will
                exceed the right margin. 
                
                '-l  n'  and '-r n' are both optional.  If '-l' is included, it
                must be accompanied by 'n' or an error  message  is  displayed.
                If  '-l'  is  omitted,  column 1 is assumed as the left margin.
                If -'r' is included, it must be accompanied by 'n' or an  error
                message  is  displayed.  If '-r' is omitted, no right margin is
                assumed.  Omitting the right margin has the  effect  of  simply
                aligning the affected text lines along the left margin. 
                
                This  form  of  the  command  also accepts a '-b' option, which
                instructs ce to insert blanks into lines so that all lines  end
                up being both left and right justified. 
                
            tf -l n -r n [-c]
                This  form  of  the  command  instructs  ce to center each line
                relative to the specified margins.  '-l' and '-r'  are  treated
                as  above.   Lines  are  never  split  or  joined with the '-c'
                option.  If a line's length exceeds the width  defined  by  the
                margins, the line is simply left-justified. 
        
        If  a  rectangular  region  is  highlighted, tf moves all text on lines
        that are highlighted into the highlighted region.  Text that exists  to
        the  left  or  the  right  of a rectangular highlighted region is still
        included in the tf operation. 
    
    ARGUMENTS:
        -b
           Balance.  Left and right justify the text.

        -c 
           Center.  Center each line of text between the start and end

        -l <n>
           Specifies  the  left  column number.  Defaults to column  1  unless
           rectangular  highlighting  is in effect.  Rectangular  highlighting
           takes precedence over -l.

        -r <n>
           Specifies  the right  column number.  Defaults to column  72 unless
           rectangular  highlighting  is in effect.  Rectangular  highlighting
           takes precedence over -r.

        -p 
           Press  out multiple blanks into single blanks before beginning  the
           text flow operation.  Useful for re-text flowing.

    RELATED HELP FILES:
        bl            (Balance)              
        case          (Change Case)          
        untab         (Remove Tabs)          
        ww            (Window Wrap)          

        support       (customer support)     

_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.