[LLVMbugs] [Bug 16837] New: Debug mode status page doesn't contain how to enable debug mode

[bugzilla-daemon at llvm.org]

http://llvm.org/bugs/show_bug.cgi?id=16837

            Bug ID: 16837
           Summary: Debug mode status page doesn't contain how to enable
                    debug mode
           Product: libc++
           Version: 3.2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P
         Component: All Bugs
          Assignee: hhinnant at apple.com
          Reporter: gonzalobg88 at gmail.com
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified

The debug mode status page doesn't contain how to enable debug mode... ! 

http://libcxx.llvm.org/debug_mode.html

The page should at least be extended with: 

"To enable libc++'s debug mode, define the macro XXXXXXX.".

Extra info:

Howard wrote in September 2011 (see
http://lists.cs.uiuc.edu/pipermail/cfe-dev/2011-September/017177.html ): 

"I've checked in an experimental implementation of this.

-D_LIBCPP_DEBUG2

gets you the "standard" debugging mode, which includes checking for iterator
invalidation.

-D_LIBCPP_DEBUG2=0

gets you "debug lite".  This only checks things that are really cheap such as
those you mention.

I've left the door open for:

-D_LIBCPP_DEBUG2=2

which would make even more expensive checks (e.g. check the invariants of a
red/black tree)." 

I don't know if this is still up to date. Furthermore, Google tells me that:
- the macro _LIBCPP_DEBUG is used for the old debug mode (deprecated? does it
still work?)
- the macro _LIBCPP_DEBUG2 is used for the new debug mode (the one documented
in the page?)

Maybe these two should also be documented on the page.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20130808/70a4fbbe/attachment.html>