Change in core[master]: restore --enable-symbols option again -- was FYI: Cleanup of debug options

[Stephan Bergmann]

On 11/07/2012 10:02 PM, David Ostrovsky wrote:
> On 07.11.2012 17:16, Tor Lillqvist wrote:
>>     If no one has any opinion on it, I'm going to name it
>>     --enable-symbols-only.
>>
>> I don't like that, as it strongly suggests that this option would
>> cause some kind of lighter, symbol/address mapping only kind of data
>> to be emitted, as opposed to full debug information. Which is doesn't,
>> at least not for all platforms. Or am I missing something?
> no, you are right, it's the same symbol information as with full debug
> information (on all platforms). The difference between the two is only
> optimization:
>
>                  O | S | D | T
> --------------------------------------
> production-code| x | - | - | -
> --------------------------------------
> enable-symbols | x | x | - | -
> --------------------------------------
> enable-debug   | - | x | - | -
> --------------------------------------
> enable-dbgutil | - | x | x | x
>
> where
> O: optimization
> S: symbols
> D: debug STL
> T: trace facility

(If by "T: trace facility" you mean sal/log.hxx functionality compiled 
in, then that is "x" for "enable-debug," too.)

One problem with "S: symbols" is that "symbols" is a vague term here. 
Quoting 
<http://lists.freedesktop.org/archives/libreoffice/2012-September/037977.html> 
"[Libreoffice-qa] minutes of ESC call ...":  "First of all, note that 
--enable-symbols is a misnomer.  It is not per-se about any kind of 
symbols (like not stripping internal symbols on ELF, etc.), but rather 
about debugging information.  (With GCC it enables -g 'Produce debugging 
information' 
[<http://gcc.gnu.org/onlinedocs/gcc-4.7.1/gcc/Debugging-Options.html#Debugging-Options>] 
(or -g2, -ggdb2), with MSVC it enables /Zi 'enable debugging 
information' ['cl /?' output].)"

> So to reflect what these options mean exactly one should name it as follows:
> enable-symbols: --enable-symbols-and-preserve-optimization
> enable-debug: --enable-symbols-and-disable-optimization
> enable-dbgutil:
> --enable-symbols-and-disable-optimization-and-enable-debugstl-and-enable-trace-facility
>
> Given that we don't want to rename two last options, we are trying to
> find a new (less confusing and not so long) name
> for the first one:
> --enable-symbols-and-preserve-optimization

In light of the above, --enable-debugging-information or some shortening 
like --enable-debug-info?

Stephan