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

[Adrian Prantl]

> 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.

-- 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