I mostly don’t bother with triple-quoted strings. I think they’re
badly designed.

Here’s an example of what my docstrings look like:

class Matrix :
"representation of a 3-by-2 affine homogeneous matrix. This does not" \
" actually use any Cairo routines to implement its calculations; these" \
" are done entirely using Python numerics. The from_cairo and to_cairo" \
" methods provide conversion to/from cairo_matrix_t structs. Routines" \
" elsewhere expect this Matrix type where the underlying Cairo routine" \
" wants a cairo_matrix_t, and return this type where the Cairo routine" \
" returns a cairo_matrix_t."

...

#end Matrix

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)