]> https://gitweb.dealii.org/ - dealii.git/commitdiff
add a note on -Og and -O0 debug flags
authorDenis Davydov <davydden@gmail.com>
Fri, 6 Jan 2017 19:19:41 +0000 (20:19 +0100)
committerDenis Davydov <davydden@gmail.com>
Fri, 6 Jan 2017 19:19:41 +0000 (20:19 +0100)
doc/readme.html

index 1b4a74681d8d4cc3ec48b6ac6a2939f566678c57..7f3bb705ce9e993b8d2c220e444f149a156a94fc 100644 (file)
          are usually found almost instantaneously, displaying the file
          name and line number of where the problem occurred.
        </p>
+       <p>
+         Debug mode, by default, uses the <code>-Og</code> flag. It promises most of the
+         debugging experience of <code>-O0</code> but at a better performance.
+         This is a reasonable choice for unit tests and enables numerous asserts
+         within the library. Sometimes, however, one needs Debug mode to use
+         <code>-O0</code> (e.g. GCC 6.2.0 optimizes out local variables with <code>-Og</code>).
+         This can be achieved by configuring <acronym>deal.II</acronym> with
+         <code>-DDEAL_II_HAVE_FLAG_Og=false</code>.
+       </p>
        </li>
 
        <li> <i>Optimized mode</i>: You will want to link with this version of

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.