[clang] Automatically generate builtin documentation from a .td File.

[StevenYangCC]

Currently, the builtin documentation is hand written into .rst. It would be better if that documentation could live on the builtin in the .td file, similar to how already works for things like attributes and warnings.

[AaronBallman]

I'm not certain what this issue is asking for. Which documentation should come from a .def file? (We already table generate much of our documentation, such as attributes, command line options, and diagnostic flags.)

[jhuber6]

I'm not certain what this issue is asking for. Which documentation should come from a .def file? (We already table generate much of our documentation, such as attributes, command line options, and diagnostic flags.)

They also opened #139036 and #139037 which makes me think this is just LLM generated spam.

[StevenYangCC]

It would be very useful to automatically generate documentation for the builtin interface based on the .def description.

[jhuber6]

It would be very useful to automatically generate documentation for the builtin interface based on the .def description.

We already do that in Tablegen. The real suggestion would be to port over all of our remaining .def files toy Tablegen.

[StevenYangCC]

It would also be useful if the .def files could all be ported to Tablegen.

[StevenYangCC]

@AaronBallman The readability of the current builtin interface described in a .def file is terrible.

[jhuber6]

@AaronBallman The readability of the current builtin interface described in a .def file is terrible.

Feel free to make a PR that ports your favorite .def file to Tablegen. Like #122873 for example.

[StevenYangCC]

@jhuber6 I'd like to throw this out here for discussion first.

[StevenYangCC]

@AaronBallman The readability of the current builtin interface described in a .def file is terrible.

Feel free to make a PR that ports your favorite .def file to Tablegen. Like #122873 for example.

But there are no comments here to fully describe the function and parameters, either.

[AaronBallman]

Thanks for the clarification! I've made some edits to the issue so it's easier for others to understand without having to read all the comments.