r210936 - Copy the documentation of -fstandalone-debug from the man page to the user

[Eric Christopher]

On Fri, Jun 13, 2014 at 3:04 PM, Adrian Prantl <aprantl at apple.com> wrote:
>
>> On Jun 13, 2014, at 2:58 PM, jahanian <fjahanian at apple.com> wrote:
>>
>>
>> On Jun 13, 2014, at 2:12 PM, Adrian Prantl <aprantl at apple.com> wrote:
>>
>>> Author: adrian
>>> Date: Fri Jun 13 16:12:31 2014
>>> New Revision: 210936
>>>
>>> URL: http://llvm.org/viewvc/llvm-project?rev=210936&view=rev
>>> Log:
>>> Copy the documentation of -fstandalone-debug from the man page to the user
>>> manual.
>>>
>>> rdar://problem/17307006
>>>
>>> Modified:
>>>   cfe/trunk/docs/UsersManual.rst
>>>
>>> Modified: cfe/trunk/docs/UsersManual.rst
>>> URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/UsersManual.rst?rev=210936&r1=210935&r2=210936&view=diff
>>> ==============================================================================
>>> --- cfe/trunk/docs/UsersManual.rst (original)
>>> +++ cfe/trunk/docs/UsersManual.rst Fri Jun 13 16:12:31 2014
>>> @@ -1298,6 +1298,22 @@ below. If multiple flags are present, th
>>>  doesn't contain any other data (e.g. description of local variables or
>>>  function parameters).
>>>
>>>
>>
>>> +  with debug information.  Note that Clang will never emit type
>>> +  information for types that are not referenced at all by the program.
>>
>> Is this really so? Frequently, in debugging we want to use a type in a debug expression even if the
>> type is not used in the program. Am I getting this statement out of context?
>
> Yes that is really the case. Debug type information takes up a lot of space so clang is very strict in only including debug info for types that are actually used. That said, I am working on debug info support for modules (& precomiled headers), which will allow the debugger to instantiate every type that is defined in a clang module referenced by the program.
>

In the old terminology we default to "-gused" and don't support "-gfull".

A -gfull option would be nice if you're working on it.

-eric

> -- adrian
>
>>
>> - Fariborz
>>
>>> +
>>> .. option:: -g
>>>
>>>  Generate complete debug info.
>>>
>>>
>>> _______________________________________________
>>> cfe-commits mailing list
>>> cfe-commits at cs.uiuc.edu
>>> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits
>
> _______________________________________________
> cfe-commits mailing list
> cfe-commits at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits