[prev in list] [next in list] [prev in thread] [next in thread]
List: mono-devel-list
Subject: Re: [Mono-dev] Adding documentation for new namespace
From: Jonathan Pryor <jonpryor () vt ! edu>
Date: 2010-06-30 16:05:11
Message-ID: 1277913911.3380.182.camel () lina ! magi ! jprl ! com
[Download RAW message or body]
On Wed, 2010-06-30 at 14:58 +0100, Chris Bacon wrote:
> I would like to add some documentation for the
> System.Diagnostics.Contracts namespace, for which there is currently no
> documentation.
>
> I cannot see a way to add a new namespace using the Mono Documentation
> Library. Please could someone let me know how best to do this.
cd mcs/class/corlib
# or some other assembly directory.
make PROFILE=net_4_0 doc-update
# generates doc stubs in Documentation/en
monodoc --edit Documentation/en
# view the 'Mono Documentation/mscorlib' node in the
# left-hand pane. [0]
You can then edit e.g.
mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts/*.xml,
`svn add` your XML files and `svn commit` them.
I've just committed the doc stubs for mscorlib.dll v4.0, so your first
commit won't intermix stubs with content (and be gigantic); r159740.
To install the docs:
cd mcs/docs
rm netdocs{.tree,.zip}
make PROFILE=net_4_0
make PROFILE=net_4_0 install
The intermediate `rm` is needed to ensure that nedocs.zip is rebuilt, as
the make(1) dependencies for rebuilding are inadequate.
Once you've `make install`ed, monodoc will show the new documentation.
- Jon
[0] I can't actually recommend 'monodoc --edit' for editing
documentation [1], but it is handy for viewing documentation without
assembling and installing it.
[1]
http://www.jprl.com/Blog/archive/development/mono/mdoc/2010/Jan-10.html
_______________________________________________
Mono-devel-list mailing list
Mono-devel-list@lists.ximian.com
http://lists.ximian.com/mailman/listinfo/mono-devel-list
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic