bin/47205: expand.1 man page enhancements

[Matthew Mondor <mm_lists%pulsar-zone.net@localhost>]

>Number:         47205
>Category:       bin
>Synopsis:       expand.1 man page enhancements
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sat Nov 17 05:25:01 +0000 2012
>Originator:     Matthew Mondor
>Release:        -current, netbsd-6
>Organization:
>Environment:
System: NetBSD ninja.xisop 6.0_STABLE NetBSD 6.0_STABLE (GENERIC_MM) #0: Mon 
Nov 5 19:32:57 EST 2012 
root@ninja.xisop:/usr/obj/sys/arch/amd64/compile/GENERIC_MM amd64
Architecture: x86_64
Machine: amd64
>Description:
        Someone on IRC (wolfpython) thought the documentation for -t
        was ambiguous, and when I checked I also did; he also thinks
        the new wording is clearer (feel free to review and suggest
        alternatives).
>How-To-Repeat:
>Fix:
        Suggested patch attached (against revision 1.12/current)
--MP_/JxIW_W+EJjeh4C_jxwgyYm_
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename=expand-diff.txt

--- expand.1.orig       2012-11-16 22:49:45.000000000 -0500
+++ expand.1    2012-11-16 22:48:41.000000000 -0500
@@ -56,26 +56,27 @@
 (before sorting, looking at specific columns, etc.) that
 contain tabs.
 .Pp
-If a single
-.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.
-.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.
 .Pp
-Option (with
-.Nm unexpand
-only):
+Options:
+.Bl -tag -width flag
+.It Fl t
+Unlike offsets in spaces, tapstops represent tabulator column
+positions.  The default
+.Ar tabstop
+width is 8, but can be changed using
+.Fl t
+with a single argument.  When multiple arguments are supplied, the
+multiple tabulator characters in a line will be expanded accordingly
+to the supplied column positions, respectively.
+.El
 .Bl -tag -width flag
 .It Fl a
-By default, only leading blanks and tabs
-are reconverted to maximal strings of tabs.
-If the
+.Nm ( unexpand
+only): By default, only leading blanks and tabs are reconverted to
+maximal strings of tabs.  If the
 .Fl a
 option is given, then tabs are inserted whenever they would compress the
 resultant file by replacing two or more characters.

--MP_/JxIW_W+EJjeh4C_jxwgyYm_--

>Unformatted:
 --MP_/JxIW_W+EJjeh4C_jxwgyYm_
 Content-Type: text/plain; charset=US-ASCII
 Content-Transfer-Encoding: 7bit
 Content-Disposition: inline