com doc/ja: Fix/clarify dirname/basename docs wrt. locales: reference/filesystem/functions/basename.xml reference/filesystem/functions/dirname.xml

Commit:    be7a5ed14c6265033004e75ed9196f770aeada0c=0AAuthor:    Yoshinari =
Takaoka <[email protected]>         Sat, 20 Feb 2021 05:12:42 +0900=0AParen=
ts:   b127eb156f5dacb81ca88da9382cafd4fb968e33=0ABranches:  master=0A=0ALin=
k:       http://git.php.net/?p=3Ddoc/ja.git;a=3Dcommitdiff;h=3Dbe7a5ed14c62=
65033004e75ed9196f770aeada0c=0A=0ALog:=0AFix/clarify dirname/basename docs =
wrt. locales=0A=0AFor basename(), we declare the behavior regarding invalid=
 characters in=0Athe path as being undefined, since that depends on the ava=
ilability of=0Amblen, and also on the position of the invalid characters pr=
ior to PHP=0A8.0.0[1].=0A=0Adirname() is actually not local-aware, but reli=
es on an ASCII=0Acompatible character encoding regarding the directory sepa=
rator.  On=0AWindows, it is however, dependent on the currently set codepag=
e=0A(although a fallback is still in place to use the Windows ANSI codepage=
=0Aof the operating system[2], if the string is not valid for the current=
=0Acodepage).=0A=0AAgain, we declared failure to comply to these assumption=
s as resulting=0Ain undefined behavior.  Users should make sure to pass val=
id strings.=0A=0A[1] <http://git.php.net/?p=3Dphp-src.git;a=3Dcommitdiff;h=
=3D90705d44e3da1d0aa7b8b4fd921ec597391eccb2>=0A[2] <https://github.com/php/=
php-src/blob/5e015425263c28d40fd49ee386135f02d0e76975/win32/codepage.h#L95-=
L106>=0A=0AChanged paths:=0A  M  reference/filesystem/functions/basename.xm=
l=0A  M  reference/filesystem/functions/dirname.xml=0A=0A=0ADiff:=0Adiff --=
git a/reference/filesystem/functions/basename.xml b/reference/filesystem/fu=
nctions/basename.xml=0Aindex c6ce024965..9633348eb3 100644=0A--- a/referenc=
e/filesystem/functions/basename.xml=0A+++ b/reference/filesystem/functions/=
basename.xml=0A@@ -1,6 +1,6 @@=0A <?xml version=3D"1.0" encoding=3D"utf-8"?=
>=0A <!-- $Revision$ -->=0A-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd1=
60f9057429a Maintainer: hirokawa Status: ready -->=0A+<!-- EN-Revision: 88c=
1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: hirokawa Status: ready --=
>=0A <!-- Credits: mumumu -->=0A <refentry xml:id=3D"function.basename" xml=
ns=3D"http://docbook.org/ns/docbook">=0A  <refnamediv>=0A@@ -31,6 +31,8 @@=
=0A     <function>basename</function> =E3=81=AF=E3=83=AD=E3=82=B1=E3=83=
=BC=E3=83=AB=E3=81=AB=E4=BE=9D=E5=AD=98=E3=81=97=E3=81=BE=E3=81=99=E3=80=
=82=0A     =E3=83=9E=E3=83=AB=E3=83=81=E3=83=90=E3=82=A4=E3=83=88=E6=96=
=87=E5=AD=97=E3=82=92=E5=90=AB=E3=82=80=E3=83=91=E3=82=B9=E3=81=A7=E6=AD=
=A3=E3=81=97=E3=81=84=E7=B5=90=E6=9E=9C=E3=82=92=E5=BE=97=E3=82=8B=E3=81=
=AB=E3=81=AF=E3=80=81=E3=81=9D=E3=82=8C=E3=81=A8=E4=B8=80=E8=87=B4=E3=81=
=99=E3=82=8B=E3=83=AD=E3=82=B1=E3=83=BC=E3=83=AB=E3=82=92=0A     <function>=
setlocale</function> =E3=81=A7=E8=A8=AD=E5=AE=9A=E3=81=97=E3=81=A6=E3=81=
=8A=E3=81=8B=E3=81=AA=E3=81=91=E3=82=8C=E3=81=B0=E3=81=AA=E3=82=8A=E3=81=
=BE=E3=81=9B=E3=82=93=E3=80=82=0A+    =E7=8F=BE=E5=9C=A8=E3=81=AE=E3=83=
=AD=E3=82=B1=E3=83=BC=E3=83=AB=E3=81=8B=E3=82=89=E8=A6=8B=E3=81=A6=E4=B8=
=8D=E6=AD=A3=E3=81=AA=E6=96=87=E5=AD=97=E3=81=8C <parameter>path</parameter=
> =E3=81=AB=E5=90=AB=E3=81=BE=E3=82=8C=E3=81=A6=E3=81=84=E3=81=9F=E5=A0=
=B4=E5=90=88=E3=80=81=0A+    <function>basename</function> =E3=81=AE=
=E5=8B=95=E4=BD=9C=E3=81=AF=E6=9C=AA=E5=AE=9A=E7=BE=A9=E3=81=A7=E3=81=99=
=E3=80=82=0A    </para>=0A   </caution>=0A  </refsect1>=0Adiff --git a/refe=
rence/filesystem/functions/dirname.xml b/reference/filesystem/functions/dir=
name.xml=0Aindex 0b8d2e9199..df9d0374bb 100644=0A--- a/reference/filesystem=
/functions/dirname.xml=0A+++ b/reference/filesystem/functions/dirname.xml=
=0A@@ -1,6 +1,6 @@=0A <?xml version=3D"1.0" encoding=3D"utf-8"?>=0A <!-- $R=
evision$ -->=0A-<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 =
Maintainer: hirokawa Status: ready -->=0A+<!-- EN-Revision: 88c1f8d6c9fecf3=
52c5ce152a6f758ed013fc2c0 Maintainer: hirokawa Status: ready -->=0A <!-- CR=
EDITS: shimooka,mumumu -->=0A <refentry xmlns=3D"http://docbook.org/ns/docb=
ook" xml:id=3D"function.dirname">=0A  <refnamediv>=0A@@ -28,9 +28,17 @@=0A =
  </note>=0A   <caution>=0A    <para>=0A-    <function>dirname</function> =
