From a5bef6eb5c7c27439ce292b1eab80acf195ca2fc Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Sat, 17 Nov 2018 08:57:53 -0800
Subject: doc: use bulleted list under copy.

* txr.1: Present the type cases of the copy function using a
more compact and visually appealing bulleted list.
---
 txr.1 | 85 +++++++++++++++++++++++--------------------------------------------
 1 file changed, 29 insertions(+), 56 deletions(-)

diff --git a/txr.1 b/txr.1
index 4bd7d2ff..933e32c1 100644
--- a/txr.1
+++ b/txr.1
@@ -26236,62 +26236,35 @@ is
 it
 returns
 .codn nil .
-If
-.meta object
-is a list, it returns
-.cblk
-.meti (copy-list << object ).
-.cble
-If
-.meta object
-is a string, it returns
-.cblk
-.meti (copy-str << object ).
-.cble
-If
-.meta object
-is a vector, it returns
-.cblk
-.meti (copy-vec << object ).
-.cble
-If
-.meta object
-is a hash, it returns
-.cblk
-.meti (copy-hash << object ).
-.cble
-If
-.meta object
-is a structure, it returns
-.cblk
-.meti (copy-struct << object ).
-.cble
-If
-.meta object
-is a function, it returns
-.cblk
-.meti (copy-fun << object ).
-.cble
-If
-.meta object
-is a buffer, it returns
-.cblk
-.meti (copy-buf << object ).
-.cble
-If
-.meta object
-is a
-.codn carray ,
-it returns
-.cblk
-.meti (copy-carray << object ).
-.cble
-Lastly, if
-.meta object
-is a random state, it returns
-.cblk
-.meti (make-random-state << object ).
-.cble
+Otherwise,
+.code copy
+is equivalent to invoking a more specific copying function according to
+the type of the argument, as follows:
+.RS
+.coIP cons
+.meti (copy-list << object )
+.coIP str
+.meti (copy-str << object )
+.coIP vec
+.meti (copy-vec << object )
+.coIP hash
+.meti (copy-hash << object )
+.IP "struct type"
+.meti (copy-struct << object )
+.coIP fun
+.meti (copy-fun << object )
+.coIP buf
+.meti (copy-buf << object )
+.coIP carray
+.meti (copy-carray << object )
+.coIP random-state
+.meti (make-random-state << object )
+.RE
+
+.IP
+For all other types of
+.metn object ,
+the invocation is erroneous.
 
 Except in the case when
 .meta sequence
-- 
cgit v1.2.3