Clean up prior to TIP vote

1 files changed, 18 insertions, 10 deletions

diff --git a/doc/canvas.n b/doc/canvas.n
index 5abfc0f..fa7843d 100644
--- a/doc/canvas.n
+++ b/doc/canvas.n
@@ -313,6 +313,7 @@ The second possible syntax is a character list containing only
 The space can be used
 to enlarge the space between other line elements, and cannot
 occur as the first position in the string. Some examples:
+.PP
 .CS
 \-dash .     \(-> \-dash {2 4}
 \-dash -     \(-> \-dash {6 4}
@@ -1395,20 +1396,27 @@ distance of the mid-point of the arc from its chord. When this option
 is used the coordinates are interpreted as the start and end coordinates
 of the chord, and the options \fB\-start\fR and \fB-extent\fR are ignored.
 The value of \fIdistance\fR has the following meaning:
-.CS
-
+.RS
+.PP
+.RS
 \fIdistance\fR > 0 creates a clockwise arc
+.br
 \fIdistance\fR < 0 creates an counter-clockwise arc
+.br
 \fIdistance\fR = 0 creates an arc as if this option had not been specified
-
-If you want the arc to have a specific radius, r, use the formula
-
-\fIdistance\fR = r +- sqrt(r**2 - (chordLength/2)**2)
-
+.RE
+.PP
+If you want the arc to have a specific radius, \fIr\fR, use the formula:
+.PP
+.RS
+\fIdistance\fR = \fIr\fR \(+- sqrt(\fIr\fR**2 - (chordLength / 2)**2)
+.RE
+.PP
 choosing the minus sign for the minor arc and the plus sign for the major arc.
-
-Note that \fBitemcget -height\fR always returns 0 so that introspection code can be kept simple.
-.CE
+.PP
+Note that \fBitemcget \-height\fR always returns 0 so that introspection code
+can be kept simple.
+.RE
 .TP
 \fB\-style \fItype\fR
 Specifies how to draw the arc. If \fItype\fR is \fBpieslice\fR