Skip to content

Commit

Permalink
Remove DEMANGLE_SUPPORT from docs (NFC) (#21430)
Browse files Browse the repository at this point in the history
  • Loading branch information
cwoffenden authored Feb 26, 2024
1 parent 018e16f commit 1e875ed
Showing 1 changed file with 1 addition and 6 deletions.
7 changes: 1 addition & 6 deletions site/source/docs/porting/Debugging.rst
Original file line number Diff line number Diff line change
Expand Up @@ -137,11 +137,6 @@ Some important settings are:
performance. Default value is 1 if ``ASSERTIONS=1`` is set, and disabled
otherwise.

-
.. _debugging-DEMANGLE_SUPPORT:

``DEMANGLE_SUPPORT=1`` links in code to automatically demangle stack traces, that is, emit human-readable C++ function names instead of ``_ZN..`` ones.

A number of other useful debug settings are defined in `src/settings.js <https://github.com/emscripten-core/emscripten/blob/main/src/settings.js>`_. For more information, search that file for the keywords "check" and "debug".

.. _debugging-sanitizers:
Expand All @@ -166,7 +161,7 @@ Manual print debugging

You can also manually instrument the source code with ``printf()`` statements, then compile and run the code to investigate issues. Note that ``printf()`` is line-buffered, make sure to add ``\n`` to see output in the console.

If you have a good idea of the problem line you can add ``print(new Error().stack)`` to the JavaScript to get a stack trace at that point. Also available is :js:func:`stackTrace`, which emits a stack trace and also tries to demangle C++ function names if ``DEMANGLE_SUPPORT`` is enabled (if you don't want or need C++ demangling in a specific stack trace, you can call :js:func:`jsStackTrace`).
If you have a good idea of the problem line you can add ``print(new Error().stack)`` to the JavaScript to get a stack trace at that point.

Debug printouts can even execute arbitrary JavaScript. For example::

Expand Down

0 comments on commit 1e875ed

Please sign in to comment.