[Mono-docs-list] Monodoc aspx .1

Ben Maurer bmaurer@users.sourceforge.net
14 Jul 2003 19:24:00 -0500

On Mon, 2003-07-14 at 17:54, Miguel de Icaza wrote:
> > This is the RootTree. That class has no help source. Maybe I should
> > replace this with if (n.tree is RootTree).
> Ok, but why would the RootTree trigger a render *there*?
If you were to click on Mono Documentation / Class Library.
> > Yeah, this was just a patch to allow those root:/ url's to load in the
> > browser. They are *not* necessary for the web client.
> I rather not have those then.
> > I have no problem with a new name.
> ok.  entry-point: or provider: or 
I personally like entry-point, I can change it to that.
> Ok, can you add that to the comments, so it is clear from the source?
> > The hack is meant to allow use to map the name of a provider (eg,
> > classlib) to the HelpSource for that provider. This way, we can allow
> > each provider to be responsible for its own root. If you can think of a
> > better way...I would love it.
> I do not understand why we need it though, so I would like to understand
> that part.
Well, we have the following tree:

Mono Documentation root:
|-Class Library root:/classlib

We need to be able to map the name "classlib" to the instance of
EcmaProvider which represents that, so that it can render the URL.
> > >   The changes to populate are also very bizarre, can you explain
> > > what they are for?  (They reference root:)
> > Before, each node below Mono Documentation had a url such as "classlib".
> > now they have "root:/classlib". 
> Ok, and what is that used for?
This gives the nodes the urls root:/classlib so that we can see them.

The best way to understand why I made these patches for web monodoc is
to try it out, you can see which pages are the root:/classlib like urls,
and why we need them for navigation.