Rename ddoc.d -> ddoc_preprocessor.d

[wilzbach]

@ZombineDev pointed out that ddoc.d is a rather uninformative name.

[dlang-bot]

Thanks for your pull request, @wilzbach!

Bugzilla references

Your PR doesn't reference any Bugzilla issue.

If your PR contains non-trivial changes, please reference a Bugzilla issue or create a manual changelog.

[andralex]

I find this more confusing than before.

• Before: "ddoc.d -> aha, that is the file doing the ddoc stuff"
• After: "ddoc_preprocessor.d -> wait, is there some postprocessing or some other ddoc work as well that I need to worry about?"

Restructuring should add net value, this is at the very best a lateral step.

[wilzbach]

FYI: I opened this PR, s.t. #2072 doesn't get blocked.

For a bit of history:

• Add header TOC generation #2060 (automatic TOC generation with ddoc.d - merged - PR that introduced ddoc.d)
• Remove the assert->writeln pipeline in favor of the DDoc wrapper #2069 (moves the assert -> writeln step into ddoc.d - blocked)

[andralex]

So it seems we added automation that requires us to rename modules in our code. Seems the right place to change things is in the automation, no?

[wilzbach]

So it seems we added automation that requires us to rename modules in our code.

I'm not sure I can follow. To what "automation" are you referring to? Do you mean the assert->writeln transformation?
I added the rewriting of assert's in the runnable examples last year. However, it was always pretty ugly because (1) it requires making a full copy of the Phobos repository and (2) it requires the Phobos repository to be checked-out and thus always does the existence check (even on make clean). That's why @CyberShadow is so happy that removing that extra step in #2069, but I'm not sure how that's related to this PR which is just about renaming the tool.

I don't care how the Ddoc wrapper tool is named as long as the name bike-shedding doesn't block my PRs. Hence, I moved this in a separate PR.
(I picked ddoc.d myself, so I obviously liked it.)

[CyberShadow]

Debates about tiny inconsequent changes that take magnitudes more time than the change itself are not a good use of our time.

[CyberShadow]

(I picked ddoc.d myself, so I obviously liked it.)

I liked ddoc too. But it really doesn't matter.