X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=man%2Fmdoc.5;h=440fc15a39793c8747007e4fb31ec825cfcd5c0a;hb=a0c222056c85e329ceead309fb9e5ba366e20ee6;hp=9690445ce583ca1f5fb9265c43eeb8c9200e70b2;hpb=bbed2cf5d2fbb1b1d6a17dbab7d5e28b530ed2f7;p=mono.git
diff --git a/man/mdoc.5 b/man/mdoc.5
index 9690445ce58..440fc15a397 100644
--- a/man/mdoc.5
+++ b/man/mdoc.5
@@ -401,6 +401,31 @@ The \fIexception\fR element can contain the following elements:
\fIsee\fR, and
\fItypeparamref\fR.
.TP
+.I XML_TEXT
+The \fI\fR element is an "escape hatch," for including (possibly XML)
+content that is not valid \fBmdoc\fR(5) content. It's the moral equivalent of
+\fBperlpod\fR(1) \fI=begin format\fR blocks.
+
+\fITYPE\fR is the mime type of \fIXML_TEXT\fR. \fBmdoc\fR(5) processors may
+skip \fIformat/>\fR blocks of they use a type that isn't supported.
+
+For example:
+
+.nf
+
+
+
+.fi
+
+would cause the embedded HTML \fI
\fR element to be inserted inline
+into the resulting HTML document when \fBmdoc-export-html\fR(1) processes the
+file. (Likewise, it may be skipped if processed by another program.)
+
+\fIformat/>\fR is intended to simplify importing documentation from existing
+documentation sources. It should not be relied upon, if at all possible.
+.TP
.I XML
Create a list or table of items.
.I
@@ -578,6 +603,8 @@ Describes the return value of a method:
.fi
The \fIreturns\fR element can contain the following elements:
+\fIc\fR,
+\fIformat\fR,
\fIlist\fR,
\fIpara\fR,
\fIparamref\fR,