[Mono-dev] monodocs2html help with source

[Jonathan Pryor]

On Tue, 2007-02-27 at 10:00 -0300, Pedro Sobota wrote:
> I'm trying to get monodocs2html to run from source on my machine. As a
> first try on contributing to Mono, I'm looking to make it so the
> hyperlink generated from <see> elements get their text from the
> element value if available.

There's just one problem with this: it violates the DTD.  The DTD
provided with ECMA-335 specifies:

	<!ELEMENT see EMPTY
	<!ATTLIST see
	  cref CDATA #IMPLIED
	  langword CDATA #IMPLIED
	  qualify CDATA #IMPLIED
	>

Consequently, any XML attempting to provide a value for <see/> will fail
validation.

> I downloaded a tar and am compiling on my own (is there a reference
> command line I could be using to compile?). 

Can you elaborate on this?  The monodoc tar.gz file should have a
configure script and (after configure is run) Makefiles which should
properly build everything.  Even better, the monodoc/tools directory has
unit tests; run "make check" from the monodoc/tools directory.

 - Jon