Doc #68290 [NEW]: "finally" keyword barely explained

From: Date: Thu, 23 Oct 2014 07:42:41 +0000
Subject: Doc #68290 [NEW]: "finally" keyword barely explained
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-11571@lists.php.net to get a copy of this message
From:             jeroen at asystance dot nl
Operating system: 
PHP version:      Irrelevant
Package:          Documentation problem
Bug Type:         Documentation Problem
Bug description:"finally" keyword barely explained

Description:
------------
---
From manual page: http://www.php.net/language.exceptions
---

The example (#2) given to illustrate the "finally" keyword works exactly
the same (i.e. produces the same output) without finally. Therefore, the
documentation does not show any benefit to using it, nor does it make
clear how it affects the execution flow.

Fortunately, there are a few user contributed notes which show effects
of finally. It should however not be up to users to explain basic
syntax, especially since there are apparently some non-intuitive aspects
(e.g. finally block being run _after_ return in the try block).


-- 
Edit bug report at https://bugs.php.net/bug.php?id=68290&edit=1
-- 
Try a snapshot (PHP 5.4):   https://bugs.php.net/fix.php?id=68290&r=trysnapshot54
Try a snapshot (PHP 5.5):   https://bugs.php.net/fix.php?id=68290&r=trysnapshot55
Try a snapshot (trunk):     https://bugs.php.net/fix.php?id=68290&r=trysnapshottrunk
Fixed in SVN:               https://bugs.php.net/fix.php?id=68290&r=fixed
Fixed in release:           https://bugs.php.net/fix.php?id=68290&r=alreadyfixed
Need backtrace:             https://bugs.php.net/fix.php?id=68290&r=needtrace
Need Reproduce Script:      https://bugs.php.net/fix.php?id=68290&r=needscript
Try newer version:          https://bugs.php.net/fix.php?id=68290&r=oldversion
Not developer issue:        https://bugs.php.net/fix.php?id=68290&r=support
Expected behavior:          https://bugs.php.net/fix.php?id=68290&r=notwrong
Not enough info:            https://bugs.php.net/fix.php?id=68290&r=notenoughinfo
Submitted twice:            https://bugs.php.net/fix.php?id=68290&r=submittedtwice
register_globals:           https://bugs.php.net/fix.php?id=68290&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=68290&r=php4
Daylight Savings:           https://bugs.php.net/fix.php?id=68290&r=dst
IIS Stability:              https://bugs.php.net/fix.php?id=68290&r=isapi
Install GNU Sed:            https://bugs.php.net/fix.php?id=68290&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=68290&r=float
No Zend Extensions:         https://bugs.php.net/fix.php?id=68290&r=nozend
MySQL Configuration Error:  https://bugs.php.net/fix.php?id=68290&r=mysqlcfg



Thread (2 messages)

« previous php.doc.bugs (#11571) next »