From 8aac1e8e040424611f74946c1ff7c7246e7b55f8 Mon Sep 17 00:00:00 2001 From: Tom Ryder Date: Wed, 26 Dec 2018 21:46:06 +1300 Subject: Fix long lines in manual pages --- man/man1/ax.1df | 3 ++- man/man1/bp.1df | 4 ++-- man/man1/cfr.1df | 6 +++--- man/man1/chc.1df | 4 +++- man/man1/chn.1df | 4 ++-- man/man1/clrd.1df | 6 +++--- man/man1/clwr.1df | 4 ++-- man/man1/fnl.1df | 4 ++-- man/man1/gms.1df | 4 ++-- man/man1/gwp.1df | 8 ++++---- man/man1/han.1df | 4 ++-- man/man1/jfcd.1df | 4 ++-- man/man1/loc.1df | 4 ++-- man/man1/mi5.1df | 7 ++++--- man/man1/mim.1df | 4 ++-- man/man1/mkmv.1df | 4 ++-- man/man1/murl.1df | 2 +- man/man1/pp.1df | 4 ++-- man/man1/rndf.1df | 6 +++--- man/man1/slsf.1df | 4 ++-- man/man1/tlcs.1df | 6 +++--- man/man1/tm.1df | 6 +++--- man/man1/urlmt.1df | 4 ++-- man/man1/vest.1df | 4 ++-- man/man6/rndn.6df | 4 ++-- 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 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 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 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 .br -- cgit v1.2.3