[Mono-docs-list] Integrating the Mono Handbook with Class Library documentation?

Jonathan Pryor jonpryor@vt.edu
Sun, 04 Jul 2004 15:02:33 -0400


What is the best way to integrate the Mono Handbook with the Class
Library documentation?

For example, in my "Managed and Unmanaged Code Integration" guide (Mono
Handbook node: Advanced Topics/Interoperability/Platform Invoke), I want
to link to the Class Library documentation.

Currently, I do that by doing the most reasonable thing: using a
<cref/>-style reference:

	<a href="N:System.Runtime.InteropServices">the namespace</a>
	<a href="T:System.MissingMethodException">a class</a>
	<a href="F:System.Runtime.InteropServices.DllImport.EntryPoint">a field</a>
	etc...

The problem is that this doesn't work.  Hyperlinks such as the above get
prefixed with "source-id:7:xhtml:html/en/wrapping/", with
"html/en/wrapping" being the path to the document in the monkeyguide
repository.

Obviously
"source-id:7:xhtml:html/en/wrapping/N:System.Runtime.InteropServices
isn't going to be a valid URL, so obviously the approach I'm currently
using doesn't work.

Hence the question: what *should* I be doing?  Is it currently possible
to link to Class Library documentation (classes, methods, etc.) from the
Mono Handbook?  If so, how should this be done?

If this isn't possible, please interpret this as a feature request. :-)

 - Jon