Skip to content

Conversation

@wilzbach
Copy link
Contributor

@wilzbach wilzbach commented Feb 5, 2018

We always want to use the latest $(DMD) to build the documentation as

This makes it more explicit and also adds $(DDOC_BIN) to a couple of other instances as:

  • this allows us to preview its output (verbatim)
  • it avoids the problem in the future that we add more features to the preprocessor and they don't end up in the PDF specification build

(this might produce changes in the verbatim files)

@dlang-bot
Copy link
Contributor

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.

import std.getopt;
auto helpInformation = getopt(
rootArgs, std.getopt.config.passThrough,
std.getopt.config.required,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

config.required suffices?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Config config; is defined above ;-)

################################################################################

DDOC_BIN:=$G/ddoc
DDOC_BIN_DMD:=$(DDOC_BIN) --compiler=$(DMD)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure where := became a thing in our makefiles. We've kept it for special cases so far.

Copy link
Contributor Author

@wilzbach wilzbach Feb 5, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we started to have ugly, hard-to-trace bugs due accidentally overwritten of variables, see e.g. #1953

@wilzbach wilzbach force-pushed the ddoc-bin branch 3 times, most recently from 1caf108 to 7055c53 Compare February 6, 2018 20:03
@wilzbach
Copy link
Contributor Author

wilzbach commented Feb 6, 2018

@ others. FYI: the diff is a bit larger because

  • the verbatim files are now run through the preprocessor
  • the dlangspec PDF and ebook files temporarily didn't run through the preprocessor (after the grammar section was automatically generated and this PR fixes this)

@CyberShadow
Copy link
Member

Something weird is happening in dlangspec.html now. Looks like the entire BNF grammar is getting dumped into the "Modules" section or something.

@wilzbach
Copy link
Contributor Author

wilzbach commented Feb 8, 2018

Looks like the entire BNF grammar is getting dumped into the "Modules" section or something.

It's the grammar file and expected (one of the reasons why I made this PR).
Background:

https://github.com/dlang/dlang.org/blob/master/spec/grammar.dd
#2135

(I accidentally forgot using the ddoc preprocessor for PDF + Ebook when I made the Grammar generating PR)

@wilzbach wilzbach changed the title Use the $(DDOC_BIN) preprocessor only with --compiler" Use the $(DDOC_BIN) preprocessor with --compiler" Feb 9, 2018
@dlang-bot dlang-bot merged commit d9852b6 into dlang:master Feb 9, 2018
@wilzbach wilzbach deleted the ddoc-bin branch July 18, 2018 11:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants