sbase

suckless unix tools
git clone git://git.suckless.org/sbase
Log | Files | Refs | README | LICENSE

expand.1 (954B)


      1 .Dd October 8, 2015
      2 .Dt EXPAND 1
      3 .Os sbase
      4 .Sh NAME
      5 .Nm expand
      6 .Nd expand tabs to spaces
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl i
     10 .Op Fl t Ar tablist
     11 .Op Ar file ...
     12 .Sh DESCRIPTION
     13 .Nm
     14 converts tabs to spaces in each
     15 .Ar file
     16 as specified in
     17 .Ar tablist .
     18 If no file is given,
     19 .Nm
     20 reads from stdin.
     21 .Pp
     22 Backspace characters are preserved and decrement the column count
     23 for tab calculations.
     24 .Sh OPTIONS
     25 .Bl -tag -width Ds
     26 .It Fl i
     27 Only expand tabs at the beginning of lines, i.e. expand each
     28 line until a character different from '\et' and ' ' is reached.
     29 .It Fl t Ar tablist
     30 Specify tab size or tabstops.
     31 .Ar tablist
     32 is a list of one (in the former case) or multiple (in the latter case)
     33 strictly positive integers separated by ' ' or ','.
     34 .Pp
     35 The default
     36 .Ar tablist
     37 is "8".
     38 .El
     39 .Sh SEE ALSO
     40 .Xr fold 1 ,
     41 .Xr unexpand 1
     42 .Sh STANDARDS
     43 The
     44 .Nm
     45 utility is compliant with the
     46 .St -p1003.1-2013
     47 specification.
     48 .Pp
     49 The
     50 .Op Fl i
     51 flag is an extension to that specification.