X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/misc/blobdiff_plain/df33ee5494fe4ac181807406cd8dcf6dba6f5275..ed68d9a61a11bc1ba3f80c1b51c2715906c62f87:/space.1?ds=inline diff --git a/space.1 b/space.1 index f4799ab..f38793f 100644 --- a/space.1 +++ b/space.1 @@ -10,7 +10,7 @@ space \- check and fix whitespace in files .SH SYNOPSIS .B space -.RB [ \-cmtuv ] +.RB [ \-clmtuv ] .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; -.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. @@ -53,6 +57,20 @@ option with this; without it, .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 @@ -61,7 +79,7 @@ some new name not currently in use. If the processing was successful, 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 @@ -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 +The jokes in the man page are somewhat lame. .SH AUTHOR Mark Wooding,