version 1.8, 2003/06/03 02:56:07 |
version 1.9, 2003/10/27 12:24:11 |
|
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm expand |
.Nm expand |
.Op Fl Ns Ar tabstop |
.Op Fl Ns Ar tabstop |
.Op Fl Ns Ar tab1 , tab2 , ... , tabn |
.Oo Xo |
|
.Sm off |
|
.Fl Ar tab1 , tab2 , |
|
.Ar ... , Ar tabn |
|
.Sm on |
|
.Oc |
|
.Xc |
.Op Ar file Ar ... |
.Op Ar file Ar ... |
|
.Nm expand |
|
.Op Fl t Ar tabstop |
|
.Oo Xo |
|
.Sm off |
|
.Fl t\ \& Ar tab1 , tab2 , |
|
.Ar ... , Ar tabn |
|
.Sm on |
|
.Oc |
|
.Xc |
|
.Op Ar file Ar ... |
.Nm unexpand |
.Nm unexpand |
.Op Fl a |
.Op Fl a |
.Op Ar file Ar ... |
.Op Ar file Ar ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm expand |
.Nm expand |
processes the named files or the standard input writing |
processes the named files or the standard input, |
the standard output with tabs changed into blanks. |
writing the standard output with tabs changed into blanks. |
Backspace characters are preserved into the output and decrement |
Backspace characters are preserved into the output and decrement |
the column count for tab calculations. |
the column count for tab calculations. |
.Nm expand |
.Nm expand |
|
|
argument is given, tabs are set |
argument is given, tabs are set |
.Ar tabstop |
.Ar tabstop |
spaces apart instead of the default 8. |
spaces apart instead of the default 8. |
If multiple tabstops are given then the tabs are set at those |
If multiple tabstops are given, then the tabs are set at those |
specific columns. |
specific columns. |
|
In the synopsis above, both forms of the |
|
.Nm |
|
command are identical. |
.Pp |
.Pp |
|
If a list of tabstops is given, it should consist of a list |
|
of two or more positive decimal integers, in ascending order. |
|
In the event of having to process a |
|
.Aq tab |
|
at a position beyond the last of those specified in a multiple tabstop list, |
|
the |
|
.Aq tab |
|
is replaced by a single |
|
.Aq space |
|
character. |
|
.Pp |
.Nm unexpand |
.Nm unexpand |
puts tabs back into the data from the standard input or the named |
puts tabs back into the data from the standard input or the named |
files and writes the result on the standard output. |
files and writes the result on the standard output. |
|
|
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr fold 1 |
.Xr fold 1 |
|
.Sh STANDARDS |
|
The |
|
.Nm |
|
and |
|
.Nm unexpand |
|
utilities are compliant with the |
|
.St -p1003.1 |
|
specification, with the following exceptions: |
|
.Bl -bullet -offset indent |
|
.It |
|
.Tn POSIX |
|
does not support specifying tabstops without use of the |
|
.Fl t |
|
flag (first form in |
|
.Sx SYNOPSIS |
|
above). |
|
.It |
|
.Tn POSIX |
|
specifies that multiple tabstops may be given separated by |
|
commas or blanks. |
|
This implementation supports only comma-separated tabstops. |
|
.It |
|
.Nm unexpand |
|
does not recognise the |
|
.Fl t |
|
flag. |
|
.El |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
.Nm expand |
.Nm expand |