#47097 [Opn->Csd]: DomainException documentation problem: insufficient description

ID: 47097 Updated by: vrana@php.net Reported By: me at signpostmarv dot name -Status: Open +Status: Closed Bug Type: Documentation problem PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: ------------------------------------------------------------------------ [2009-03-02 21:07:01] helly@php.net Domain means data domain here. That is a DomainException shall be through whenever a value does not adhere to a defined valid data domain. Examples: - 0 is not a in the domain for division. - Foo is not in the domain for weekdays. The first is different from out of range and alike, but you could use InvalidParameter in case it is actually a parameter to the function that performs the division. If it is a value calculated inside the function prior to executing the division and then a pre-conditon check throws instead of executing the division, then it becomes a DomainException. The second could be seen as an OutOfRangeException. ------------------------------------------------------------------------ [2009-01-14 17:40:34] bjori@php.net (reclassify as documentation problem) ------------------------------------------------------------------------ [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 ? ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/47097 -- Edit this bug report at http://bugs.php.net/?id=47097&edit=1