File: unexpand.1

package info (click to toggle)
textutils 1.22-2.4
  • links: PTS
  • area: main
  • in suites: hamm, slink
  • size: 6,480 kB
  • ctags: 2,942
  • sloc: ansic: 31,755; sh: 8,186; perl: 811; makefile: 640; sed: 93
file content (50 lines) | stat: -rw-r--r-- 1,775 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
.TH UNEXPAND 1 "GNU Text Utilities" "FSF" \" -*- nroff -*-
.SH NAME
unexpand \- convert spaces to tabs
.SH SYNOPSIS
.B unexpand
[\-tab1[,tab2[,...]]] [\-t tab1[,tab2[,...]]] [\-a]
[\-\-tabs=tab1[,tab2[,...]]] [\-\-all] [\-\-help] [\-\-version] [file...]
.SH DESCRIPTION
This documentation is no longer being maintained and may be inaccurate
or incomplete.  The Texinfo documentation is now the authoritative source.
.PP
This manual page
documents the GNU version of
.BR unexpand .
.B unexpand
writes the contents of each given file, or the standard input if
none are given or when a file named `\-' is given, to the standard
output, with strings of two or more space or tab characters converted
to as many tabs as possible followed by as many spaces as are needed.
By default,
.B unexpand
converts only initial spaces and tabs (those that precede all non
space or tab characters) on each line.  It preserves
backspace characters in the output; they decrement the column count
for tab calculations.  By default, tabs are set at every 8th column.
.SS OPTIONS
.TP
.I "\-, \-t, \-\-tabs tab1[,tab2[,...]]"
If only one tab stop is given, set the tabs \fItab1\fP spaces apart
instead of the default 8.  Otherwise, set the tabs at columns
\fItab1\fP, \fItab2\fP, etc. (numbered from 0) and leave spaces and
tabs beyond the tabstops given unchanged.  If the tabstops are
specified with the
.I \-t
or
.I \-\-tabs
option, they can be separated by blanks as well as by commas.
This option implies the
.I \-a
option.
.TP
.I "\-a, \-\-all"
Convert all strings of two or more spaces or tabs, not just initial
ones, to tabs.
.TP
.I "\-\-help"
Print a usage message and exit with a status code indicating success.
.TP
.I "\-\-version"
Print version information on standard output then exit.