<html>
    <head>
      <base href="http://llvm.org/bugs/" />
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW --- - Debug mode status page doesn't contain how to enable debug mode"
   href="http://llvm.org/bugs/show_bug.cgi?id=16837">16837</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>Debug mode status page doesn't contain how to enable debug mode
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>libc++
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>3.2
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>enhancement
          </td>
        </tr>

        <tr>
          <th>Priority</th>
          <td>P
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>All Bugs
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>hhinnant@apple.com
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>gonzalobg88@gmail.com
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>llvmbugs@cs.uiuc.edu
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr></table>
      <p>
        <div>
        <pre>The debug mode status page doesn't contain how to enable debug mode... ! 

<a href="http://libcxx.llvm.org/debug_mode.html">http://libcxx.llvm.org/debug_mode.html</a>

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
<a href="http://lists.cs.uiuc.edu/pipermail/cfe-dev/2011-September/017177.html">http://lists.cs.uiuc.edu/pipermail/cfe-dev/2011-September/017177.html</a> ): 

"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.</pre>
        </div>
      </p>
      <hr>
      <span>You are receiving this mail because:</span>
      
      <ul>
          <li>You are on the CC list for the bug.</li>
      </ul>
    </body>
</html>