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
_______________________________________________
LibreOffice mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/libreoffice

Reply via email to