manual/gnumaniak/original/man1/unexpand.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU unexpand man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH UNEXPAND 1 "7 October 2002" "GNU textutils 2.1"
  15 .SH NAME
  16 \fBunexpand\fR \- convert spaces to tabs
  17 .SH SYNOPSIS
  18 .B unexpand
  19 .RB [ \-a ]
  20 .RB [ \-\fITAB1\fR[\fB,\fITAB2... ]
  21 .RB [ "\-t \fITAB1\fR[\fB,\fITAB2..." ]
  22 .RB [ \-\-all ]
  23 .RB [ \-\-first\-only ]
  24 .RB [ \-\-tabs=\fITAB1\fR[\fB,\fITAB2... ]
  25 .RI [ FILE... ]
  26
  27 .BR unexpand " [" \-\-help "] [" \-\-version ]
  28 .SH DESCRIPTION
  29 .B unexpand
  30 writes each
  31 .I FILE
  32 to standard output, replacing strings of two or more spaces or tab
  33 characters with as many tabs as possible followed by as many spaces as are
  34 needed.  If
  35 .I FILE
  36 is omitted or if it is a
  37 .RB ` \- ',
  38 standard input is used for reading.
  39 .SH OPTIONS
  40 .TP
  41 .B \-\fITAB1\fR[\fB,\fITAB2...\fR]\fB, \-t \fITAB1\fR[\fB,\fITAB2...\fR]\fB, \-\-tabs=\fITAB1\fR[\fB,\fITAB2...\fR]
  42 If only one tab stop is given, set the tabs \fITAB1\fR spaces apart
  43 (default is 8).  Otherwise, set the tabs at columns \fITAB1\fR, \fITAB2\fR,
  44 \fI...\fR (numbered from 0), and replace any tabs beyond the last
  45 tabstop given with single spaces.  If the tabstops are specified
  46 with the \fB\-\-tabs\fR option, they can be separated by blanks as well as
  47 by commas.  Short option form \fB\-\fR is deprecated.
  48 .TP
  49 .B \-a, \-\-all
  50 Convert all strings of two or more spaces or tabs, not just initial
  51 ones, to tabs.
  52 .TP
  53 .B \-\-first\-only
  54 Perform only one replacement and exit.
  55 .TP
  56 .B "\-\-help"
  57 Print a usage message on standard output and exit successfully.
  58 .TP
  59 .B "\-\-version"
  60 Print version information on standard output then exit successfully.
  61 .SH NOTES
  62 Report bugs to bug-textutils@gnu.org.
  63 .br
  64 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>