This pull requests makes some improvements to the handling of Exceptions in the libraries folder.
In places where we are catching an Exception and throwing a new one, the new Exception will now include the previously caught Exception using the Exception API's ability to chain Exception objects.
Additionally, there were a couple of places where we were catching an Exception object and simply rethrowing it without any other processing, those places no longer catch Exceptions.
Minor doc block changes are included here.
Testing Instructions
This patch is a "needs review only" patch. There isn't a feasible way to write code that tests every one of these exception cases for the adjusted handling.
Thanks moving to
Needs Review
This comment was created with the J!Tracker Application at issues.joomla.org/joomla-cms/8005.