[Mono-docs-list] Man page support and Linking

Jonathan Pryor jonpryor@vt.edu
Tue, 26 Oct 2004 06:20:37 -0400


I'm thinking of the future, of documenting Mono.Posix. :-)

However, as much of Mono.Posix is just a wrapping over existing
functions, most of which already have their own man pages, I see little
point in duplicating all of this documentation.  Thus, two questions:

1.  Does monodoc support man pages yet?  If not, when will it?

2.  Is it/will it be possible to link between the different sets of
providers?  For example, the initial Mono.Posix documentation will be in
the ECMA format, and I'd like (e.g.) Mono.Posix.Syscall.read() to be a
hyperlink to the read(2) man page.

This is conceptually similar to an earlier request that the HTML
provider be able to link to/reference the ECMA provider, so that you
could use <a href="T:System.String">String</a> in the HTML
documentation, which would create a link to the ECMA provider docs for
System.String.

Thanks,
 - Jon