svn: /phpdoc/ja/trunk/reference/sem/functions/ shm-attach.xml shm-detach.xml shm-get-var.xml shm-has-var.xml shm-put-var.xml shm-remove-var.xml shm-remove.xml

[email protected] (Yoshinari Takaoka)
Newsgroups php.doc.ja
Message-ID <[email protected]>
mumumu                                   Mon, 23 Nov 2020 01:33:02 +0000

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

Log:
Generate sysvshm methodsynopses based on stubs

Based on a patch contributed by Máté Kocsis <[email protected]>.

Changed paths:
    U   phpdoc/ja/trunk/reference/sem/functions/shm-attach.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-detach.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-get-var.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-has-var.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-put-var.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-remove-var.xml
    U   phpdoc/ja/trunk/reference/sem/functions/shm-remove.xml
svn-diffs-351519.txt (text/x-diff, 24.2 KB)
Modified: phpdoc/ja/trunk/reference/sem/functions/shm-attach.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-attach.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-attach.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350655 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
 <!-- Credits: mumumu -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-attach">
+<refentry xml:id="function.shm-attach" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_attach</refname>
   <refpurpose>共有メモリセグメントを作成またはオープンする</refpurpose>
@@ -11,25 +11,26 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>resource</type><methodname>shm_attach</methodname>
+   <type class="union"><type>SysvSharedMemory</type><type>false</type></type><methodname>shm_attach</methodname>
    <methodparam><type>int</type><parameter>key</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>memsize</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>perm</parameter><initializer>0666</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>size</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>shm_attach</function> は ID を返します。
    これは、指定されたキー <parameter>key</parameter>
    で System V 共有メモリにアクセスする際に使用することが可能です。
-   最初のコールの際に、サイズが <parameter>memsize</parameter>、
-   オプションのパーミッション <parameter>perm</parameter>
+   最初のコールの際に、サイズが <parameter>size</parameter>、
+   オプションのパーミッション <parameter>permissions</parameter>
    を指定した共有メモリセグメントを作成します。
   </para>
   <para>
    同じ <parameter>key</parameter> で
    <function>shm_attach</function> を 2 回コールした場合は
-   別の共有メモリ ID が返されますが、両方の ID は同じ共有メモリをアクセスします。
-   <parameter>memsize</parameter> および
-   <parameter>perm</parameter> は無視されます。
+   別の <classname>SysvSharedMemory</classname> インスタンスが返されますが、
+   両方のインスタンスは同じ共有メモリをアクセスします。
+   <parameter>size</parameter> および
+   <parameter>permissions</parameter> は無視されます。
   </para>
  </refsect1>

@@ -46,7 +47,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>memsize</parameter></term>
+     <term><parameter>size</parameter></term>
      <listitem>
       <para>
        メモリのサイズ。省略した場合のデフォルトは &php.ini; の
@@ -56,7 +57,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>perm</parameter></term>
+     <term><parameter>permissions</parameter></term>
      <listitem>
       <para>
        オプションのパーミッション設定。デフォルトは 0666 です。
@@ -70,48 +71,39 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   共有メモリセグメントの ID を返します。
+   成功時には、<classname>SysvSharedMemory</classname> クラスのインスタンスを返します。
+   &return.falseforfailure;
   </para>
  </refsect1>

