Release 1.3.1.

[misc] / space.1

diff --git a/space.1 b/space.1
index f4799ab0c71b3716fc7fb8f9de40f68777027731..f38793f25bb8178c65709468d457df647fb12786 100644 (file)
--- a/space.1
+++ b/space.1
@@ -10,7 +10,7 @@
 space \- check and fix whitespace in files
 .SH SYNOPSIS
 .B space
 space \- check and fix whitespace in files
 .SH SYNOPSIS
 .B space

-.RB [ \-cmtuv ]
+.RB [ \-clmtuv ]

 .RB [ \-i \c
 .RI [ backup ]]
 .RI [ file ...]
 .RB [ \-i \c
 .RI [ backup ]]
 .RI [ file ...]


@@ -30,8 +30,12 @@ files.  In particular, it will notice and (if you want) fix
 \(en which confuses a number of programs,
 .BR diff (1)
 not least;
 \(en which confuses a number of programs,
 .BR diff (1)
 not least;

-.hP \*o groups of spaces
-which could be replaced by tabs; or
+.hP \*o
+.I trailing blank lines
+\(en which some editors, notably Emacs, introduce by default;
+.hP \*o
+.I groups of spaces which could be replaced by tabs
+\(en replacing them with the appropriate tab characters; or

 .hP \*o
 .I all tab characters
 \(en replacing them with appropriate numbers of spaces.
 .hP \*o
 .I all tab characters
 \(en replacing them with appropriate numbers of spaces.


@@ -53,6 +57,20 @@ option with this; without it,
 .B space
 is silent.
 .TP
 .B space
 is silent.
 .TP

+.B \-l
+Check the file for trailing blank lines, i.e., lines containing only
+horizontal whitespace.  With
+.BR \-v ,
+report if the file has trailing blank lines; without
+.BR \-c ,
+remove these trailing blank lines from the output.
+.TP
+.BR \-v
+Report detailed messages about whitespace problems encountered.  Useful
+with
+.BR \-c ,
+for example.
+.TP

 .BR \-i [ \fIbackup ]
 Modify all the
 .IR file s
 .BR \-i [ \fIbackup ]
 Modify all the
 .IR file s


@@ -61,7 +79,7 @@ some new name not currently in use.  If the processing was successful,
 the old
 .I file
 is renamed to
 the old
 .I file
 is renamed to

-.I filebackup
+.I file "" backup

 and the new file is renamed to
 .IR file .
 If something very complicated goes wrong at just the right moment, it's
 and the new file is renamed to
 .IR file .
 If something very complicated goes wrong at just the right moment, it's


@@ -117,5 +135,7 @@ There's no way yet of controlling where the tab stops are.
 .PP
 This space program doesn't even attempt moon landings.  The space man
 page doesn't have wiggly antennae.
 .PP
 This space program doesn't even attempt moon landings.  The space man
 page doesn't have wiggly antennae.

+.PP
+The jokes in the man page are somewhat lame.

 .SH AUTHOR
 Mark Wooding, <mdw@distorted.org.uk>
 .SH AUTHOR
 Mark Wooding, <mdw@distorted.org.uk>