aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2018-12-26 21:46:06 +1300
committerTom Ryder <tom@sanctum.geek.nz>2018-12-26 21:46:06 +1300
commit8aac1e8e040424611f74946c1ff7c7246e7b55f8 (patch)
treee9f7c3d08449c33f96607577ac91a1d7cfcc248b
parentTwo-space sentences in manual pages (diff)
downloaddotfiles-8aac1e8e040424611f74946c1ff7c7246e7b55f8.tar.gz
dotfiles-8aac1e8e040424611f74946c1ff7c7246e7b55f8.zip
Fix long lines in manual pages
-rw-r--r--man/man1/ax.1df3
-rw-r--r--man/man1/bp.1df4
-rw-r--r--man/man1/cfr.1df6
-rw-r--r--man/man1/chc.1df4
-rw-r--r--man/man1/chn.1df4
-rw-r--r--man/man1/clrd.1df6
-rw-r--r--man/man1/clwr.1df4
-rw-r--r--man/man1/fnl.1df4
-rw-r--r--man/man1/gms.1df4
-rw-r--r--man/man1/gwp.1df8
-rw-r--r--man/man1/han.1df4
-rw-r--r--man/man1/jfcd.1df4
-rw-r--r--man/man1/loc.1df4
-rw-r--r--man/man1/mi5.1df7
-rw-r--r--man/man1/mim.1df4
-rw-r--r--man/man1/mkmv.1df4
-rw-r--r--man/man1/murl.1df2
-rw-r--r--man/man1/pp.1df4
-rw-r--r--man/man1/rndf.1df6
-rw-r--r--man/man1/slsf.1df4
-rw-r--r--man/man1/tlcs.1df6
-rw-r--r--man/man1/tm.1df6
-rw-r--r--man/man1/urlmt.1df4
-rw-r--r--man/man1/vest.1df4
-rw-r--r--man/man6/rndn.6df4
25 files changed, 59 insertions, 55 deletions
diff --git a/man/man1/ax.1df b/man/man1/ax.1df
index 1954ad45..981938e0 100644
--- a/man/man1/ax.1df
+++ b/man/man1/ax.1df
@@ -16,6 +16,7 @@ expression.
.SH SECURITY
Note that the second argument has no evaluation protection on it. There's very
little to stop a user putting a fully-fledged awk program in as the second
-argument if they needed to. Don't accept untrusted user input in this argument!
+argument if they needed to. Don't accept untrusted user input in this
+argument!
.SH AUTHOR
Tom Ryder <tom@sanctum.geek.nz>
diff --git a/man/man1/bp.1df b/man/man1/bp.1df
index c3362e17..93f08f74 100644
--- a/man/man1/bp.1df
+++ b/man/man1/bp.1df
@@ -10,8 +10,8 @@ BROWSER=firefox
.SH DESCRIPTION
.B bp
reads an URL from stdin, with an "URL:" prompt if stdin is a terminal, and runs
-br(1df) against it. It was written because the author hates quoting URLs on the
-command line.
+br(1df) against it. It was written because the author hates quoting URLs on
+the command line.
.SH SEE ALSO
br(1df), ap(1df)
.SH AUTHOR
diff --git a/man/man1/cfr.1df b/man/man1/cfr.1df
index cf717ca8..5b9376ba 100644
--- a/man/man1/cfr.1df
+++ b/man/man1/cfr.1df
@@ -13,9 +13,9 @@ dir1 dir2
.SH DESCRIPTION
.B cf
counts all the entries in the directory trees rooted at the given arguments,
-and prints the total. It defaults to the current directory. It should correctly
-handle corner cases like filenames with newlines in them. It will count but
-will not follow symbolic links.
+and prints the total. It defaults to the current directory. It should
+correctly handle corner cases like filenames with newlines in them. It will
+count but will not follow symbolic links.
.SH SEE ALSO
cf(1df), tot(1df)
.SH AUTHOR
diff --git a/man/man1/chc.1df b/man/man1/chc.1df
index d96ad30c..9e0caaf3 100644
--- a/man/man1/chc.1df
+++ b/man/man1/chc.1df
@@ -25,7 +25,9 @@ No file locking is implemented. If you need it, you're probably already at the
point that you need to write a proper solution, but you could always use Linux
flock(1) or daemontool's setlock(1) in the command if you're stubborn:
.P
- flock -x /var/lock/example.chc chc /var/cache/example.chc 20 curl http://www.example.com/
+ flock -x /var/lock/example.chc \\
+ chc /var/cache/example.chc 20 \\
+ curl http://www.example.com/
.P
If you want to express the duration in human-readable terms, sec(1df) might be
useful too.
diff --git a/man/man1/chn.1df b/man/man1/chn.1df
index 75fc5af1..ab24691d 100644
--- a/man/man1/chn.1df
+++ b/man/man1/chn.1df
@@ -35,8 +35,8 @@ But this won't:
.SH CAVEATS
It's slow.
.P
-It's not a real pipe. The commands are run successively, not in parallel. That
-means you can't pass one line to it and have it return another line before
+It's not a real pipe. The commands are run successively, not in parallel.
+That means you can't pass one line to it and have it return another line before
sending EOF, for unbuffered (e.g. linewise) tools.
.P
There's almost certainly a better way to do this, fixing one or both of the
diff --git a/man/man1/clrd.1df b/man/man1/clrd.1df
index e59edb21..96b7b6e3 100644
--- a/man/man1/clrd.1df
+++ b/man/man1/clrd.1df
@@ -7,9 +7,9 @@
file
.SH DESCRIPTION
.B clrd
-clears the screen and runs tail -f on the given file. It will not run if stdout
-is not a terminal. This is for use in minimal socket-network programs like
-ii(1), along with clwr(1df).
+clears the screen and runs tail -f on the given file. It will not run if
+stdout is not a terminal. This is for use in minimal socket-network programs
+like ii(1), along with clwr(1df).
.SH SEE ALSO
clwr(1df), ii(1)
.SH AUTHOR
diff --git a/man/man1/clwr.1df b/man/man1/clwr.1df
index 18b03928..0a977d1e 100644
--- a/man/man1/clwr.1df
+++ b/man/man1/clwr.1df
@@ -8,8 +8,8 @@ file
.SH DESCRIPTION
.B clwr
clears the screen, accepts a line of input from stdin, writes it to the given
-file, and loops. This is for use in minimal socket-network programs like ii(1),
-along with clrd(1df).
+file, and loops. This is for use in minimal socket-network programs like
+ii(1), along with clrd(1df).
.SH SEE ALSO
clrd(1df), ii(1)
.SH AUTHOR
diff --git a/man/man1/fnl.1df b/man/man1/fnl.1df
index d085df6b..5c878b69 100644
--- a/man/man1/fnl.1df
+++ b/man/man1/fnl.1df
@@ -8,8 +8,8 @@ command arg1 ...
.SH DESCRIPTION
.B fnl
runs the command specifies in its arguments, writing any stdout and stderr to
-separate temporary files created with mktd(1df), and then runs wc(1) over them to
-show their statistics and full paths.
+separate temporary files created with mktd(1df), and then runs wc(1) over them
+to show their statistics and full paths.
.SH SEE ALSO
igex(1df)
.SH AUTHOR
diff --git a/man/man1/gms.1df b/man/man1/gms.1df
index 40f2c41b..4a20297f 100644
--- a/man/man1/gms.1df
+++ b/man/man1/gms.1df
@@ -16,8 +16,8 @@ time.
.IP \[bu]
It runs the requests in parallel using fork(2)/wait(2).
.IP \[bu]
-It uses try(1df) to attempt each fetch three times, with 15 seconds between each
-attempt, and only prints errors if all three attempts fail.
+It uses try(1df) to attempt each fetch three times, with 15 seconds between
+each attempt, and only prints errors if all three attempts fail.
.SH SEE ALSO
getmail(1), try(1df)
.SH AUTHOR
diff --git a/man/man1/gwp.1df b/man/man1/gwp.1df
index 70e6dcb5..88881454 100644
--- a/man/man1/gwp.1df
+++ b/man/man1/gwp.1df
@@ -7,10 +7,10 @@
.br
.SH DESCRIPTION
.B gwp
-searches for complete alphanumeric words (not regular expressions) in the input and
-prints the line if found. This means you can search for "test" and it won't
-print lines just because they contain "latest". It's good for searching prose
-or poetry rather than code.
+searches for complete alphanumeric words (not regular expressions) in the input
+and prints the line if found. This means you can search for "test" and it
+won't print lines just because they contain "latest". It's good for searching
+prose or poetry rather than code.
.P
This is intended as a workaround for the absence of a portable implementation
of "word boundaries" in POSIX. Instead, this awk(1) script breaks each line
diff --git a/man/man1/han.1df b/man/man1/han.1df
index 6602d3b7..3b2ae8f3 100644
--- a/man/man1/han.1df
+++ b/man/man1/han.1df
@@ -7,8 +7,8 @@
.I (HELPTOPIC | MANARGS...)
.SH DESCRIPTION
If called with a single argument, try running the help builtin for the given
-keyword, writing its output to a file. If it succeeds, show that. If not, pass
-the call to man(1).
+keyword, writing its output to a file. If it succeeds, show that. If not,
+pass the call to man(1).
.P
This was written so it could be used as a 'keywordprg' in Vim for Bash files;
you can then use the K normal-mode binding over both shell builtins (e.g. read,
diff --git a/man/man1/jfcd.1df b/man/man1/jfcd.1df
index 35f16ae7..e62f307f 100644
--- a/man/man1/jfcd.1df
+++ b/man/man1/jfcd.1df
@@ -8,8 +8,8 @@
.SH DESCRIPTION
.B jfcd
watches a directory recursively with inotifywait(1) and commits all changes
-with jfc(1df) as it detects them. It logs its output and errors to syslog using
-logger(1).
+with jfc(1df) as it detects them. It logs its output and errors to syslog
+using logger(1).
.SH SEE ALSO
git(1), inotifywait(1), jfc(1df), logger(1)
.SH AUTHOR
diff --git a/man/man1/loc.1df b/man/man1/loc.1df
index 1a8848cc..7284432d 100644
--- a/man/man1/loc.1df
+++ b/man/man1/loc.1df
@@ -10,7 +10,7 @@ PATTERN1 [PATTERN2...]
is a simple wrapper around find(1) which searches in the current directory tree
for filenames matching a pattern, and prints them to stdout, newline-separated.
It skips dotfiles and symbolic links, and doesn't recurse further into a
-directory if it matches the terms. It is intended only for interactive use as a
-shortcut.
+directory if it matches the terms. It is intended only for interactive use as
+a shortcut.
.SH AUTHOR
Tom Ryder <tom@sanctum.geek.nz>
diff --git a/man/man1/mi5.1df b/man/man1/mi5.1df
index 22966ebb..41ed876f 100644
--- a/man/man1/mi5.1df
+++ b/man/man1/mi5.1df
@@ -42,10 +42,11 @@ Macros can be expanded as blocks:
.P
For this format, `dnl' macros to delete newlines for each declaration are
inserted for you. Blank lines are skipped, and leading and trailing spaces are
-ignored. The above code therefore produces no actual output, as it only has two
-define calls.
+ignored. The above code therefore produces no actual output, as it only has
+two define calls.
.P
-For inline expansion, the syntax is similar, but the behaviour slightly different:
+For inline expansion, the syntax is similar, but the behaviour slightly
+different:
.P
The value of the FOO macro is <% FOO %>.
.P
diff --git a/man/man1/mim.1df b/man/man1/mim.1df
index 1ed8a5bb..5476c132 100644
--- a/man/man1/mim.1df
+++ b/man/man1/mim.1df
@@ -11,8 +11,8 @@ curl http://example.net/ |
.SH DESCRIPTION
.B mim
takes all its input and puts it into a temporary file for mutt(1) to read with
-its -i option, redirecting the terminal input appropriately. This allows you to
-concatenate or pipe input straight into a new Mutt message.
+its -i option, redirecting the terminal input appropriately. This allows you
+to concatenate or pipe input straight into a new Mutt message.
.P
The author wrote it so that he could use ! and :! commands in Vim with it, to
email sections of buffers to people conveniently.
diff --git a/man/man1/mkmv.1df b/man/man1/mkmv.1df
index ae4c53bb..f8ebf590 100644
--- a/man/man1/mkmv.1df
+++ b/man/man1/mkmv.1df
@@ -11,8 +11,8 @@ filea fileb newdir/newsubdir
.SH DESCRIPTION
.B mkmv
combines mkdir(1) and mv(1) into one call, creating the last argument as a
-directory and moving the remaining arguments into it. If the directory creation
-fails, the script stops before attempting the move.
+directory and moving the remaining arguments into it. If the directory
+creation fails, the script stops before attempting the move.
.SH SEE ALSO
mkdir(1), mv(1), mkmv(1df)
.SH AUTHOR
diff --git a/man/man1/murl.1df b/man/man1/murl.1df
index 088158b0..86fe878a 100644
--- a/man/man1/murl.1df
+++ b/man/man1/murl.1df
@@ -1,7 +1,7 @@
.TH MURL 1df "June 2016" "Manual page for murl"
.SH NAME
.B murl
-\- convert Markdown to HTML with pandoc(1) and extract URLs from it with hurl(1df)
+\- convert Markdown to HTML with pandoc(1), extract URLs with hurl(1df)
.SH SYNOPSIS
.B murl
README.md
diff --git a/man/man1/pp.1df b/man/man1/pp.1df
index 9c5f8adc..19fa1584 100644
--- a/man/man1/pp.1df
+++ b/man/man1/pp.1df
@@ -13,8 +13,8 @@ with a slash, in which case they are printed verbatim.
The path need not actually exist.
.SH CAVEATS
Newlines in filenames will still work, but the results won't really make sense
-as they'll be indistinguishable from newlines separating the files. This is for
-generating human-readable file lists, not for machines.
+as they'll be indistinguishable from newlines separating the files. This is
+for generating human-readable file lists, not for machines.
.SH SEE ALSO
pph(1df)
.SH AUTHOR
diff --git a/man/man1/rndf.1df b/man/man1/rndf.1df
index 88897243..4e6c4780 100644
--- a/man/man1/rndf.1df
+++ b/man/man1/rndf.1df
@@ -11,9 +11,9 @@
.SH DESCRIPTION
.B rndf
prints the name a random file (excluding dot files) from the given directory,
-defaulting to the current directory. It uses rndi(1df), which is probably not a
-high-quality source, but should differ within seconds and between runs on most
-systems.
+defaulting to the current directory. It uses rndi(1df), which is probably not
+a high-quality source, but should differ within seconds and between runs on
+most systems.
.SH SEE ALSO
rndi(1df), rnda(1df), rndl(1df), rnds(1df), rndn(6df)
.SH AUTHOR
diff --git a/man/man1/slsf.1df b/man/man1/slsf.1df
index c75dff50..31453dca 100644
--- a/man/man1/slsf.1df
+++ b/man/man1/slsf.1df
@@ -11,8 +11,8 @@ cat ~/.ssh_config |
.SH DESCRIPTION
.B slsf
iterates through the ssh_config(5) files given as its input and prints the
-first name given on each "Host" line, as long as it contains no wildcards. Most
-users will probably want the sls(1df) frontend.
+first name given on each "Host" line, as long as it contains no wildcards.
+Most users will probably want the sls(1df) frontend.
.P
Within the file, a comment "### nosls" on its own line will exclude all
following output unless an "### sls" comment is read to resume it again:
diff --git a/man/man1/tlcs.1df b/man/man1/tlcs.1df
index d3459616..5433ac86 100644
--- a/man/man1/tlcs.1df
+++ b/man/man1/tlcs.1df
@@ -10,9 +10,9 @@ line, using tl(1df) under the hood. Add -c when writing to a terminal to color
the lines.
.P
Specify a stdout prefix with -o (default "stdout: "), and/or a stderr prefix
-with -e (default "stderr: "). Option -c prints stdout lines in green and stderr
-lines in red if the respective streams are writing to appropriate terminals.
-Remaining arguments are assumed to be a command and its arguments.
+with -e (default "stderr: "). Option -c prints stdout lines in green and
+stderr lines in red if the respective streams are writing to appropriate
+terminals. Remaining arguments are assumed to be a command and its arguments.
.P
$ tlcs cat ~/.vimrc
$ tlcs -e 'FAIL: ' nonexistent-command
diff --git a/man/man1/tm.1df b/man/man1/tm.1df
index feaf8cb8..84f5e6e8 100644
--- a/man/man1/tm.1df
+++ b/man/man1/tm.1df
@@ -5,8 +5,8 @@
.SH SYNOPSIS
.B tm
.SH DESCRIPTION
-If arguments are given, pass them to tmux(1) unchanged. If not, check if a tmux
-session exists; if it does, attach to it. If not, create a new session with
-name given in environment variable $TMUX_SESSION, default "default".
+If arguments are given, pass them to tmux(1) unchanged. If not, check if a
+tmux session exists; if it does, attach to it. If not, create a new session
+with name given in environment variable $TMUX_SESSION, default "default".
.SH AUTHOR
Tom Ryder <tom@sanctum.geek.nz>
diff --git a/man/man1/urlmt.1df b/man/man1/urlmt.1df
index cbc31bed..64fbab42 100644
--- a/man/man1/urlmt.1df
+++ b/man/man1/urlmt.1df
@@ -7,8 +7,8 @@
https://www.sanctum.geek.nz/
.SH DESCRIPTION
.B urlmt
-uses urlh(1df) to search for a Content-Type header for the given URL, and prints
-it with any trailing data (e.g. charset) trimmed off.
+uses urlh(1df) to search for a Content-Type header for the given URL, and
+prints it with any trailing data (e.g. charset) trimmed off.
.SH SEE ALSO
curl(1), unf(1df), urlh(1df)
.SH AUTHOR
diff --git a/man/man1/vest.1df b/man/man1/vest.1df
index a93e154a..b398a624 100644
--- a/man/man1/vest.1df
+++ b/man/man1/vest.1df
@@ -11,8 +11,8 @@
.SH DESCRIPTION
.B vest
wraps the test(1) command, but prints an explicit "true" or "false" to stdout
-to show whether the test was true or false. It exits with the same value as the
-test it ran.
+to show whether the test was true or false. It exits with the same value as
+the test it ran.
.SH SEE ALSO
test(1), vex(1df)
.SH AUTHOR
diff --git a/man/man6/rndn.6df b/man/man6/rndn.6df
index 7981471f..b9157ae9 100644
--- a/man/man6/rndn.6df
+++ b/man/man6/rndn.6df
@@ -15,8 +15,8 @@ uses an advanced but somewhat esoteric algorithm derived by Adams (2001) to
return a random number. The seed can be derived internally or specified as an
argument.
.P
-While rndn(6df) has proven robust in the author's production usage, its algorithm
-has not been formally verified.
+While rndn(6df) has proven robust in the author's production usage, its
+algorithm has not been formally verified.
.SH SEE ALSO
<http://dilbert.com/strip/2001-10-25>
.br