[Issue 23736] New: Do not override the "docs" directory without a warning

d-bugmail at puremagic.com d-bugmail at puremagic.com
Fri Feb 24 08:22:54 UTC 2023


https://issues.dlang.org/show_bug.cgi?id=23736

          Issue ID: 23736
           Summary: Do not override the "docs" directory without a warning
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P1
         Component: dmd
          Assignee: nobody at puremagic.com
          Reporter: rempas at tutanota.com

I saved my documentation in a directory called "docs". When I tried to generate
documentation, the compiler override this directory. Thank god, I hadn't
written any serious documentation yet! Please, make it check if there is a
directory and then warn to use the `-Dd` option and then abandon. I used `dub`
with `ldc` btw but I suppose that this is a frontend thing.

And just to be safe and ahead of time, If someone tells me that "I should have
known that and be careful", First, there is no info (at least I wasn't able to
find it) about the default name of the directory that is created so I couldn't
have known that. And second, we are humans and we do mistakes and forget
things. And that's why we need tools that protect us.

--


More information about the Digitalmars-d-bugs mailing list