summaryrefslogtreecommitdiff
path: root/util/sbase/expand.1
diff options
context:
space:
mode:
Diffstat (limited to 'util/sbase/expand.1')
-rw-r--r--util/sbase/expand.147
1 files changed, 47 insertions, 0 deletions
diff --git a/util/sbase/expand.1 b/util/sbase/expand.1
new file mode 100644
index 00000000..9cf20fb4
--- /dev/null
+++ b/util/sbase/expand.1
@@ -0,0 +1,47 @@
+.Dd October 8, 2015
+.Dt EXPAND 1
+.Os sbase
+.Sh NAME
+.Nm expand
+.Nd expand tabs to spaces
+.Sh SYNOPSIS
+.Nm
+.Op Fl i
+.Op Fl t Ar tablist
+.Op Ar file ...
+.Sh DESCRIPTION
+.Nm
+converts tabs to spaces in each
+.Ar file
+as specified in
+.Ar tablist .
+If no file is given,
+.Nm
+reads from stdin.
+.Pp
+Backspace characters are preserved and decrement the column count
+for tab calculations.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl i
+Only expand tabs at the beginning of lines, i.e. expand each
+line until a character different from '\et' and ' ' is reached.
+.It Fl t Ar tablist
+Specify tab size or tabstops.
+.Ar tablist
+is a list of one (in the former case) or multiple (in the latter case)
+strictly positive integers separated by ' ' or ','.
+.Pp
+The default
+.Ar tablist
+is "8".
+.El
+.Sh SEE ALSO
+.Xr fold 1 ,
+.Xr unexpand 1
+.Sh STANDARDS
+POSIX.1-2013.
+.Pp
+The
+.Op Fl i
+flag is an extension to that specification.