www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 12526] New: DDox possible issue with case sensitive file names

reply d-bugmail puremagic.com writes:
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: -------
Apr 06 2014
next sibling parent d-bugmail puremagic.com writes:
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: -------
Apr 06 2014
prev sibling parent d-bugmail puremagic.com writes:
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: -------
Apr 06 2014