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

[Jonathan Pryor]

On Tue, 2007-12-25 at 20:55 +0100, Steve Wagner wrote:
> Hi, currently i can not checkout the trunk on windows, because in
> "/monodoc/class/System.Security/en" are an file with name
> "System.Security.Cryptography.Xml" and an folder with the same name.
> 
> If i try to check out, ive allways get an "object of the same name
> already exists.

This implies that we'll need to change the directory layout "format"
produced by monodocer so that namespace XML files and the actual
namespace directories live in different locations.  Otherwise every
namespace that ends with "xml" (case-insensitive) will generate problems
on Windows and other case-insensitive platforms.

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.

Alternatively, namespace XML files can be placed into a separate
directory.  As long as no namespace can be confused with this directory,
there shouldn't be any ambiguity between type and/or namespace files,
e.g. using "en/Namespace-Docs/System.xml" for the XML documentation of
the System namespace.

Thoughts?

 - Jon