#47097 [Asn]: DomainException documentation problem: insufficient description

From: Date: Wed, 14 Jan 2009 17:40:35 +0000
Subject: #47097 [Asn]: DomainException documentation problem: insufficient description
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-1716@lists.php.net to get a copy of this message
 ID:          47097
 Updated by:  bjori@php.net
 Reported By: me at signpostmarv dot name
 Status:      Assigned
-Bug Type:    Website problem
+Bug Type:    Documentation problem
 PHP Version: Irrelevant
 Assigned To: helly
 New Comment:

(reclassify as documentation problem)


Previous Comments:
------------------------------------------------------------------------

[2009-01-14 16:40:54] me at signpostmarv dot name

Google Code to the rescue! sort of :-S

http://code.google.com/p/biblioteca-de-alejandria/source/browse/trunk/workspace/Alejandria/src/ar/alejandria/exceptions/DomainException.java?r=23


Google Translate doesn't help all that much, but if you can find a
native speaker/reader they might be able to grok the intention of a
Domain Exception, then try and corroborate the meaning with other
sources.


~ SVN Humor FTW :-P

------------------------------------------------------------------------

[2009-01-14 15:11:58] me at signpostmarv dot name

I suppose the problem is that there are a few too many definitions of
"Domain" :-s

------------------------------------------------------------------------

[2009-01-14 15:10:48] me at signpostmarv dot name

I've no idea :-P

Perhaps ask whoever added DomainException to SPL in the first place ?

------------------------------------------------------------------------

[2009-01-14 14:29:13] bjori@php.net

Your are totally right. And there is a good reason for that: We have no
idea what its useful for :)

Marcus: Could you enlighten us? :)

------------------------------------------------------------------------

[2009-01-14 12:55:00] me at signpostmarv dot name

Description:
------------
"A domain exception" doesn't appear to be a particularly useful
description for the intended usage of the Exception class, when compared
to the other descriptions:

BadFunctionCallException
* Exception thrown if a callback refers to an undefined function or if
some arguments are missing

BadMethodCallException
*  Exception thrown if a callback refers to an undefined method or if
some arguments are missing


etc...

Expected result:
----------------
A sufficient explanation of the intended use of the DomainException
class, more in line with the descriptions of the other Exception classes
provided via the SPL.



------------------------------------------------------------------------


-- 
Edit this bug report at http://bugs.php.net/?id=47097&edit=1



Thread (1 message)

  • bjori@php.net
  • Unknown Message
    • bjori@php.net
« previous php.doc.bugs (#1716) next »