exception: use natural explanatory style

Author: dg

src/Utils/exceptions.php

@@ -11,39 +11,39 @@
 
 
 /**
- * The exception that is thrown when an image error occurs.
+ * An error occurred while working with the image.
  */
 class ImageException extends \Exception
 {
 }
 
 
 /**
- * The exception that indicates invalid image file.
+ * The image file is invalid or in an unsupported format.
  */
 class UnknownImageFileException extends ImageException
 {
 }
 
 
 /**
- * The exception that indicates error of JSON encoding/decoding.
+ * JSON encoding or decoding failed.
  */
 class JsonException extends \JsonException
 {
 }
 
 
 /**
- * The exception that indicates error of the last Regexp execution.
+ * Regular expression pattern or execution failed.
  */
 class RegexpException extends \Exception
 {
 }
 
 
 /**
- * The exception that indicates assertion error.
+ * Type validation failed. The value doesn't match the expected type constraints.
  */
 class AssertionException extends \Exception
 {

src/exceptions.php

@@ -11,98 +11,95 @@
 
 
 /**
- * The exception that is thrown when the value of an argument is
- * outside the allowable range of values as defined by the invoked method.
+ * The value is outside the allowed range.
  */
 class ArgumentOutOfRangeException extends \InvalidArgumentException
 {
 }
 
 
 /**
- * The exception that is thrown when a method call is invalid for the object's
- * current state, method has been invoked at an illegal or inappropriate time.
+ * The object is in a state that does not allow the requested operation.
  */
 class InvalidStateException extends \RuntimeException
 {
 }
 
 
 /**
- * The exception that is thrown when a requested method or operation is not implemented.
+ * The requested feature is not implemented.
  */
 class NotImplementedException extends \LogicException
 {
 }
 
 
 /**
- * The exception that is thrown when an invoked method is not supported. For scenarios where
- * it is sometimes possible to perform the requested operation, see InvalidStateException.
+ * The requested operation is not supported.
  */
 class NotSupportedException extends \LogicException
 {
 }
 
 
 /**
- * The exception that is thrown when a requested method or operation is deprecated.
+ * The requested feature is deprecated and no longer available.
  */
 class DeprecatedException extends NotSupportedException
 {
 }
 
 
 /**
- * The exception that is thrown when accessing a class member (property or method) fails.
+ * Cannot access the requested class property or method.
  */
 class MemberAccessException extends \Error
 {
 }
 
 
 /**
- * The exception that is thrown when an I/O error occurs.
+ * Failed to read from or write to a file or stream.
  */
 class IOException extends \RuntimeException
 {
 }
 
 
 /**
- * The exception that is thrown when accessing a file that does not exist on disk.
+ * The requested file does not exist.
  */
 class FileNotFoundException extends IOException
 {
 }
 
 
 /**
- * The exception that is thrown when part of a file or directory cannot be found.
+ * The requested directory does not exist.
  */
 class DirectoryNotFoundException extends IOException
 {
 }
 
 
 /**
- * The exception that is thrown when an argument does not match with the expected value.
+ * The provided argument has invalid type or format.
  */
 class InvalidArgumentException extends \InvalidArgumentException
 {
 }
 
 
 /**
- * The exception that is thrown when an illegal index was requested.
+ * The requested array or collection index does not exist.
  */
 class OutOfRangeException extends \OutOfRangeException
 {
 }
 
 
 /**
- * The exception that is thrown when a value (typically returned by function) does not match with the expected value.
+ * The returned value has unexpected type or format.
  */
 class UnexpectedValueException extends \UnexpectedValueException
 {