[PATCH] D79236: [docs] Regenerate DiagnosticsReference.rst

Richard Smith - zygoloid via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Mon May 4 13:26:58 PDT 2020


rsmith added a comment.

In D79236#2015982 <https://reviews.llvm.org/D79236#2015982>, @rjmccall wrote:

> There's no good reason for this file to exist; documenting the warning options is useful, but the file should be generated as an intermediate output of the documentation build and then ultimately fed into Sphinx.
>
> There's even a TODO in the docs about it:
>
> > TODO: Generate this from tblgen. Define one anchor per warning group.


We do generate this document with tblgen already. The problem is that it's not automatically regenerated as part of the docs build on the website, unlike some of our other similar tblgen-generated documentation. I've asked for that to happen repeatedly for years but so far I have achieved zero traction. So the best we have right now is to manually regenerate this every once in a while and check it in. :-(


Repository:
  rG LLVM Github Monorepo

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

https://reviews.llvm.org/D79236





More information about the cfe-commits mailing list