[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