php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #67010 Manual: Exceptions: "is not present" should be "is present"
Submitted: 2014-04-03 16:21 UTC Modified: 2015-06-14 15:10 UTC
From: william75 at yopmail dot com Assigned: cmb (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
 [2014-04-03 16:21 UTC] william75 at yopmail dot com 
Description:
------------
---
From manual page: http://www.php.net/language.exceptions
---

The page http://php.net/manual/en/language.exceptions.php currently reads:

"Normal execution (when no exception is thrown within the try block, or when a catch matching the thrown exception's class is not present) will continue after that last catch block defined in sequence."

The second half inside the parentheses is incorrect: "is not present" should on the contrary be "is present".

The error also exists in translations.

Patches

doc-bug-67010.patch (last revision 2015-03-25 21:33 UTC by patrick dot schwisow at gmail dot com)

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2014-11-22 00:18 UTC] cmbecker69 at gmx dot de 
> The second half inside the parentheses is incorrect: "is not
> present" should on the contrary be "is present".

IMHO both alternatives are misleading. It seems to me it's best to
simplify to:

| Normal execution (when no exception is thrown within the try
| block) will continue after that last catch block defined in
| sequence.

What happens when an exception is thrown (whether matched by a
catch or not) is explained in the following paragraph anyway.
 [2015-03-25 21:36 UTC] patrick dot schwisow at gmail dot com 
The attached patch takes cmbecker69's suggestion to remove part of the parenthetical clause.
 [2015-06-14 15:09 UTC] cmb@php.net 
Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&revision=336948
Log: simplified description of normal execution wrt. try-catch (fixes #67010)
 [2015-06-14 15:10 UTC] cmb@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: cmb
 [2015-06-14 15:10 UTC] cmb@php.net 
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.

And thanks for the patch, Patrick.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Fri Apr 19 21:01:30 2024 UTC