File: coreutils.info, Node: unexpand invocation, Prev: expand invocation, Up: 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 *note 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.
As a GNU extension the last TAB specified can be prefixed with a
'/' to indicate a tab size to use for remaining positions. For
example, '--tabs=2,4,/8' will set tab stops at position 2 and 4,
and every multiple of 8 after that.
Also the last TAB specified can be prefixed with a '+' to indicate
a tab size to use for remaining positions, offset from the final
explicitly specified tab stop. For example, to ignore the 1
character gutter present in diff output, one can specify a 1
character offset using '--tabs=1,+8', which will set tab stops at
positions 1,9,17,...
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.