Subject: Tidy up the docs

From: dkf <[email-masked]>
Date: Sun, 3 Aug 2014 22:43:42 +0000

---
 doc/string.n | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/doc/string.n b/doc/string.n
index 450a97b..33780ff 100644
--- a/doc/string.n
+++ b/doc/string.n
@@ -19,14 +19,19 @@ string \- Manipulate strings
 Performs one of several string operations, depending on \fIoption\fR.
 The legal \fIoption\fRs (which may be abbreviated) are:
 .TP
-.VS 8.6.2
 \fBstring cat\fR ?\fIstring1\fR? ?\fIstring2...\fR?
-.
-Concatenate the given strings just like direct juxtaposition
-would. This primitive is occasionally handier than juxtaposition when
-mixed quoting is wanted, or when the aim is to return the result of a
-concatenation without resorting to \fB[return -level 0]\fR. If no arg
-is present, an empty string is returned.
+.VS 8.6.2
+Concatenate the given \fIstring\fRs just like placing them directly
+next to each other and return the resulting compound string.  If no
+\fIstring\fRs are present, the result is an empty string.
+.RS
+.PP
+This primitive is occasionally handier than juxtaposition of strings
+when mixed quoting is wanted, or when the aim is to return the result
+of a concatenation without resorting to \fBreturn\fR \fB\-level 0\fR,
+and is more efficient than building a list of arguments and using
+\fBjoin\fR with an empty join string.
+.RE
 .VE
 .TP
 \fBstring compare\fR ?\fB\-nocase\fR? ?\fB\-length\fI length\fR? \fIstring1 string2\fR
-- 
cgit v0.12