[Lldb-commits] [lldb] [lldb] Fix Doxygen warning in SBTrace.h (PR #170394)

via lldb-commits lldb-commits at lists.llvm.org
Tue Dec 2 16:17:50 PST 2025


llvmbot wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-lldb

Author: Zachary Fogg (zfogg)

<details>
<summary>Changes</summary>

## Summary
- Remove errant `\a` command before `<directory>` in `SaveToDisk` documentation
- The `\a` Doxygen command expects a word argument, but `<directory>` starts with `<` which Doxygen interprets as HTML
- This fixes: `Warning 564: Error parsing Doxygen command a: No word followed the command`

## Test plan
- Build LLDB with Doxygen enabled and verify warning no longer appears

---
Full diff: https://github.com/llvm/llvm-project/pull/170394.diff


1 Files Affected:

- (modified) lldb/include/lldb/API/SBTrace.h (+1-1) 


``````````diff
diff --git a/lldb/include/lldb/API/SBTrace.h b/lldb/include/lldb/API/SBTrace.h
index ce95595a423c9..d5368b234dd34 100644
--- a/lldb/include/lldb/API/SBTrace.h
+++ b/lldb/include/lldb/API/SBTrace.h
@@ -39,7 +39,7 @@ class LLDB_API SBTrace {
   SBTraceCursor CreateNewCursor(SBError &error, SBThread &thread);
 
   /// Save the trace to the specified directory, which will be created if
-  /// needed. This will also create a file \a <directory>/trace.json with the
+  /// needed. This will also create a file <directory>/trace.json with the
   /// main properties of the trace session, along with others files which
   /// contain the actual trace data. The trace.json file can be used later as
   /// input for the "trace load" command to load the trace in LLDB, or for the

``````````

</details>


https://github.com/llvm/llvm-project/pull/170394


More information about the lldb-commits mailing list