[Mono-list] Using monodoce for non-official mono project

Jonathan Pryor jonpryor at vt.edu
Thu Apr 3 10:39:12 EDT 2008

On Thu, 2008-04-03 at 12:45 +0200, Manuel de la Pena wrote:
> I'm in a developing group that is planning to release an opensource API
> that we have developed. We are looking in to different ways of
> documenting the code. We have come across monodoc and monodocer. Is it a
> tool that can just be used with official mono projects??

monodocer can be used against any .NET assembly.  It enforces a
"documentation outside of source" philosophy, though it can also import
any existing XML Documentation Comments you may have for your project:


Monodoc is a GUI to display documentation generated by monodocer.  It's
a Gtk# app, and I don't know if it runs on Windows.  (I suspect it
doesn't at this time, due to the use of GtkHtml, but once the Gecko or
WebKit HTML renderers are working a Windows port likely wouldn't be

There is also an ASP.NET app to display the documentation, though sadly
there is little documentation about how to set this up:


Example site:

monodocs2html will generate a static set of HTML pages containing


Example output:

See also:

> Is there any way
> to use it to document our API and upload the changes to our server?

Depends on what you use.  If you use monodocs2html, you just need to
rsync the directory trees and you're done.  The ASP.NET web app requires
that you Assemble your documentation into a .zip/.tree/.source set (with
mdassembler),  install that into $prefix/lib/monodoc/sources on your web
server, and (maybe - not sure) restart ASP.NET.


 - Jon

More information about the Mono-list mailing list