[Lldb-commits] [lldb] 9adf60f - [lldb] Fix lldb_assert -> lldbassert in docs

Jonas Devlieghere via lldb-commits lldb-commits at lists.llvm.org
Mon May 15 22:18:14 PDT 2023


Author: Jonas Devlieghere
Date: 2023-05-15T22:18:08-07:00
New Revision: 9adf60fc53fb105e331eec20e7fd2be71ee2a13c

URL: https://github.com/llvm/llvm-project/commit/9adf60fc53fb105e331eec20e7fd2be71ee2a13c
DIFF: https://github.com/llvm/llvm-project/commit/9adf60fc53fb105e331eec20e7fd2be71ee2a13c.diff

LOG: [lldb] Fix lldb_assert -> lldbassert in docs

Update the documentation to reference lldbassert rather than
lldb_assert. The latter is the implementation, which shouldn't be used
directly. Instead, users should use lldbassert which is the macro that
expands to assert or lldb_assert depending on the build type.

Added: 
    

Modified: 
    lldb/docs/resources/contributing.rst

Removed: 
    


################################################################################
diff  --git a/lldb/docs/resources/contributing.rst b/lldb/docs/resources/contributing.rst
index b2d4cf0e47181..5f4b24a8013e7 100644
--- a/lldb/docs/resources/contributing.rst
+++ b/lldb/docs/resources/contributing.rst
@@ -64,14 +64,14 @@ rules of thumb:
   errors cannot reasonably be surfaced to the end user, the error may
   be written to a topical log channel.
 
-* Soft assertions.  LLDB provides ``lldb_assert()`` as a soft
+* Soft assertions.  LLDB provides ``lldbassert()`` as a soft
   alternative to cover the middle ground of situations that indicate a
-  recoverable bug in LLDB.  In a Debug configuration ``lldb_assert()``
+  recoverable bug in LLDB.  In a Debug configuration ``lldbassert()``
   behaves like ``assert()``. In a Release configuration it will print a
   warning and encourage the user to file a bug report, similar to
   LLVM's crash handler, and then return execution. Use these sparingly
   and only if error handling is not otherwise feasible.  Specifically,
-  new code should not be using ``lldb_assert()`` and existing
+  new code should not be using ``lldbassert()`` and existing
   uses should be replaced by other means of error handling.
 
 * Fatal errors.  Aborting LLDB's process using


        


More information about the lldb-commits mailing list