aboutsummaryrefslogtreecommitdiff
path: root/clang/lib/Format
diff options
context:
space:
mode:
authorOwen Pan <owenpiano@gmail.com>2025-06-26 19:14:34 -0700
committerGitHub <noreply@github.com>2025-06-26 19:14:34 -0700
commitf2f17e563df9d79bd3319c12d95bab5c66fc34d8 (patch)
treed28a42daa44efed845d1cff3d6dddd4c13dbfafa /clang/lib/Format
parentad6b597875b9d3523b4466a4c62b4c9d55940b79 (diff)
downloadllvm-f2f17e563df9d79bd3319c12d95bab5c66fc34d8.zip
llvm-f2f17e563df9d79bd3319c12d95bab5c66fc34d8.tar.gz
llvm-f2f17e563df9d79bd3319c12d95bab5c66fc34d8.tar.bz2
[clang-format][NFC] Remove `\brief` from comments (#145853)
This was done before in https://reviews.llvm.org/D46320
Diffstat (limited to 'clang/lib/Format')
-rw-r--r--clang/lib/Format/ContinuationIndenter.h15
-rw-r--r--clang/lib/Format/UnwrappedLineParser.cpp12
-rw-r--r--clang/lib/Format/WhitespaceManager.h2
3 files changed, 14 insertions, 15 deletions
diff --git a/clang/lib/Format/ContinuationIndenter.h b/clang/lib/Format/ContinuationIndenter.h
index ac354aa..fe957cf 100644
--- a/clang/lib/Format/ContinuationIndenter.h
+++ b/clang/lib/Format/ContinuationIndenter.h
@@ -210,8 +210,8 @@ struct ParenState {
IsChainedConditional(false), IsWrappedConditional(false),
UnindentOperator(false) {}
- /// \brief The token opening this parenthesis level, or nullptr if this level
- /// is opened by fake parenthesis.
+ /// The token opening this parenthesis level, or nullptr if this level is
+ /// opened by fake parenthesis.
///
/// Not considered for memoization as it will always have the same value at
/// the same token.
@@ -344,16 +344,15 @@ struct ParenState {
bool IsCSharpGenericTypeConstraint : 1;
- /// \brief true if the current \c ParenState represents the false branch of
- /// a chained conditional expression (e.g. else-if)
+ /// true if the current \c ParenState represents the false branch of a chained
+ /// conditional expression (e.g. else-if)
bool IsChainedConditional : 1;
- /// \brief true if there conditionnal was wrapped on the first operator (the
- /// question mark)
+ /// true if there conditionnal was wrapped on the first operator (the question
+ /// mark)
bool IsWrappedConditional : 1;
- /// \brief Indicates the indent should be reduced by the length of the
- /// operator.
+ /// Indicates the indent should be reduced by the length of the operator.
bool UnindentOperator : 1;
bool operator<(const ParenState &Other) const {
diff --git a/clang/lib/Format/UnwrappedLineParser.cpp b/clang/lib/Format/UnwrappedLineParser.cpp
index 61b8412..c961ce7 100644
--- a/clang/lib/Format/UnwrappedLineParser.cpp
+++ b/clang/lib/Format/UnwrappedLineParser.cpp
@@ -340,7 +340,7 @@ bool UnwrappedLineParser::precededByCommentOrPPDirective() const {
(Previous->IsMultiline || Previous->NewlinesBefore > 0);
}
-/// \brief Parses a level, that is ???.
+/// Parses a level, that is ???.
/// \param OpeningBrace Opening brace (\p nullptr if absent) of that level.
/// \param IfKind The \p if statement kind in the level.
/// \param IfLeftBrace The left brace of the \p if block in the level.
@@ -2574,7 +2574,7 @@ bool UnwrappedLineParser::parseBracedList(bool IsAngleBracket, bool IsEnum) {
return false;
}
-/// \brief Parses a pair of parentheses (and everything between them).
+/// Parses a pair of parentheses (and everything between them).
/// \param AmpAmpTokenType If different than TT_Unknown sets this type for all
/// double ampersands. This applies for all nested scopes as well.
///
@@ -3438,7 +3438,7 @@ void UnwrappedLineParser::parseAccessSpecifier() {
addUnwrappedLine();
}
-/// \brief Parses a requires, decides if it is a clause or an expression.
+/// Parses a requires, decides if it is a clause or an expression.
/// \pre The current token has to be the requires keyword.
/// \returns true if it parsed a clause.
bool UnwrappedLineParser::parseRequires(bool SeenEqual) {
@@ -3582,7 +3582,7 @@ bool UnwrappedLineParser::parseRequires(bool SeenEqual) {
return true;
}
-/// \brief Parses a requires clause.
+/// Parses a requires clause.
/// \param RequiresToken The requires keyword token, which starts this clause.
/// \pre We need to be on the next token after the requires keyword.
/// \sa parseRequiresExpression
@@ -3612,7 +3612,7 @@ void UnwrappedLineParser::parseRequiresClause(FormatToken *RequiresToken) {
FormatTok->Previous->ClosesRequiresClause = true;
}
-/// \brief Parses a requires expression.
+/// Parses a requires expression.
/// \param RequiresToken The requires keyword token, which starts this clause.
/// \pre We need to be on the next token after the requires keyword.
/// \sa parseRequiresClause
@@ -3636,7 +3636,7 @@ void UnwrappedLineParser::parseRequiresExpression(FormatToken *RequiresToken) {
}
}
-/// \brief Parses a constraint expression.
+/// Parses a constraint expression.
///
/// This is the body of a requires clause. It returns, when the parsing is
/// complete, or the expression is incorrect.
diff --git a/clang/lib/Format/WhitespaceManager.h b/clang/lib/Format/WhitespaceManager.h
index 5dd667f..6d18db7 100644
--- a/clang/lib/Format/WhitespaceManager.h
+++ b/clang/lib/Format/WhitespaceManager.h
@@ -212,7 +212,7 @@ private:
/// \c EscapedNewlineColumn for the first tokens or token parts in a line.
void calculateLineBreakInformation();
- /// \brief Align consecutive C/C++ preprocessor macros over all \c Changes.
+ /// Align consecutive C/C++ preprocessor macros over all \c Changes.
void alignConsecutiveMacros();
/// Align consecutive assignments over all \c Changes.