- <refsect1 role="notes">
-  &reftitle.notes;
-  <note>
-   <para>
-    PHP 5.3.0 より前のバージョンでは、この関数の返す値は integer 型の値でした。
-    前のバージョンと同じ値を得るには、次のように帰り値を
-    integer へとキャストします。
-   </para>
-   <para>
-    <example>
-     <programlisting role="php">
-<![CDATA[
-<?php
-// テンポラリファイルを作り、そのパスを返します
-$tmp = tempnam('/tmp', 'PHP');
-
-// ファイルトークンキーを取得します
-$key = ftok($tmp, 'a');
-
-// SHM リソースをアタッチします。あとでキャストすることに注意
-$id = shm_attach($key);
-
-if ($id === false) {
-    die('共有メモリセグメントを作成できません');
-}
-
-// integer にキャストします。PHP 5.3.0 より前のバージョンでは
-// リソース ID が返り値となっており、この値はリソースを integer
-// にキャストすることで得られるからです
-$id = (integer) $id;
-?>
-]]>
-     </programlisting>
-    </example>
-   </para>
-  </note>
- </refsect1>
-
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       成功時に、この関数は <classname>SysvSharedMemory</classname> クラスのインスタンスを返すようになりました。
+       これより前のバージョンでは、リソースが返されていました。
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>size</parameter> は、nullable になりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -123,7 +115,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-detach.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-detach.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-detach.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-detach">
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
+<!-- Credits: mumumu -->
+<refentry xml:id="function.shm-detach" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_detach</refname>
   <refpurpose>共有メモリセグメントへの接続を閉じる</refpurpose>
@@ -11,12 +12,12 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>shm_detach</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>shm_detach</function> は、
    <function>shm_attach</function> で作成され、
-   指定した <parameter>shm_identifier</parameter>
+   指定した <parameter>shm</parameter>
    を有する共有メモリへの接続を閉じます。
    共有メモリは、まだ Unix システム上に存在しており、
    データはまだ存在するということを覚えておいてください。
@@ -28,10 +29,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
-       <function>shm_attach</function> が返す共有メモリリソースハンドル。
+       <function>shm_attach</function> が返す共有メモリセグメント。
       </para>
      </listitem>
     </varlistentry>
@@ -42,10 +43,36 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   <function>shm_detach</function> は、常に &true; を返します。
+   &return.success;
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -58,7 +85,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-get-var.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-get-var.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-get-var.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
+<!-- Credits: mumumu -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-get-var">
  <refnamediv>
   <refname>shm_get_var</refname>
@@ -11,13 +12,13 @@
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>shm_get_var</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
-   <methodparam><type>int</type><parameter>variable_key</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
+   <methodparam><type>int</type><parameter>key</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>shm_get_var</function> は、
-   <parameter>shm_identifier</parameter> で指定した共有メモリセグメントから
-   変数 <parameter>variable_key</parameter> を読みこみます。
+   <parameter>shm</parameter> で指定した共有メモリセグメントから
+   変数 <parameter>key</parameter> を読みこみます。
    読み込んだ変数は、まだ共有メモリに存在します。
   </para>
  </refsect1>
@@ -27,7 +28,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
        共有メモリセグメント。<function>shm_attach</function>
@@ -36,7 +37,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>variable_key</parameter></term>
+     <term><parameter>key</parameter></term>
      <listitem>
       <para>
        変数のキー。
@@ -54,6 +55,32 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -65,7 +92,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-has-var.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-has-var.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-has-var.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: takagi Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-has-var">
+<!-- EN-Revision: 351510 Maintainer: takagi Status: ready -->
+<refentry xml:id="function.shm-has-var" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_has_var</refname>
   <refpurpose>特定のエントリが存在するかどうかを調べる</refpurpose>
@@ -11,8 +11,8 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>shm_has_var</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
-   <methodparam><type>int</type><parameter>variable_key</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
+   <methodparam><type>int</type><parameter>key</parameter></methodparam>
   </methodsynopsis>
   <para>
    特定のキーが共有メモリセグメント内に存在するかどうかを調べます。
@@ -24,7 +24,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
        <function>shm_attach</function> で取得した共有メモリセグメント。
@@ -32,7 +32,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>variable_key</parameter></term>
+     <term><parameter>key</parameter></term>
      <listitem>
       <para>
        変数のキー。
@@ -50,6 +50,32 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -61,7 +87,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-put-var.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-put-var.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-put-var.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 307746 Maintainer: hirokawa Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-put-var">
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
+<refentry xml:id="function.shm-put-var" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_put_var</refname>
   <refpurpose>共有メモリの変数を挿入または更新する</refpurpose>
