[Mono-docs-list] [Mono-dev] Can not checkout trunk on windows

Jonathan Pryor jonpryor at vt.edu
Wed Jan 2 13:25:50 EST 2008


On Wed, 2007-12-26 at 10:32 -0500, Miguel de Icaza wrote:
> > Suggestions?  All I can suggest is that namespace XML files should
> > contain some character/string that namespaces are highly unlikely to
> > contain, e.g. instead of "en/System.xml" for the XML documentation on
> > the System namespace, use "en/Namespace-System.xml".  Any such
> > character/string *must* be usable on Windows, so no ':' or similar
> > characters can be used.
> 
> We should add support for a different name like:
> 
> 	ns-System.xml
> 
> And then we can rename the files for the docs that we maintain.

This has been done.  Mike Kestner suggested using a namespaces.xml file;
I chose not to do this as it made the migration of
monodocer/monodocs2html/ecma-provider easier.

> And keep the old code for documentation that might be out that has not
> been updated by us.

Monodoc will currently look for the older filename and rename
accordingly; ecma-provider will check for both, with a preference for
the non ns-prefixed name.

monodocs2html currently requires the ns- prefixed files, as I couldn't
think of an easy way to do the fallback within the XSLT.

 - Jon




More information about the Mono-docs-list mailing list