docs(phar,sqlite3): warn about symlinks in extractTo and drop unlink from prepare example

Author: lacatoire

reference/phar/Phar/extractTo.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: gui Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 04c8b5cf613b1b8ad5cdd80f17b872ad4012f0b8 Maintainer: gui Status: ready -->
 <refentry xml:id="phar.extractto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Phar::extractTo</refname>
@@ -28,6 +27,29 @@
    paramètre peut être passé à &true; pour activer l'écrasement de fichiers.
    Cette méthode est similaire à <function>ZipArchive::extractTo</function>.
   </para>
+
+  <warning>
+   <para>
+    L'extraction suit les liens symboliques existants dans le répertoire
+    cible <parameter>directory</parameter>. Si un lien symbolique est présent
+    dans le répertoire cible <parameter>directory</parameter> :
+
+    <simplelist>
+     <member>
+      si le lien symbolique pointe vers un autre répertoire, des fichiers
+      peuvent être extraits en dehors de l'emplacement souhaité.
+     </member>
+     <member>
+      si le lien symbolique pointe vers un fichier qui n'existe pas, celui-ci
+      sera créé.
+     </member>
+     <member>
+      si le lien symbolique pointe vers un fichier existant, la cible sera
+      écrasée lorsque <parameter>overwrite</parameter> vaut &true;.
+     </member>
+    </simplelist>
+   </para>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">

reference/phar/PharData/extractTo.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: gui Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 04c8b5cf613b1b8ad5cdd80f17b872ad4012f0b8 Maintainer: gui Status: ready -->
 <refentry xml:id="phardata.extractto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>PharData::extractTo</refname>
@@ -27,6 +26,29 @@
    que le troisième paramètre soit à &true;. Cette méthode est identique à
    <function>ZipArchive::extractTo</function>.
   </para>
+
+  <warning>
+   <para>
+    L'extraction suit les liens symboliques existants dans le répertoire
+    cible <parameter>directory</parameter>. Si un lien symbolique est présent
+    dans le répertoire cible <parameter>directory</parameter> :
+
+    <simplelist>
+     <member>
+      si le lien symbolique pointe vers un autre répertoire, des fichiers
+      peuvent être extraits en dehors de l'emplacement souhaité.
+     </member>
+     <member>
+      si le lien symbolique pointe vers un fichier qui n'existe pas, celui-ci
+      sera créé.
+     </member>
+     <member>
+      si le lien symbolique pointe vers un fichier existant, la cible sera
+      écrasée lorsque <parameter>overwrite</parameter> vaut &true;.
+     </member>
+    </simplelist>
+   </para>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">

reference/sqlite3/sqlite3/prepare.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 855bfee2f3db70d7dbb4c60c7c4a4efa567f1c60 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 0c7f4bd35fd53758ff6b66e2acefebd4a2ac6c06 Maintainer: yannick Status: ready -->
 <refentry xml:id="sqlite3.prepare" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>SQLite3::prepare</refname>
@@ -50,7 +49,6 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-unlink('mysqlitedb.db');
 $db = new SQLite3('mysqlitedb.db');
 
 $db->exec('CREATE TABLE foo (id INTEGER, bar STRING)');