diff --git a/language/control-structures/finally.xml b/language/control-structures/finally.xml
index 01bce64d67..4fa2478391 100644
--- a/language/control-structures/finally.xml
+++ b/language/control-structures/finally.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 6af4cd5be387fcb28cabfca49f0d9109ebfc660f Maintainer: lacatoire Status: ready -->
 
 <sect1 xml:id="control-structures.finally" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>finally</title>
@@ -27,7 +27,7 @@ function inverse($x) {
 
 try {
     echo inverse(5) . "\n";
-} catch (\DivisionByZeroError $e) {
+} catch (DivisionByZeroError $e) {
     echo 'Erreur attrapée : ', $e->getMessage(), "\n";
 } finally {
     echo "Premier finally.\n";
@@ -35,7 +35,7 @@ try {
 
 try {
     echo inverse(0) . "\n";
-} catch (\DivisionByZeroError $e) {
+} catch (DivisionByZeroError $e) {
     echo 'Erreur attrapée : ', $e->getMessage(), "\n";
 } finally {
     echo "Second finally.\n";
@@ -250,7 +250,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch (\Exception $e) {
+    } catch (Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -297,7 +297,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch (\Exception $e) {
+    } catch (Exception $e) {
         echo 'catch';
     } finally {
         echo "finally\n";
@@ -454,7 +454,7 @@ function generate()
     try {
         yield 1;
         yield 2;
-    } catch (\Exception $e) {
+    } catch (Exception $e) {
         echo 'catch';
     } finally {
         echo "finally interne\n";
diff --git a/reference/mysqli/mysqli_stmt/insert-id.xml b/reference/mysqli/mysqli_stmt/insert-id.xml
index be4786dc3c..1475758b19 100644
--- a/reference/mysqli/mysqli_stmt/insert-id.xml
+++ b/reference/mysqli/mysqli_stmt/insert-id.xml
@@ -1,14 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 5d8dfb31071496ffd2d51609ba098e6c9a3ce0d2 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: aa135ef2689157299c23fd4b8eb8c4f70733deaa Maintainer: yannick Status: ready -->
 <refentry xml:id="mysqli-stmt.insert-id" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli_stmt::$insert_id</refname>
   <refname>mysqli_stmt_insert_id</refname>
-  <refpurpose>Récupère l'ID généré par la dernière requête INSERT</refpurpose>
+  <refpurpose>Retourne la valeur générée pour une colonne AUTO_INCREMENT par la dernière requête exécutée</refpurpose>
  </refnamediv>
- 
+
  <refsect1 role="description">
   &reftitle.description;
   <para>&style.oop;</para>
@@ -18,11 +16,117 @@
    <type class="union"><type>int</type><type>string</type></type><methodname>mysqli_stmt_insert_id</methodname>
    <methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam>
   </methodsynopsis>
-  
-  &warn.undocumented.func;
-  
+  <simpara>
+   Retourne l'ID généré par une requête <literal>INSERT</literal> ou
+   <literal>UPDATE</literal> sur une table avec une colonne ayant l'attribut
+   <literal>AUTO_INCREMENT</literal>. Dans le cas d'une requête
+   <literal>INSERT</literal> multilignes, elle retourne la première valeur
+   générée automatiquement qui a été insérée avec succès. Si
+   <literal>LAST_INSERT_ID(expr)</literal> est utilisé pour définir la valeur
+   de <literal>AUTO_INCREMENT</literal>, ou dans une requête
+   <literal>UPDATE</literal>, la valeur de <literal>expr</literal> est
+   retournée à la place.
+  </simpara>
+  <simpara>
+   Retourne <literal>0</literal> si la requête n'a pas modifié de valeur
+   <literal>AUTO_INCREMENT</literal>.
+  </simpara>
  </refsect1>
- 
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   &mysqli.stmt.description;
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   La valeur du champ <literal>AUTO_INCREMENT</literal> modifié par la
+   requête. Retourne zéro si la requête n'a pas encore été exécutée ou si
+   elle n'a pas modifié de valeur <literal>AUTO_INCREMENT</literal>.
+  </simpara>
+  <simpara>
+   La valeur est propre à l'objet de requête. Elle n'est pas affectée par les
+   autres requêtes exécutées sur la même connexion après cette requête, ni
+   par les requêtes émises via d'autres connexions ou clients.
+  </simpara>
+  <note>
+   <simpara>
+    Si le nombre est plus grand que la valeur maximale d'un entier, il sera
+    retourné sous forme de &string;.
+   </simpara>
+  </note>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemple avec <varname>mysqli_stmt::$insert_id</varname></title>
+   <simpara>&style.oop;</simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
+$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
+
+$mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");
+
+$stmt = $mysqli->prepare("INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");
+
+$name = 'Stuttgart';
+$countryCode = 'DEU';
+$district = 'Stuttgart';
+$population = 617000;
+$stmt->bind_param('sssi', $name, $countryCode, $district, $population);
+$stmt->execute();
+
+printf("Le nouvel enregistrement a l'ID %d.\n", $stmt->insert_id);
+]]>
+   </programlisting>
+   <simpara>&style.procedural;</simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
+$link = mysqli_connect("localhost", "my_user", "my_password", "world");
+
+mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");
+
+$stmt = mysqli_prepare($link, "INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");
+
+$name = 'Stuttgart';
+$countryCode = 'DEU';
+$district = 'Stuttgart';
+$population = 617000;
+mysqli_stmt_bind_param($stmt, 'sssi', $name, $countryCode, $district, $population);
+mysqli_stmt_execute($stmt);
+
+printf("Le nouvel enregistrement a l'ID %d.\n", mysqli_stmt_insert_id($stmt));
+]]>
+   </programlisting>
+   &examples.outputs;
+   <screen>
+<![CDATA[
+Le nouvel enregistrement a l'ID 1.
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+
+  <simplelist>
+   <member><function>mysqli_insert_id</function></member>
+   <member><function>mysqli_stmt_affected_rows</function></member>
+   <member><function>mysqli_stmt_execute</function></member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables: