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.

Moved directly under the Language Reference.

(Leaving open to not forget to move user notes after manual rebuild.)

Notes moved.

try/catch is still not documented in the Control Structures chapter. I believe it should be there as it /is/ a control structure, and I looked for it in that section. Can we reopen the bug?

Also, what is present in the Exceptions chapter just scratches on the surface. Contrary to my expectations (and I'm inclined to believe this is a common mistake), try doesn't introduce a new scope. This means that this works (for some definition of works):

try {
 $x = new x;
 $x->throwsSometimes();
} catch (Exception $e) {}
$x->stillExistsInUnknownState();

as opposed to scoped locks, which require an intermediate function (because of that separate scope).

Also, the existing documentation completely bypasses the issue of exceptions thrown while the stack is unwinding (or whatever the PHP equivalent is). Which part of the reference says what will happen here?

class x0 extends Exception {};
class x1 extends Exception {};
class throwsindestructor { 
 function __destruct() {
  throw new x0;
 }
}
function f() { 
 $t = new throwsindestructor; 
 throw new x1; 
}
f(); 

Point being, a handful of examples cannot replace a reference manual, and a reference must be complete. A handful of examples is just that, you'll never cover enough ground, there'll be a lot of redundancy, and too much ambiguity. See the user notes at http://www.php.net/manual/en/language.exceptions.php for a list of things programmers look for in the (absent) try/catch reference.

Variables scope is described at http://www.php.net/manual/en/language.variables.scope.php.
Description of exceptions inside descructors are at http://www.php.net/manual/en/language.oop5.decon.php.