Re: [Epydoc-devel] Epydoc URLs and external API linking

[Paul P. <pog...@gm...>]

Edward Loper wrote:
> On Feb 18, 2007, at 7:04 PM, Daniele Varrazzo wrote:
> > Edward, would you like to keep the current URL fragments with their  
> > small
> > shortcomings or do you prefer to mangle fragments? I prefer to  
> > decide it
> > before releasing the beta package, which is about ready.
> >
> > A simple naming scheme could be:
> >
> >   - prefix each uppercase and underscore with an underscore
> >   - prefix each name with a letter (let's say N, for "name")
> 
> Would this be done just for anchors, or for filenames as well?  I  
> guess this depends on whether we are assuming that files are written  
> to a case-insensitive filesystem.  I don't mind changing anchors too  
> much, but would rather not have the filenames become like N_My_Class- 
> class.html, if we can avoid it.  I guess perhaps there could be a  
> command-line switch to control whether the name mangling applies to  
> just the anchors or to the entire URL -- perhaps something like "-- 
> case-insensitive-filesystem" to reflect its intended usage.
> 
> Thoughts?

Yes, please.  Too much mangling is ugly.  And in this case it is only
for completeness sake, since for 99% of projects it will not matter.
So, please make it optional (as proposed) or disabled at all.

Paul