=E3=81=AF=E3=83=AD=E3=82=B1=E3=83=BC=E3=83=AB=E3=81=AB=E4=BE=9D=E5=AD=98=
=E3=81=97=E3=81=BE=E3=81=99=E3=80=82=0A-    =E3=83=9E=E3=83=AB=E3=83=81=
=E3=83=90=E3=82=A4=E3=83=88=E6=96=87=E5=AD=97=E3=82=92=E5=90=AB=E3=82=80=
=E3=83=91=E3=82=B9=E3=81=A7=E6=AD=A3=E3=81=97=E3=81=84=E7=B5=90=E6=9E=9C=
=E3=82=92=E5=BE=97=E3=82=8B=E3=81=AB=E3=81=AF=E3=80=81=E3=81=9D=E3=82=8C=
=E3=81=A8=E4=B8=80=E8=87=B4=E3=81=99=E3=82=8B=E3=83=AD=E3=82=B1=E3=83=BC=
=E3=83=AB=E3=82=92=0A-    <function>setlocale</function> =E3=81=A7=E8=A8=
=AD=E5=AE=9A=E3=81=97=E3=81=A6=E3=81=8A=E3=81=8B=E3=81=AA=E3=81=91=E3=82=
=8C=E3=81=B0=E3=81=AA=E3=82=8A=E3=81=BE=E3=81=9B=E3=82=93=E3=80=82=0A+    W=
indows =E3=81=A7=E3=81=AF=E3=80=81<function>dirname</function>=0A+    =
=E3=81=AF=E7=8F=BE=E5=9C=A8=E8=A8=AD=E5=AE=9A=E3=81=95=E3=82=8C=E3=81=A6=
=E3=81=84=E3=82=8B=E3=82=B3=E3=83=BC=E3=83=89=E3=83=9A=E3=83=BC=E3=82=B8=
=E3=81=AB=E4=BE=9D=E5=AD=98=E3=81=97=E3=81=BE=E3=81=99=E3=80=82=0A+    =
=E3=82=88=E3=81=A3=E3=81=A6=E3=80=81=E3=83=9E=E3=83=AB=E3=83=81=E3=83=90=
=E3=82=A4=E3=83=88=E6=96=87=E5=AD=97=E3=81=8C=E5=90=AB=E3=81=BE=E3=82=8C=
=E3=81=9F=E3=83=91=E3=82=B9=E3=82=92=E6=AD=A3=E3=81=97=E3=81=8F=E8=A1=A8=
=E7=A4=BA=E3=81=99=E3=82=8B=E3=81=AB=E3=81=AF=E3=80=81=0A+    =E3=81=9D=
=E3=82=8C=E3=81=A8=E4=B8=80=E8=87=B4=E3=81=99=E3=82=8B=E3=82=B3=E3=83=BC=
=E3=83=89=E3=83=9A=E3=83=BC=E3=82=B8=E3=81=8C=E8=A8=AD=E5=AE=9A=E3=81=95=
=E3=82=8C=E3=81=A6=E3=81=84=E3=81=AA=E3=81=91=E3=82=8C=E3=81=B0=E3=81=84=
=E3=81=91=E3=81=BE=E3=81=9B=E3=82=93=E3=80=82=0A+    =E7=8F=BE=E5=9C=A8=
=E3=81=AE=E3=82=B3=E3=83=BC=E3=83=89=E3=83=9A=E3=83=BC=E3=82=B8=E3=81=8B=
=E3=82=89=E8=A6=8B=E3=81=A6=E4=B8=8D=E6=AD=A3=E3=81=AA=E6=96=87=E5=AD=97=
=E3=81=8C <parameter>path</parameter>  =E3=81=AB=E5=90=AB=E3=81=BE=E3=82=
=8C=E3=81=A6=E3=81=84=E3=81=9F=E5=A0=B4=E5=90=88=E3=80=81=0A+    <function>=
basename</function> =E3=81=AE=E5=8B=95=E4=BD=9C=E3=81=AF=E6=9C=AA=E5=AE=
=9A=E7=BE=A9=E3=81=A7=E3=81=99=E3=80=82=0A+   </para>=0A+   <para>=0A+    W=
indows =E4=BB=A5=E5=A4=96=E3=81=AE=E3=82=B7=E3=82=B9=E3=83=86=E3=83=A0=
=E3=81=A7=E3=81=AF=E3=80=81=0A+    <parameter>path</parameter> =E3=81=AFASC=
II =E3=81=A8=E4=BA=92=E6=8F=9B=E6=80=A7=E3=81=8C=E3=81=82=E3=82=8B=E3=82=
=A8=E3=83=B3=E3=82=B3=E3=83=BC=E3=83=87=E3=82=A3=E3=83=B3=E3=82=B0=E3=81=
=A7=E3=82=A8=E3=83=B3=E3=82=B3=E3=83=BC=E3=83=89=E3=81=95=E3=82=8C=E3=81=
=A6=E3=81=84=E3=82=8B=E3=81=A8=E6=83=B3=E5=AE=9A=E3=81=95=E3=82=8C=E3=81=
=A6=E3=81=84=E3=81=BE=E3=81=99=E3=80=82=0A+    =E3=81=9D=E3=81=86=E3=81=
=A7=E3=81=AA=E3=81=84=E5=A0=B4=E5=90=88=E3=80=81=E3=81=93=E3=81=AE=E9=96=
=A2=E6=95=B0=E3=81=AE=E5=8B=95=E4=BD=9C=E3=81=AF=E6=9C=AA=E5=AE=9A=E7=BE=
=A9=E3=81=A7=E3=81=99=E3=80=82=0A    </para>=0A   </caution>=0A  </refsect1=
>=0A