• d-bugmail puremagic.com (24/24) Feb 24 2023 https://issues.dlang.org/show_bug.cgi?id=23736

d-bugmail puremagic.com writes:

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 puremagic.com
          Reporter: rempas 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.

--