I like that idea as well.  I hadn’t really thought about documenting the exceptions to catch, but I can see that is important as well.  For semantic reasons, I would want to separate the exceptions from the standard IO parameters, mainly because the parameters are “good” behavior, and exceptions are, well, just that - exceptions.

 

Thanks for the response…

 

Jared

 

-----Original Message-----
From: Steve Nelson [mailto:[EMAIL PROTECTED]]
Sent: Wednesday, May 01, 2002 1:41 PM
To: [EMAIL PROTECTED]
Subject: Re: Fusedoc-ing Exceptions

 

Jared-

That's an interesting idea. I wonder if it should be part of the in/out IO section? Like <cfthrow>s for the <out>s and <cfcatch>s for the <in>s.

I don't know, this is something we should play around with more.

Steve Nelson

Jared Stark wrote:

This is probably something that has been discussed on the fbsteer list, but since I can barely make it through all my emails as it is I don’t subscribe to it.

I’m wondering about fusedoc-ing exceptions that may be thrown within a template, specifically I mean user defined exceptions.For example, in my fuses if an attribute is missing I will throw a ‘com.mycompany.attributes.MissingAttributesException’.I would like to document that somehow so that A) the developer writing the fuse knows about it, and B) a developer using the fuse will know about the exception and can gracefully handle it (hopefully).I imagine something like:

<exceptions>

            <exception type=”com.mycompany.Attributes.MissingAttributeException” onCondition=”A required attribute is missing” comments=”” />

            etc…

</exceptions>

Has something like this been proposed? How does everyone currently document exceptions?*Does* anyone currently document exceptions, or am I (yet again) up in the night?

Thanks,

Jared

==^================================================================
This email was sent to: [EMAIL PROTECTED]
 
EASY UNSUBSCRIBE click here: http://topica.com/u/?bUrFMa.bWatp0
Or send an email to: [EMAIL PROTECTED]
 
T O P I C A -- Register now to manage your mail!
http://www.topica.com/partner/tag02/register
==^================================================================


==^================================================================
This email was sent to: [email protected]

EASY UNSUBSCRIBE click here: http://topica.com/u/?bUrFMa.bV0Kx9
Or send an email to: [EMAIL PROTECTED]

T O P I C A -- Register now to manage your mail!
http://www.topica.com/partner/tag02/register
==^================================================================

Reply via email to