clang-format: [JS] document InsertTrailingCommas.

Summary: In release notes and the regular docs.

Reviewers: MyDeveloperDay

Subscribers: cfe-commits

Tags: #clang

Differential Revision: https://reviews.llvm.org/D73768
This commit is contained in:
Martin Probst 2020-01-31 10:23:02 +01:00
parent 5cc5fce4b0
commit dc04c54fc1
2 changed files with 25 additions and 0 deletions

View File

@ -717,6 +717,26 @@ the configuration (without a prefix: ``Auto``).
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa); aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa);
} }
**InsertTrailingCommas** (``TrailingCommaStyle``) can be set to ``TCS_Wrapped``
to insert trailing commas in container literals (arrays and objects) that wrap
across multiple lines. It is currently only available for JavaScript and
disabled by default (``TCS_None``).
``InsertTrailingCommas`` cannot be used together with ``BinPackArguments`` as
inserting the comma disables bin-packing.
.. code-block:: c++
TSC_Wrapped:
const someArray = [
aaaaaaaaaaaaaaaaaaaaaaaaaa,
aaaaaaaaaaaaaaaaaaaaaaaaaa,
aaaaaaaaaaaaaaaaaaaaaaaaaa,
// ^ inserted
]
**BinPackParameters** (``bool``) **BinPackParameters** (``bool``)
If ``false``, a function declaration's or function definition's If ``false``, a function declaration's or function definition's
parameters will either all be on the same line or will have one line each. parameters will either all be on the same line or will have one line each.

View File

@ -175,6 +175,11 @@ clang-format
} }
} }
- Option ``InsertTrailingCommas`` can be set to ``TCS_Wrapped`` to insert
trailing commas in container literals (arrays and objects) that wrap across
multiple lines. It is currently only available for JavaScript and disabled by
default (``TCS_None``).
libclang libclang
-------- --------