[PATCH] D94169: [clang][driver] Restore the original help text for `-I`

Andrei Lebedev via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Thu Jan 7 12:58:55 PST 2021


andreil99 added a comment.

Post commit review is a normal practice in the LLVM community. This is not an excuse to revert somebody's patch per se, unless there are other serious reasons for the revert.  The text does not describe “clang internals”, it describes the semantic of that flag with respect to other flags specifically to clang (I’m sure the text could be improved and open to suggestions).

At the time when the original patch was done this td file was not shared with flang and such plans weren’t announced, it was quite the opposite, one of the flang driver RFCs specifically mentioned a separate *.td file, if memory serves me well.  And I do apologize if I missed something, I didn’t follow flang discussions closely back in July/August of the last year.

Now since you have started sharing, we need to find a good way to have front-end specifics in the documentation, which happens to be auto-generated from a shared td file. Stripping it down to only matching subset of things between multiple different front-ends would hurt documentation quality. Let’s discuss here of what could be done about that, or feel free to move the discussion somewhere else.


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D94169/new/

https://reviews.llvm.org/D94169



More information about the cfe-commits mailing list