[PATCH] D79095: [clang-format] NFC Correct clang-format headers file so documentation can be once again autogenerated

[MyDeveloperDay via Phabricator via cfe-commits]

MyDeveloperDay created this revision.
MyDeveloperDay added reviewers: mprobst, krasimir, mitchell-stellar, asmith.
MyDeveloperDay added projects: clang, clang-format.
MyDeveloperDay edited the summary of this revision.
MyDeveloperDay marked an inline comment as done.
MyDeveloperDay added inline comments.
MyDeveloperDay retitled this revision from "[clang-format] NFC Correct clang-format headers file so documentation can be one again autogenerated" to "[clang-format] NFC Correct clang-format headers file so documentation can be once again autogenerated".


================
Comment at: clang/docs/ClangFormatStyleOptions.rst:1752
      LoooooooooooooooooooooooooooooooongFunctionDeclaration();
 
+**InsertTrailingCommas** (``TrailingCommaStyle``)
----------------
NOTE: options are alphabetic in Format.h and so the position within the rst file will change.


`ClangFormatStyleOptions.rst` should ALWAYS be autogenerated from Format.h using `clang/docs/tools/dump_format_style.py` if not its liable to get removed leaving options undocumented.

This revision reworks the documentation for D73354: clang-format: insert trailing commas into containers. <https://reviews.llvm.org/D73354> D73768: clang-format: [JS] document InsertTrailingCommas. <https://reviews.llvm.org/D73768> to ensure we can continue to regenerated

Fix other minor changes that ensure the documentation remains consistent (Format.h obviously got re clang-formatted after the rst had been regenerated previously)

Generated documentation will look like

F11824218: image.png <https://reviews.llvm.org/F11824218>


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D79095

Files:
  clang/docs/ClangFormatStyleOptions.rst
  clang/include/clang/Format/Format.h

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D79095.260924.patch
Type: text/x-patch
Size: 4986 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20200429/7c301d52/attachment.bin>