[PATCH] D137865: [clang-format][NFC] Improve documentation on ReflowComments

[Emilia Dreamer via Phabricator via cfe-commits]

rymiel added inline comments.


================
Comment at: clang/include/clang/Format/Format.h:3073-3076
+  /// If ``true``, clang-format will attempt to re-flow comments. That is it
+  /// will touch a comment and *reflow* long comments into new lines, trying to
+  /// obey the ``ColumnLimit``. ``/*`` comments will get a leading ``*`` on the
+  /// new lines.
----------------
HazardyKnusperkeks wrote:
> owenpan wrote:
> > Let's leave it as is because the new lines don't always get a leading `*`:
> > ```
> > $ cat foo.cpp
> > /* The LLVM Project is a collection of modular and reusable compiler and toolchain
> >    technologies. */
> > $ clang-format -style='{ReflowComments: true}' foo.cpp
> > /* The LLVM Project is a collection of modular and reusable compiler and
> >    toolchain technologies. */
> > ```
> That was from a short glimpse on the code.
> Adapted the text.
> Let's leave it as is because the new lines don't always get a leading `*`:

I suppose this also ties into https://github.com/llvm/llvm-project/issues/58710




CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D137865/new/

https://reviews.llvm.org/D137865