(coreutils.info.gz) unexpand invocation

Info Catalog

(coreutils.info.gz) expand invocation

(coreutils.info.gz) Operating on characters

 
 9.3 'unexpand': Convert spaces to tabs
 ======================================
 
 'unexpand' writes the contents of each given FILE, or standard input if
 none are given or for a FILE of '-', to standard output, converting
 blanks at the beginning of each line into as many tab characters as
 needed.  In the default POSIX locale, a "blank" is a space or a tab;
 other locales may specify additional blank characters.  Synopsis:
 
      unexpand [OPTION]... [FILE]...
 
    By default, 'unexpand' converts only initial blanks (those that
 precede all non-blank characters) on each line.  It preserves backspace
 characters in the output; they decrement the column count for tab
 calculations.  By default, tabs are set at every 8th column.
 
    The program accepts the following options.  Also see  Common
 options.
 
 '-t TAB1[,TAB2]...'
 '--tabs=TAB1[,TAB2]...'
      If only one tab stop is given, set the tabs TAB1 columns apart
      instead of the default 8.  Otherwise, set the tabs at columns TAB1,
      TAB2, ... (numbered from 0), and leave blanks beyond the tab stops
      given unchanged.  Tab stops can be separated by blanks as well as
      by commas.  This option implies the '-a' option.
 
      For compatibility, GNU 'unexpand' supports the obsolete option
      syntax, '-TAB1[,TAB2]...', where tab stops must be separated by
      commas.  (Unlike '-t', this obsolete option does not imply '-a'.)
      New scripts should use '--first-only -t TAB1[,TAB2]...' instead.
 
 '-a'
 '--all'
      Also convert all sequences of two or more blanks just before a tab
      stop, even if they occur after non-blank characters in a line.
 
    An exit status of zero indicates success, and a nonzero value
 indicates failure.
 

Info Catalog

(coreutils.info.gz) expand invocation

(coreutils.info.gz) Operating on characters