[TableGen] [Docs] Add lldb-tblgen to command guide; add 4 stubs for xxx-tblgen commands

[Paul-C-Anagnostopoulos]

Summary

This revision adds the lldb-tblgen command options to the tblgen command guide.

It also adds four stub documents, xxx-tblgen, for the four flavors of TableGen, which simply refer the reader to the primary command guide.

[lattner]

I'm not up to speed on the doc structure.

[aaronpuchert]

The comments apply similarly to the other files,

llvm/docs/CommandGuide/clang-tblgen.rst

2

I'd say "Description to C++ Code for Clang".

It can be a bunch of things like command line options, diagnostic messages, attributes, so I think it's hard to find something overarching here.

5

Should this say clang-tblgen? Not sure how this works.

23

Can we use * instead of xxx here?

[Paul-C-Anagnostopoulos]

Incorporate Aaron's comments.

[Paul-C-Anagnostopoulos]

Now let's actually include the changes.

[aaronpuchert]

I'm wondering if we should move the files to their respective subprojects, but that would probably prevent the links from working. So I guess we have to live with this for now.

[jrtc27]

llvm/docs/CommandGuide/tblgen.rst

1

This is what ends up in the mange's file name, so we now have a file called tblgen Family.1 being built, which is clearly not a good idea. Please change this.

1

*manpage's

[brooks]

This results in a manpage with the filename tblgen Family.1 which quite odd.

[jrtc27]

llvm/docs/CommandGuide/clang-tblgen.rst

20

These references are wrong; the real title doesn't have "Target" in it (since that's specifically for llvm-tblgen)

[Paul-C-Anagnostopoulos]

llvm/docs/CommandGuide/tblgen.rst

1

What do you suggest I change it to?

[jrtc27]

llvm/docs/CommandGuide/tblgen.rst

1

I'd suggest just removing the Family? Then it matches .. program:: below and the name of the rst file itself.

[Paul-C-Anagnostopoulos]

llvm/docs/CommandGuide/tblgen.rst

1

Sounds good. I will do this on Friday.

[jrtc27]

llvm/docs/CommandGuide/tblgen.rst

1

Thanks

[Paul-C-Anagnostopoulos]

Do you think it's necessary to have the change of document title reviewed in Phabricator?

[jrtc27]

In D99605#2677896, @Paul-C-Anagnostopoulos wrote:

Do you think it's necessary to have the change of document title reviewed in Phabricator?

I wouldn't bother, especially since we've discussed the exact change already

[Paul-C-Anagnostopoulos]

I pushed this patch.

[jrtc27]

In D99605#2679568, @Paul-C-Anagnostopoulos wrote:

I pushed this patch.

Great, thanks for the quick follow-up.