D issues are now tracked on GitHub. This Bugzilla instance remains as a read-only archive.
Issue 11639 - Documentation from files included using an absolute path ignore -Dd flag.
Summary: Documentation from files included using an absolute path ignore -Dd flag.
Status: NEW
Alias: None
Product: D
Classification: Unclassified
Component: dmd (show other issues)
Version: D2
Hardware: All All
: P3 normal
Assignee: No Owner
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-11-29 02:32 UTC by Gary Willoughby
Modified: 2024-12-13 18:14 UTC (History)
0 users

See Also:


Attachments
Documentation example (2.58 KB, application/zip)
2013-11-29 02:32 UTC, Gary Willoughby
Details

Note You need to log in before you can comment on or make changes to this issue.
Description Gary Willoughby 2013-11-29 02:32:05 UTC
Created attachment 1297 [details]
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.
Comment 1 Gary Willoughby 2013-11-29 02:47:36 UTC
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.
Comment 2 dlangBugzillaToGithub 2024-12-13 18:14:36 UTC
THIS ISSUE HAS BEEN MOVED TO GITHUB

https://github.com/dlang/dmd/issues/18727

DO NOT COMMENT HERE ANYMORE, NOBODY WILL SEE IT, THIS ISSUE HAS BEEN MOVED TO GITHUB