<writer>.send_paragraph(): Clarify what needs to be done by this

	method and what it should not do.  (Specifically: handling
	breaking of last line of preceeding paragraph.)

diff --git a/Doc/lib/libformatter.tex b/Doc/lib/libformatter.tex
index 9bb12b22ee0ffd56744bf896142a0ab5bde6e16d..5d860a2ffd07bf7c99d433468c85e85f0d095652 100644 (file)
--- a/Doc/lib/libformatter.tex
+++ b/Doc/lib/libformatter.tex
@@ -265,7 +265,10 @@ Break the current line.
 \begin{methoddesc}[writer]{send_paragraph}{blankline}
 Produce a paragraph separation of at least \var{blankline} blank
 lines, or the equivelent.  The \var{blankline} value will be an
-integer.
+integer.  Note that the implementation will receive a call to
+\method{send_line_break()} before this call if a line break is needed; 
+this method should not include ending the last line of the paragraph.
+It is only responsible for vertical spacing between paragraphs.
 \end{methoddesc}
 
 \begin{methoddesc}[writer]{send_hor_rule}{*args, **kw}