mandoc: Wrap text and phrasing elements in paragraphs unless already

[schwarze@mandoc.bsd.lv]

Log Message:
-----------
Wrap text and phrasing elements in paragraphs unless already 
contained in flow containers; never put them directly into sections.
This helps to format paragraphs with the CSS class selector .Pp.

Suggested by bentley@ and also by Colin Watson <cjwatson at debian>         
via Michael Stapelberg <stapelberg at debian>,
see https://github.com/Debian/debiman/issues/116

Modified Files:
--------------
    mandoc:
        html.c

Revision Data
-------------
Index: html.c
===================================================================
RCS file: /home/cvs/mandoc/mandoc/html.c,v
retrieving revision 1.259
retrieving revision 1.260
diff -Lhtml.c -Lhtml.c -u -p -r1.259 -r1.260
--- html.c
+++ html.c
@@ -590,7 +590,15 @@ print_otag(struct html *h, enum htmltag 
 			assert((htmltags[t->tag].flags & HTML_TOPHRASE) == 0);
 			break;
 		}
-	}
+
+	/*
+	 * Always wrap phrasing elements in a paragraph
+	 * unless already contained in some flow container;
+	 * never put them directly into a section.
+	 */
+
+	} else if (tflags & HTML_TOPHRASE && h->tag->tag == TAG_SECTION)
+		print_otag(h, TAG_P, "c", "Pp");
 
 	/* Push this tag onto the stack of open scopes. */
 
@@ -796,6 +804,16 @@ print_gen_comment(struct html *h, struct
 void
 print_text(struct html *h, const char *word)
 {
+	/*
+	 * Always wrap text in a paragraph unless already contained in
+	 * some flow container; never put it directly into a section.
+	 */
+
+	if (h->tag->tag == TAG_SECTION)
+		print_otag(h, TAG_P, "c", "Pp");
+
+	/* Output whitespace before this text? */
+
 	if (h->col && (h->flags & HTML_NOSPACE) == 0) {
 		if ( ! (HTML_KEEP & h->flags)) {
 			if (HTML_PREKEEP & h->flags)
@@ -804,6 +822,11 @@ print_text(struct html *h, const char *w
 		} else
 			print_word(h, "&#x00A0;");
 	}
+
+	/*
+	 * Print the text, optionally surrounded by HTML whitespace,
+	 * optionally manually switching fonts before and after.
+	 */
 
 	assert(h->metaf == NULL);
 	print_metaf(h);
--
 To unsubscribe send an email to source+unsubscribe@mandoc.bsd.lv