com doc/fr: Apply commit 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0: reference/filesystem/functions/basename.xml reference/filesystem/functions/dirname.xml

[email protected] (George Peter Banyard) Wed, 24 Feb 2021 17:45:12 +0000
Newsgroups php.doc.fr
Message-ID <[email protected]>
Commit:    2a712bd05df4576e7f632c84eaf3f43dfb132fa6
Author:    George Peter Banyard <[email protected]>         Wed, 24 Feb 2021 15:18:49 +0000
Parents:   2bb81c556e97b809ed3239c0255ec36a1b84086a
Branches:  master

Link:       http://git.php.net/?p=doc/fr.git;a=commitdiff;h=2a712bd05df4576e7f632c84eaf3f43dfb132fa6

Log:
Apply commit 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0

Fix/clarify dirname/basename docs wrt. locales

Changed paths:
  M  reference/filesystem/functions/basename.xml
  M  reference/filesystem/functions/dirname.xml


Diff:
diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml
index 21ccbd79ae..2c5a4ca9e8 100644
--- a/reference/filesystem/functions/basename.xml
+++ b/reference/filesystem/functions/basename.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes Maintainer: itanea -->
+<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: yannick Status: ready -->
+<!-- Reviewed: no Maintainer: itanea -->
 <refentry xml:id="function.basename" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>basename</refname>
@@ -30,6 +30,9 @@
     <function>basename</function> est sensible à la locale, donc si le chemin possède
     des caractères multi-octets, la locale qui convient doit être enregistrée
     au moyen de la fonction <function>setlocale</function>.
+    Si <parameter>path</parameter> contient des caractères qui sont invalides
+    pour la locale courante, le comportement de <function>basename</function>
+    est indéfini.
     </para>
   </caution>
  </refsect1>
diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml
index 1ed68be809..094524d065 100644
--- a/reference/filesystem/functions/dirname.xml
+++ b/reference/filesystem/functions/dirname.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.dirname">
@@ -30,9 +30,18 @@
   </note>
   <caution>
    <para>
-    <function>dirname</function> est sensible à la locale, donc si le chemin possède
-    des caractères multi-octets, la locale qui convient doit être enregistrée
-    au moyen de la fonction <function>setlocale</function>.
+    Sur Windows, <function>dirname</function> assume que la codepage actuellement
+    définie, donc pour qu'il puisse voir le nom de dossier correct avec des
+    caractères multi-octets dans le chemin, la codepage correspondante doit
+    être définie.
+    Si <parameter>path</parameter> contient des caractères qui sont invalides
+    pour la codepage courante, le comportement de <function>basename</function>
+    est indéfini.
+   </para>
+   <para>
+    Sur d'autres systèmes, <function>dirname</function> assume que <parameter>path</parameter>
+    est encodé dans un encodage compatible ASCII. Sinon le comportement de la
+    fonction est indéfinie.
    </para>
   </caution>
  </refsect1>