* mdoc/Makefile: Add ../monodoc/Resources/mdoc-html-format.xsl as a
authorJonathan Pryor <jpryor@novell.com>
Wed, 12 Aug 2009 20:42:42 +0000 (20:42 -0000)
committerJonathan Pryor <jpryor@novell.com>
Wed, 12 Aug 2009 20:42:42 +0000 (20:42 -0000)
commitc100402c751734d8633122b85f4a15c3ccf0678e
treee6b0603b8552101f6f9dde2d883264805f4e0e54
parent79681b979f74cc4be46d1fbfb123bffa469f2d34
* mdoc/Makefile: Add ../monodoc/Resources/mdoc-html-format.xsl as a
  resource.
* monodoc/Resources/mdoc-html-format: Added; XSLT file to match
  "//format[@type='text/html']//*", to support "pass-through"
  semantics.  This allows you to use actual HTML within your
  documentation and have it visible to HTML-supporting output formats.
  WARNING: Use as a "last resort" -- this is primarily intended for
  importing existing HTML w/o needing lots of extra logic to convert
  into mdoc format XML first (with a corresponding loss of fidelity).
  However, it means that if (when) we get non-HTML output format
  support, the <format type="text/html" /> blocks WILL be skipped for
  that non-HTML output format.

  For example, the forever-on-the-back-burner ROFF output support --
  to remove the use of lynx, as no one ever has it installed --
  wouldn't be able to support HTML format, so it would skip these
  <format type="text/html"/> blocks.

  Consider <format /> the moral equivalent of Perl POD's
  '=begin formatname' block; see perlpod(1).
* monodoc/Resources/mdoc-html-utils.xsl: <xsl:import/>
  mdoc-html-format.xsl.  It *must* be imported (NOT included) so that
  it will have a lower priority than other <template/>s, thus allowing
  the HTML formatter to <xsl:apply-templates/> which then use the
  "normal" rules.  This allows:
<format type="text/html">
<p><see cref="T:System.String" /></p>
</format>
  to work as expected.
* monodoc/Makefile: Add mdoc-html-format.xsl as a resource.

svn path=/trunk/mcs/; revision=139795
mcs/tools/mdoc/ChangeLog
mcs/tools/mdoc/Makefile
mcs/tools/monodoc/ChangeLog
mcs/tools/monodoc/Makefile
mcs/tools/monodoc/Resources/mdoc-html-format.xsl [new file with mode: 0644]
mcs/tools/monodoc/Resources/mdoc-html-utils.xsl