[Mono-docs-list] Long term Monodoc feature requests.

Fawad Halim fawad@fawad.net
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'.

-fawad

Rodolfo Campero wrote:

> Hi,
> 
>> From: Todd Berman <tberman@sevenl.net>
>> To: Miguel de Icaza <miguel@ximian.com>
>> CC: mono-docs-list@lists.ximian.com
>> Subject: Re: [Mono-docs-list] Long term Monodoc feature requests.
>> Date: Thu, 10 Jun 2004 02:53:35 -0400
>>
>> Miguel de Icaza wrote:
>>
>>> Hello,
>>>
>>>
>>>> 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
>>> timeline.
>>
>>
>> Absolutely agree :)
>>
>> --Todd
>>
>>>
>>> Miguel.
>>
>>
>> _______________________________________________
>> Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com
>> http://lists.ximian.com/mailman/listinfo/mono-docs-list
> 
> 
> _________________________________________________________________
> The new MSN 8: smart spam protection and 2 months FREE*  
> http://join.msn.com/?page=features/junkmail
> 
> _______________________________________________
> Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list
>