[Mono-docs-list] Long term Monodoc feature requests.
Thu, 10 Jun 2004 09:51:54 -0500
The problem is that the Various node is effectively useless. The
monodoc.xml specifies the title of the top level nodes in the tree. I
can't think of a single piece of document that could possibly go under
the title 'Various'.
Rodolfo Campero wrote:
>> From: Todd Berman <firstname.lastname@example.org>
>> To: Miguel de Icaza <email@example.com>
>> CC: firstname.lastname@example.org
>> Subject: Re: [Mono-docs-list] Long term Monodoc feature requests.
>> Date: Thu, 10 Jun 2004 02:53:35 -0400
>> Miguel de Icaza wrote:
>>>> 2) Register docs not through the main monodoc module. Monodoc has
>>>> wonderful editing facilities, useful for .net projects outside of
>>>> just mono + gtk-sharp. If it were easy/possible to register zip
>>>> files in a way other than through the one .xml file, that would make
>>>> it far easier. As it stands even now, the debugger puts docs into
>>>> place that monodoc wont load for some reason. We could even
>>>> potentially remove the need for the xml file and have some special
>>>> file put into the .zip file that monodoc looks for to identify why
>>>> sort of provider to use. This is another change that should be
>>>> hidden from the various monodoc.dll consumers.
>>> The warning that you see is only a warning for applying *patches*, so it
>>> is a warning that today only applies to me (as the sole administrator of
>>> the public server).
>> I was talking about monodoc/browser/monodoc.xml, which appears to be
>> part of how monodoc figures out what to load and how to do it. This
>> makes project X unable to easily install documentation that monodoc
>> will just find. I could be wrong, and that xml file isnt used for
>> loading at all, but I am pretty sure it is. That is what im talking
>> about needing to change, to make monodoc able to display docs for
>> installed documentation of any kind, not just stuff we publish.
> As far as I could see, there's a node called "various" in monodoc.xml.
> I think the intention is that other projects plug their documentation
> under this category; please someone at Novell correct me if I'm wrong.
>>> You can safely ignore this.
>>> The rest, I agree with you, but its not something doable in the 1.0
>> Absolutely agree :)
>> Mono-docs-list maillist - Monoemail@example.com
> The new MSN 8: smart spam protection and 2 months FREE*
> Mono-docs-list maillist - Monofirstname.lastname@example.org