@@ -11,17 +11,17 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>shm_put_var</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
-   <methodparam><type>int</type><parameter>variable_key</parameter></methodparam>
-   <methodparam><type>mixed</type><parameter>variable</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
+   <methodparam><type>int</type><parameter>key</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>shm_put_var</function> は、
-   指定した <parameter>variable_key</parameter> を有する
-   変数 <parameter>variable</parameter> の挿入または更新を行います。
+   指定した <parameter>key</parameter> を有する
+   変数 <parameter>value</parameter> の挿入または更新を行います。
   </para>
   <para>
-   <parameter>shm_identifier</parameter> が有効な SysV 共有メモリではない場合や
+   <parameter>shm</parameter> が有効な SysV 共有メモリではない場合や
    リクエストを処理するために充分な共有メモリが残っていない場合は
    (<constant>E_WARNING</constant> レベルの) 警告を発生させます。
   </para>
@@ -32,15 +32,15 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
-       <function>shm_attach</function> が返す共有メモリリソースハンドル。
+       <function>shm_attach</function> が返す共有メモリセグメント。
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>variable_key</parameter></term>
+     <term><parameter>key</parameter></term>
      <listitem>
       <para>
        変数のキー。
@@ -48,7 +48,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>variable</parameter></term>
+     <term><parameter>value</parameter></term>
      <listitem>
       <para>
        変数。<function>serialize</function> がサポートするすべての
@@ -69,6 +69,32 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -80,7 +106,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-remove-var.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-remove-var.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-remove-var.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-remove-var">
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
+<!-- Credits: mumumu -->
+<refentry xml:id="function.shm-remove-var" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_remove_var</refname>
   <refpurpose>共有メモリから変数を削除する</refpurpose>
@@ -11,11 +12,11 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>shm_remove_var</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
-   <methodparam><type>int</type><parameter>variable_key</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
+   <methodparam><type>int</type><parameter>key</parameter></methodparam>
   </methodsynopsis>
   <para>
-   指定した<parameter>variable_key</parameter>
+   指定した<parameter>key</parameter>
    を有する変数を共有メモリから削除し、占有するメモリを解放します。
   </para>
  </refsect1>
@@ -25,16 +26,16 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
        <function>shm_attach</function> が返す
-       共有メモリ ID。
+       共有メモリセグメント。
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>variable_key</parameter></term>
+     <term><parameter>key</parameter></term>
      <listitem>
       <para>
        変数のキー。
@@ -52,6 +53,32 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -62,7 +89,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ja/trunk/reference/sem/functions/shm-remove.xml
===================================================================
--- phpdoc/ja/trunk/reference/sem/functions/shm-remove.xml	2020-11-23 01:10:48 UTC (rev 351518)
+++ phpdoc/ja/trunk/reference/sem/functions/shm-remove.xml	2020-11-23 01:33:02 UTC (rev 351519)
@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.shm-remove">
+<!-- EN-Revision: 351510 Maintainer: hirokawa Status: ready -->
+<!-- Credits: mumumu -->
+<refentry xml:id="function.shm-remove" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>shm_remove</refname>
   <refpurpose>Unix システムから共有メモリを削除する</refpurpose>
@@ -11,11 +12,11 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>shm_remove</methodname>
-   <methodparam><type>resource</type><parameter>shm_identifier</parameter></methodparam>
+   <methodparam><type>SysvSharedMemory</type><parameter>shm</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>shm_remove</function> は、共有メモリ
-   <parameter>shm_identifier</parameter> を削除します。
+   <parameter>shm</parameter> を削除します。
    全てのデータは破棄されます。
   </para>
  </refsect1>
@@ -25,11 +26,11 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>shm_identifier</parameter></term>
+     <term><parameter>shm</parameter></term>
      <listitem>
       <para>
        <function>shm_attach</function> が返す
-       共有メモリ ID。
+       共有メモリセグメント。
       </para>
      </listitem>
     </varlistentry>
@@ -44,6 +45,32 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        引数 <parameter>shm</parameter> は、
+        <classname>SysvSharedMemory</classname> クラスのインスタンスを期待するようになりました。
+        これより前のバージョンでは、リソースが期待されていました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -54,7 +81,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.