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);
}
**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``)
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.

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
--------