www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 11639] New: Documentation from files included using an absolute path ignore -Dd flag.

reply d-bugmail puremagic.com writes:
https://d.puremagic.com/issues/show_bug.cgi?id=11639

           Summary: Documentation from files included using an absolute
                    path ignore -Dd flag.
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: nobody puremagic.com
        ReportedBy: spam kalekold.net



---
Created an attachment (id=1297)
Documentation example

I've attached example files to demonstrate the problem. Compile this example
using this command:

rdmd -D -Dd../docs -op -I/Users/gary/Desktop/test/include main.d

The -Dd flag specifies i want all documentation to be generated in the
specified directory. The -op flag specifies i want the paths of the imported
files to be preserved in the resulting the documentation.

If i specify the 'include' folder using a relative path like this:
'-I../include' then everything works as expected. If i use an absolute path as
shown in the above example the documentation is scattered, ignoring the '-Dd'
flag placing *.html files next to their respective *.d files in the source
directories. This is not idea.

The correct behaviour for the command above would be as if i had passed a
relative include path.

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
Nov 29 2013
parent d-bugmail puremagic.com writes:
https://d.puremagic.com/issues/show_bug.cgi?id=11639




---
This isn't a rdmd bug this can be shown using a dmd command:

dmd -D -Dddocs -op /Users/gary/Desktop/test/main.d
/Users/gary/Desktop/test/include/library.d

Again, using absolute paths causes the *.html files to be besides the *.d files
and not in the 'docs' directory.

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