mdoc version three
[unix-history] / usr / src / usr.bin / expand / expand.1
index 886400f..fae0438 100644 (file)
@@ -1,54 +1,61 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
 .\"
 .\"
-.\"    @(#)expand.1    4.1 (Berkeley) %G%
+.\" %sccs.include.redist.roff%
 .\"
 .\"
-.TH EXPAND 1
-.UC 4
-.SH NAME
-expand, unexpand \- expand tabs to spaces, and vice versa
-.SH SYNOPSIS
-.B expand
-[
-\-tabstop
-] [
-\-tab1,tab2,...,tabn
-] [
-file ...
-]
-.br
-.B unexpand
-[
-.B \-a
-] [
-file ...
-]
-.SH DESCRIPTION
-.I Expand
+.\"    @(#)expand.1    6.7 (Berkeley) %G%
+.\"
+.Dd 
+.Dt EXPAND 1
+.Os BSD 4
+.Sh NAME
+.Nm expand ,
+.Nm unexpand
+.Nd expand tabs to spaces, and vice versa
+.Sh SYNOPSIS
+.Nm expand
+.Op Fl Ns Ar tabstop
+.Op Fl Ns Ar tab1,tab2,...,tabn
+.Ar
+.Nm unexpand
+.Op Fl a
+.Ar
+.Sh DESCRIPTION
+.Nm Expand
 processes the named files or the standard input writing
 the standard output with tabs changed into blanks.
 Backspace characters are preserved into the output and decrement
 the column count for tab calculations.
 processes the named files or the standard input writing
 the standard output with tabs changed into blanks.
 Backspace characters are preserved into the output and decrement
 the column count for tab calculations.
-.I Expand
+.Nm Expand
 is useful for pre-processing character files
 (before sorting, looking at specific columns, etc.) that
 contain tabs.
 is useful for pre-processing character files
 (before sorting, looking at specific columns, etc.) that
 contain tabs.
-.PP
+.Pp
 If a single
 If a single
-.I tabstop
-argument is given then tabs are set
-.I tabstop
+.Ar tabstop
+argument is given, then tabs are set
+.Ar tabstop
 spaces apart instead of the default 8.
 If multiple tabstops are given then the tabs are set at those
 specific columns.
 spaces apart instead of the default 8.
 If multiple tabstops are given then the tabs are set at those
 specific columns.
-.PP
-.I Unexpand
+.Pp
+.Nm Unexpand
 puts tabs back into the data from the standard input or the named
 files and writes the result on the standard output.
 puts tabs back into the data from the standard input or the named
 files and writes the result on the standard output.
-By default only leading blanks and tabs
+.Pp
+Option (with
+.Nm unexpand
+only):
+.Bl -tag -width flag
+.It Fl a
+By default, only leading blanks and tabs
 are reconverted to maximal strings of tabs.  If the
 are reconverted to maximal strings of tabs.  If the
-.B \-a
+.Fl a
 option is given, then tabs are inserted whenever they would compress the
 resultant file by replacing two or more characters.
 option is given, then tabs are inserted whenever they would compress the
 resultant file by replacing two or more characters.
-.SH BUGS
+.El
+.Sh HISTORY
+The
+.Nm expand
+command appeared in
+.Bx 3.0 .