[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