[llvm-commits] Fwd: [Patch] Exception Handling Documentation

[Chris Lattner]

On Jul 30, 2011, at 9:44 PM, Bill Wendling wrote:

> On Jul 30, 2011, at 10:02 AM, Chris Lattner wrote:
> 
>> +  <a name="i_resume">'<tt>resume</tt>' Instruction</a>
>> 
>> Is "resume" the final name for this instruction?
>> 
> I have a slight preference for it above a more verbose name. But I can be convinced otherwise. I think that it's descriptive enough as it is, how it's documented, and how it's used. If you have a strong preference for resume_unwind, or something more descriptive, I can change it.

I'm perfectly happy with 'resume'.  Others have expressed other preferences.  I'm fine with letting "he who codes" win in this case.

>> When an exception is thrown by a runtime system, it walks up the stack looking for frames that may potentially handle it.  These frames are indicated by having call sites formed with '<a>invoke' instructions.  When the runtime system finds a frame that has an invoke in it, it transfers control flow into the function, at the point of a landingpad instruction....
>> 
>> This also gives you a place to put a (SIMPLE!) example or two, which is essential.
>> 
> There's all ready an HTML doc about exception handling and an overview, which describes the main concepts very well: http://llvm.org/docs/ExceptionHandling.html#overview Would a pointer to this be okay?

Yes, that would be fine.  Thanks,

-Chris