[clang] [Clang] Fix several `-Wdocumentation` warnings (NFC) (PR #70333)
Egor Zhdan via cfe-commits
cfe-commits at lists.llvm.org
Thu Oct 26 06:52:36 PDT 2023
https://github.com/egorzhdan created https://github.com/llvm/llvm-project/pull/70333
```
clang/include/clang/Lex/Preprocessor.h:2893:14: warning: parameter 'isEnter:' not found in the function declaration [-Wdocumentation]
/// \param isEnter: true if this PP is entering a region; otherwise, this PP
^~~~~~~~
clang/include/clang/Lex/Preprocessor.h:2895:14: warning: parameter 'Loc:' not found in the function declaration [-Wdocumentation]
/// \param Loc: the location of the entry or exit of a
^~~~
clang/include/clang/Lex/Preprocessor.h:2907:14: warning: parameter 'StartLoc:' not found in the function declaration [-Wdocumentation]
/// \param StartLoc: output argument. It will be set to the start location of
^~~~~~~~~
```
>From c292f3220ba7c37358836fb29d72e7ff6deb0ae4 Mon Sep 17 00:00:00 2001
From: Egor Zhdan <e_zhdan at apple.com>
Date: Thu, 26 Oct 2023 14:47:37 +0100
Subject: [PATCH] [Clang] Fix several `-Wdocumentation` warnings (NFC)
```
clang/include/clang/Lex/Preprocessor.h:2893:14: warning: parameter 'isEnter:' not found in the function declaration [-Wdocumentation]
/// \param isEnter: true if this PP is entering a region; otherwise, this PP
^~~~~~~~
clang/include/clang/Lex/Preprocessor.h:2895:14: warning: parameter 'Loc:' not found in the function declaration [-Wdocumentation]
/// \param Loc: the location of the entry or exit of a
^~~~
clang/include/clang/Lex/Preprocessor.h:2907:14: warning: parameter 'StartLoc:' not found in the function declaration [-Wdocumentation]
/// \param StartLoc: output argument. It will be set to the start location of
^~~~~~~~~
```
---
clang/include/clang/Lex/Preprocessor.h | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/clang/include/clang/Lex/Preprocessor.h b/clang/include/clang/Lex/Preprocessor.h
index bc1d94a61508d8d..77e0c04eef6a321 100644
--- a/clang/include/clang/Lex/Preprocessor.h
+++ b/clang/include/clang/Lex/Preprocessor.h
@@ -2875,9 +2875,9 @@ class Preprocessor {
/// Alter the state of whether this PP currently is in a
/// "-Wunsafe-buffer-usage" opt-out region.
///
- /// \param isEnter: true if this PP is entering a region; otherwise, this PP
+ /// \param isEnter true if this PP is entering a region; otherwise, this PP
/// is exiting a region
- /// \param Loc: the location of the entry or exit of a
+ /// \param Loc the location of the entry or exit of a
/// region
/// \return true iff it is INVALID to enter or exit a region, i.e.,
/// attempt to enter a region before exiting a previous region, or exiting a
@@ -2889,7 +2889,7 @@ class Preprocessor {
/// opt-out region
bool isPPInSafeBufferOptOutRegion();
- /// \param StartLoc: output argument. It will be set to the start location of
+ /// \param StartLoc output argument. It will be set to the start location of
/// the current "-Wunsafe-buffer-usage" opt-out region iff this function
/// returns true.
/// \return true iff this PP is currently in a "-Wunsafe-buffer-usage"
More information about the cfe-commits
mailing list