Documentation from files included using an absolute path ignore -Dd flag.

[dlangBugzillaToGithub]

Gary Willoughby reported this on 2013-11-29T02:32:05Z

Transferred from https://issues.dlang.org/show_bug.cgi?id=11639

Description

Created attachment 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.

!!!There are attachements in the bugzilla issue that have not been copied over!!!

[dlangBugzillaToGithub]

spam commented on 2013-11-29T02:47:36Z

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.