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

John McCall via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Mon May 4 14:32:25 PDT 2020


rjmccall added a comment.

In D79236#2018661 <https://reviews.llvm.org/D79236#2018661>, @rsmith wrote:

> 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. :-(


Do we need support from the website ops people on this, or do we just need to set up the build system properly to do it?


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