svn: /phpdoc/ja/trunk/reference/filesystem/functions/ readlink.xml

mumumu                                   Fri, 03 Jul 2020 00:40:50 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=350098

Log:
Document different behavior of readlink() on Windows

Cf. <https://github.com/php/php-src/pull/3825#issuecomment-467837181>.

While we're at it, we also fix the order of the "returnvalues" and "changelog" sections.

Changed paths:
    U   phpdoc/ja/trunk/reference/filesystem/functions/readlink.xml

Modified: phpdoc/ja/trunk/reference/filesystem/functions/readlink.xml
===================================================================
--- phpdoc/ja/trunk/reference/filesystem/functions/readlink.xml	2020-07-02 13:25:03 UTC (rev 350097)
+++ phpdoc/ja/trunk/reference/filesystem/functions/readlink.xml	2020-07-03 00:40:50 UTC (rev 350098)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
-<!-- CREDITS: shimooka -->
+<!-- EN-Revision: 350097 Maintainer: hirokawa Status: ready -->
+<!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readlink">
  <refnamediv>
   <refname>readlink</refname>
@@ -35,6 +35,20 @@
   </para>
  </refsect1>

+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   シンボリックリンク・パスの内容を返します。エラーの場合は
+   &false; を返します。
+  </para>
+  <note>
+   <simpara>
+    この関数は、<parameter>path</parameter> がシンボリックリンクでない場合は失敗します。但し、Windows を除きます。
+    Windows では、正規化されたパスを返します。
+   </simpara>
+  </note>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -60,14 +74,6 @@
   </para>
  </refsect1>

- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   シンボリックリンク・パスの内容を返します。エラーの場合は
-   &false; を返します。
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>