Thread overview
[Issue 12526] New: DDox possible issue with case sensitive file names
Apr 06, 2014
Martin Nowak
Apr 06, 2014
Sönke Ludwig
Apr 06, 2014
Martin Nowak
April 06, 2014
https://d.puremagic.com/issues/show_bug.cgi?id=12526

           Summary: DDox possible issue with case sensitive file names
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: websites
        AssignedTo: nobody@puremagic.com
        ReportedBy: code@dawg.eu


--- Comment #0 from Martin Nowak <code@dawg.eu> 2014-04-06 07:17:12 PDT ---
Not sure where this comes from (case insensitive file system?) but the documentation for TaskPool is missing. It's page is overwritten by the documentation for taskPool and the taskPool.html page doesn't exist.

http://dlang.org/library/std/parallelism/taskPool.html http://dlang.org/library/std/parallelism/TaskPool.html

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
April 06, 2014
https://d.puremagic.com/issues/show_bug.cgi?id=12526


Sönke Ludwig <sludwig@outerproduct.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |sludwig@outerproduct.org


--- Comment #1 from Sönke Ludwig <sludwig@outerproduct.org> 2014-04-06 07:35:44 PDT ---
Exactly, Andrei generates the website on an OS X box, which uses case insensitive HFS by default. AFAICS there is no way to talk the OS to still store files case sensitive (like there is on Windows) other than using a partition with a case sensitive FS, so there are only two options: find some alternative file name scheme that doesn't rely on case, or switch to a case sensitive file system when generating the documentation.

Andrei's suggestion was to just aggregate everything under the all lower case version of the name. This would be an option, but requires some reorganization of how DDOX outputs the pages, breaks old links (probably still acceptable at this point?) and slightly waters the one entity == one page concept (which is of course already not working for function overloads).

All the other schemes that came to mind (such as numbering pages with names of different case, or escaping upper case letters) are either ugly or would result in transient links. My favorite would obviously be to just switch the file system, but of course Andrei has the last call there - and it also wouldn't be the worst thing to have something that works on any OS/FS.

Any other ideas how to solve this? If not, I'll look into the aggregation solution as soon as I get some time for that.

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
April 06, 2014
https://d.puremagic.com/issues/show_bug.cgi?id=12526



--- Comment #2 from Martin Nowak <code@dawg.eu> 2014-04-06 08:03:48 PDT ---
Aggregation seems feasible because the two entities have a close relation, i.e. usually the lower case is a constructor using IFTI. http://dlang.org/library/std/range/outputRangeObject.html http://dlang.org/library/std/range/OutputRangeObject.html

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------