[doc] find() page improved 77/21477/8
Samuel GOUGEON [Sun, 31 May 2020 17:50:42 +0000 (19:50 +0200)]
Change-Id: Ia4a0969e988d3a084eaca1e0cbeb7e5d2e8ad62c

scilab/modules/elementary_functions/help/en_US/searchandsort/find.xml
scilab/modules/elementary_functions/help/fr_FR/searchandsort/find.xml
scilab/modules/elementary_functions/help/ja_JP/searchandsort/find.xml
scilab/modules/elementary_functions/help/pt_BR/searchandsort/find.xml
scilab/modules/elementary_functions/help/ru_RU/searchandsort/find.xml [new file with mode: 0644]

index 51468b1..6f8e724 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="find">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="find">
     <refnamediv>
         <refname>find</refname>
-        <refpurpose>find indices of boolean vector or matrix true elements</refpurpose>
+        <refpurpose>gives the indices of %T or non-zero elements</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>[ii]=find(x [,nmax])
-            [i1,i2,..]=find(x [,nmax])
+        <synopsis>
+            ii = find(x)
+            [i1,i2,..] = find(x)
+            .. = find(x, nmax)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>may be a boolean vector,  a boolean matrix, a boolean
-                        hypermatrix, a "standard" matrix or hypermatrix
+                    <para>
+                        Vector, matrix, or hypermatrix of booleans or of numbers.
+                        All non-zero numbers are considered as %T.
+                        Sparse matrices are accepted.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>nmax</term>
                 <listitem>
-                    <para>an integer giving the maximum number of indices to return. The default value is -1 which stands for "all". This option can be used for efficiency, to avoid searching all indices.</para>
+                    <para>
+                        an integer giving the maximum number of indices to return.
+                        The default value is -1 which stands for "all".
+                        This option can be used for efficiency, to avoid searching all indices.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>ii</term>
+                <listitem>
+                    <para>
+                        row vector of linearized indices of %T or non-zero elements, or empty matrix []
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>ii, i1, i2, ..  </term>
+                <term>i1, i2, ..</term>
                 <listitem>
-                    <para>integer vectors of indices or empty matrices</para>
+                    <para>
+                        row vectors of directional indices, or empty matrix []
+                    </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
         <title>Examples</title>
+        <para>
+            With input booleans:
+        </para>
+        <programlisting role="example"><![CDATA[
+A = [%F %T %T %F ; %T %F %F %T]
+find(A)
+find(A,2)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> A = [%F %T %T %F ; %T %F %F %T]
+ A  =
+  F T T F
+  T F F T
+
+--> find(A)
+ ans  =
+   2.   3.   5.   8.
+
+--> find(A,2)
+ ans  =
+   2.   3.
+]]></screen>
+    <para>
+        With input numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+B = [0 -1 0 3 ; 0 -1 -0.4 0]
+find(B)
+[i, j] = find(B);
+[i' j']
+      ]]></programlisting>
+    <screen><![CDATA[
+--> B = [0 -1 0 3 ; 0 -1 -0.4 0]
+ B  =
+   0.  -1.   0.    3.
+   0.  -1.  -0.4   0.
+
+--> find(B)
+ ans  =
+   3.   4.   6.   7.
+
+--> [i, j] = find(B);
+--> [i' j']
+ ans  =
+   1.   2.
+   2.   2.
+   2.   3.
+   1.   4.
+]]></screen>
+    <para>
+        With an input hypermatrix of numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+E = grand(2,5,2,"uin",1,6)
+find(E < 4)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> E = grand(2,5,2,"uin",1,6)
+ E  =
+(:,:,1)
+   1.   6.   5.   5.   4.
+   6.   5.   3.   4.   4.
+(:,:,2)
+   2.   4.   3.   6.   5.
+   5.   6.   6.   6.   4.
+
+--> find(E < 4)
+ ans  =
+   1.   6.   11.   15.
+]]></screen>
+    <para>
+         With an input numerical or boolean sparse matrix:
+    </para>
         <programlisting role="example"><![CDATA[
-beers=["Desperados", "Leffe", "Kronenbourg", "Heineken"];
-find(beers=="Leffe") // OK
-find(beers=="1664") // KO
-find(beers=="Foster") // KO
-beers=[beers, "Foster"]
-find(beers=="Foster") // OK
+C = [0  3  7  0  9  0
+     0  4  0  0  5  0
+     6  0  1  0  3  8
+    ];
+C = sparse(C);
+find(C)
+find(C, 4)
+
+// With input boolean sparse
+D = C > 4
+full(D)
+find(D)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> C = sparse(C);
+--> find(C)
+ ans  =
+    3.    4.    5.    7.    9.    13.    14.    15.    18.
+
+-->find(C, 4)
+ ans  =
+    3.    4.    5.    7.
+
+--> // With input boolean sparse
+--> D = C > 4
+ D  =
+(  3,  6) sparse boolean matrix
+(  1,  3)   T
+(  1,  5)   T
+(  2,  5)   T
+(  3,  1)   T
+(  3,  6)   T
 
-A=rand(1,20);
-w=find(A<0.4)
-A(w)
-w=find(A>100)
+--> full(D)
+ ans  =
+  F F T F T F
+  F F F F T F
+  T F F F F T
 
-B=rand(1,20);
-w=find(B<0.4,2) //at most 2 returned values
+-->find(D)
+ ans  =
+    3.    7.    13.    14.    18.
+]]></screen>
+    <para>
+        With the result of a boolean element-wise condition on texts:
+    </para>
+        <programlisting role="example"><![CDATA[
+beers = ["Desperados", "Leffe", "Kronenbourg", "Heineken"];
+find(beers == "Leffe")
+find(beers == "1664")
+      ]]></programlisting>
+    <screen><![CDATA[
+--> find(beers == "Leffe")
+ ans  =
+   2.
+
+--> find(beers == "1664")
+ ans  =
+    []
+]]></screen>
+    <para>
+        Addressing selected elements:
+    </para>
+        <programlisting role="example"><![CDATA[
+// a) Through their linearized indices:
+H = [ 0  -2  -8  4  -5  -1
+     -2   2  -9  5   0   1
+    ];
+L = H;
+L(find(L < 0)) = -10
 
-H=rand(4,3,5); //an hypermatrix
-[i,j,k]=find(H>0.9)
+// b) Directly through the array of their boolean status:
+L = H;
+L(L < 0) = -10
+      ]]></programlisting>
+    <screen><![CDATA[
+--> // a) Through their linearized indices:
+--> H = [ 0  -2  -8  4  -5  -1
+  >      -2   2  -9  5   0   1
+  >     ];
+--> L = H;
+--> L(find(L < 0)) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
 
-H(i(1),j(1),k(1))
- ]]></programlisting>
+--> // b) Directly through the array of their boolean status:
+--> L = H;
+--> L(L < 0) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="boolean">boolean</link>
+                <link linkend="vectorfind">vectorfind</link>
             </member>
             <member>
-                <link linkend="extraction">extraction</link>
+                <link linkend="grep">grep</link>
             </member>
             <member>
-                <link linkend="insertion">insertion</link>
+                <link linkend="findobj">findobj</link>
             </member>
             <member>
-                <link linkend="vectorfind">vectorfind</link>
+                <link linkend="boolean">boolean</link>
             </member>
         </simplelist>
     </refsection>
index 5f57b23..af9299b 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2011 - Bernard DUJARDIN
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="find">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="fr" xml:id="find">
     <refnamediv>
         <refname>find</refname>
-        <refpurpose>trouve les indices des éléments vrais d'un vecteur ou d'une matrice de booléens</refpurpose>
+        <refpurpose>
+            donne la position des éléments %T ou non nuls d'un tableau booléen ou numérique.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
-        <synopsis>[ii]=find(x [,nmax])
-            [i1,i2,..]=find(x [,nmax])
+        <synopsis>
+            ii = find(x)
+            [i1,i2,..] = find(x)
+            .. = find(x, nmax)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>peut être un vecteur booléen, une matrice booléenne, une hypermatrice booléenne, une matrice ou une hypermatrice "standard".</para>
+                    <para>
+                        Vecteur, matrice, ou hypermatrice de booléens ou de nombres.
+                        Tout nombre non nul est équivalent à %T.
+                        Les vecteurs ou matrices creuses sont acceptés.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>nmax</term>
                 <listitem>
-                    <para>un entier donnant le nombre maximal d'indices à retourner. La valeur par défaut est -1 qui signifie "tous". Cette option peut être utilisée dans un but d'efficacité en évitant la recherche de tous les indices.</para>
+                    <para>
+                        un entier donnant le nombre maximal d'indices à retourner.
+                        La valeur par défaut est -1 qui signifie "tous".
+                        Cette option peut être utilisée dans un but d'efficacité
+                        en évitant la recherche de tous les indices.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>ii</term>
+                <listitem>
+                    <para>
+                        vecteur ligne des indices linéarisés des éléments %T ou non nuls,
+                        ou matrice vide [].
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>ii, i1, i2, ..  </term>
+                <term>i1, i2, ..</term>
                 <listitem>
-                    <para>vecteurs d'entiers des indices ou matrices vides</para>
+                    <para>
+                        vecteurs ligne des indices directionels des élements %T ou non nuls,
+                        or matrices vides [].
+                    </para>
                 </listitem>
             </varlistentry>
         </variablelist>
             Si <literal>x</literal> est une matrice booléenne,
         </para>
         <para>
-            <literal>ii=find(x)</literal> retourne le vecteur des indices <literal>i</literal> pour lesquels <literal>x(i)</literal> est "vrai". Si aucun élément vrai
-            n'est trouvé find retourne une matrice vide.
+            <literal>ii=find(x)</literal> retourne le vecteur des indices
+            <literal>i</literal> pour lesquels <literal>x(i)</literal> est "vrai".
+            Si aucun élément vrai n'est trouvé find retourne une matrice vide.
         </para>
         <para>
-            <literal>[i1,i2,..]=find(x)</literal> retourne le vecteur des indices <literal>i1</literal> (pour les lignes) et <literal>i2</literal> (pour les colonnes),..
+            <literal>[i1,i2,..]=find(x)</literal> retourne le vecteur des indices
+            <literal>i1</literal> (pour les lignes) et <literal>i2</literal> (pour les colonnes),..
             tel que <literal>x(i1(n),i2(n),..)</literal> est "vrai". Si aucun élément vrai n'est
             trouvé find retourne des matrices vides dans <literal>i1</literal>,
             <literal>i2</literal>, ...
         </para>
         <para>
-            Si <literal>x</literal> est une matrice standard ou une hypermatrice <literal>find(x)</literal> est interprété comme
+            Si <literal>x</literal> est une matrice standard ou une hypermatrice
+            <literal>find(x)</literal> est interprété comme
             <literal>find(x&lt;&gt;0).</literal>
         </para>
         <para>
     </refsection>
     <refsection>
         <title>Exemples</title>
+        <para>
+            Avec un tableau booléen :
+        </para>
+        <programlisting role="example"><![CDATA[
+A = [%F %T %T %F ; %T %F %F %T]
+find(A)
+find(A,2)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> A = [%F %T %T %F ; %T %F %F %T]
+ A  =
+  F T T F
+  T F F T
+
+--> find(A)
+ ans  =
+   2.   3.   5.   8.
+
+--> find(A,2)
+ ans  =
+   2.   3.
+]]></screen>
+    <para>
+        Avec un tableau de nombres :
+    </para>
         <programlisting role="example"><![CDATA[
-beers=["Desperados", "Leffe", "Kronenbourg", "Heineken"];
-find(beers=="Leffe") // OK
-find(beers=="1664") // KO
-find(beers=="Foster") // KO
-beers=[beers, "Foster"]
-find(beers=="Foster") // OK
+B = [0 -1 0 3 ; 0 -1 -0.4 0]
+find(B)
+[i, j] = find(B);
+[i' j']
+      ]]></programlisting>
+    <screen><![CDATA[
+--> B = [0 -1 0 3 ; 0 -1 -0.4 0]
+ B  =
+   0.  -1.   0.    3.
+   0.  -1.  -0.4   0.
 
-A=rand(1,20);
-w=find(A<0.4)
-A(w)
-w=find(A>100)
+--> find(B)
+ ans  =
+   3.   4.   6.   7.
 
-B=rand(1,20);
-w=find(B<0.4,2) //retourne au plus deux valeurs
+--> [i, j] = find(B);
+--> [i' j']
+ ans  =
+   1.   2.
+   2.   2.
+   2.   3.
+   1.   4.
+]]></screen>
+    <para>
+        Avec une hypermatrice de nombres :
+    </para>
+        <programlisting role="example"><![CDATA[
+E = grand(2,5,2,"uin",1,6)
+find(E < 4)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> E = grand(2,5,2,"uin",1,6)
+ E  =
+(:,:,1)
+   1.   6.   5.   5.   4.
+   6.   5.   3.   4.   4.
+(:,:,2)
+   2.   4.   3.   6.   5.
+   5.   6.   6.   6.   4.
 
-H=rand(4,3,5); //une hypermatrice
-[i,j,k]=find(H>0.9)
+--> find(E < 4)
+ ans  =
+   1.   6.   11.   15.
+]]></screen>
+    <para>
+         Avec une matrice creuse numérique ou booléenne :
+    </para>
+        <programlisting role="example"><![CDATA[
+C = [0  3  7  0  9  0
+     0  4  0  0  5  0
+     6  0  1  0  3  8
+    ];
+C = sparse(C);
+find(C)
+find(C, 4)
 
-H(i(1),j(1),k(1))
- ]]></programlisting>
+// Avec une matrice creuse booléenne
+D = C > 4
+full(D)
+find(D)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> C = sparse(C);
+--> find(C)
+ ans  =
+    3.    4.    5.    7.    9.    13.    14.    15.    18.
+
+-->find(C, 4)
+ ans  =
+    3.    4.    5.    7.
+
+--> // Avec une matrice creuse booléenne
+--> D = C > 4
+ D  =
+(  3,  6) sparse boolean matrix
+(  1,  3)   T
+(  1,  5)   T
+(  2,  5)   T
+(  3,  1)   T
+(  3,  6)   T
+
+--> full(D)
+ ans  =
+  F F T F T F
+  F F F F T F
+  T F F F F T
+
+-->find(D)
+ ans  =
+    3.    7.    13.    14.    18.
+]]></screen>
+    <para>
+        Avec le résultat booléen d'une condition individuelle sur du texte :
+    </para>
+        <programlisting role="example"><![CDATA[
+beers = ["Desperados", "Leffe", "Kronenbourg", "Heineken"];
+find(beers == "Leffe")
+find(beers == "1664")
+      ]]></programlisting>
+    <screen><![CDATA[
+--> find(beers == "Leffe")
+ ans  =
+   2.
+
+--> find(beers == "1664")
+ ans  =
+    []
+]]></screen>
+    <para>
+        Adressage des éléments sélectionnés :
+    </para>
+        <programlisting role="example"><![CDATA[
+// a) via leurs indices linéarisés :
+H = [ 0  -2  -8  4  -5  -1
+     -2   2  -9  5   0   1
+    ];
+L = H;
+L(find(L<0)) = -10
+
+// b) Directement via le tableau de leur statut booléen :
+L = H;
+L(L<0) = -10
+      ]]></programlisting>
+    <screen><![CDATA[
+--> // a) via leurs indices linéarisés :
+--> H = [ 0  -2  -8  4  -5  -1
+  >      -2   2  -9  5   0   1
+  >     ];
+--> L = H;
+--> L(find(L<0)) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+
+--> // b) Directement via le tableau de leur statut booléen :
+--> L = H;
+--> L(L<0) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
-                <link linkend="boolean">boolean</link>
+                <link linkend="vectorfind">vectorfind</link>
             </member>
             <member>
-                <link linkend="extraction">extraction</link>
+                <link linkend="grep">grep</link>
             </member>
             <member>
-                <link linkend="insertion">insertion</link>
+                <link linkend="findobj">findobj</link>
             </member>
             <member>
-                <link linkend="vectorfind">recherche de vecteur</link>
+                <link linkend="boolean">boolean</link>
             </member>
         </simplelist>
     </refsection>
index 487963c..a0c663c 100644 (file)
@@ -1,10 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="find">
-
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="find">
     <refnamediv>
-
         <refname>find</refname>
-
         <refpurpose>論理値ベクトルまたは行列のtrue要素の添え字を見つける</refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
-        <synopsis>[ii]=find(x [,nmax])
-
-            [i1,i2,..]=find(x [,nmax])
-
+        <synopsis>
+            ii = find(x)
+            [i1,i2,..] = find(x)
+            .. = find(x, nmax)
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
         <title>引数</title>
-
         <variablelist>
-
             <varlistentry>
-
                 <term>x</term>
-
                 <listitem>
-
-                    <para>は論理値ベクトル,論理値行列,論理値ハイパー行列,
-
-                        "標準"行列またはハイパー行列です.
-
+                    <para>
+                        ブールまたは数値のベクトル、行列、または超行列. ゼロ以外の数値は%Tと見なされます.
+                        スパース行列が受け入れられます.
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>nmax</term>
-
                 <listitem>
-
                     <para>返される添え字の最大数を指定する整数.
-
                         デフォルト値は"全て"を意味する -1 です.
-
                         このオプションは,全ての添え字の探索を避け,処理効率を改善するために
-
                         使用できます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>ii, i1, i2, ..  </term>
-
+                <term>ii</term>
                 <listitem>
-
-                    <para>整数ベクトルの添字または空行列</para>
-
+                    <para>
+                        row vector of linearized indices of %T or non-zero elements, or empty matrix [].
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>i1, i2, ..</term>
+                <listitem>
+                    <para>
+                        row vectors of directional indices, or empty matrix []
+                    </para>
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             <literal>x</literal> が論理値の場合,
-
         </para>
-
         <para>
-
             <literal>ii=find(x)</literal> は<literal>x(i)</literal>が
-
             "true"の添字<literal>i</literal>のベクトルを返します.
-
             trueとなる要素がみつからない場合,空行列が返されます.
-
         </para>
-
         <para>
-
             <literal>[i1,i2,..]=find(x)</literal> は,
-
             <literal>x(i1(n),i2(n),..)</literal>が "true" の
-
             添字<literal>i1</literal> (行の場合) および
-
             <literal>i2</literal> (列の場合),..のベクトルを返します.
-
             trueとなる要素がみつからない場合,
-
             <literal>i1</literal>,<literal>i2</literal>, ...の空行列を返します.
-
         </para>
-
         <para>
-
             <literal>x</literal> が標準行列またはハイパー行列の場合,
-
             <literal>find(x)</literal>は<literal>find(x&lt;&gt;0)</literal>
-
             と解釈されます.
-
         </para>
-
         <para>
-
             <literal>find([])</literal> は <literal>[]</literal>を返します.
-
         </para>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
+        <para>
+            With input booleans:
+        </para>
         <programlisting role="example"><![CDATA[
-beers=["Desperados", "Leffe", "Kronenbourg", "Heineken"];
-find(beers=="Leffe") // OK
-find(beers=="1664") // KO
-find(beers=="Foster") // KO
-beers=[beers, "Foster"]
-find(beers=="Foster") // OK
-A=rand(1,20);
-w=find(A<0.4)
-A(w)
-w=find(A>100)
-B=rand(1,20);
-w=find(B<0.4,2) //最大2個の値を返す
-H=rand(4,3,5); //ハイパー行列
-[i,j,k]=find(H>0.9)
-H(i(1),j(1),k(1))
- ]]></programlisting>
-
+A = [%F %T %T %F ; %T %F %F %T]
+find(A)
+find(A,2)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> A = [%F %T %T %F ; %T %F %F %T]
+ A  =
+  F T T F
+  T F F T
+
+--> find(A)
+ ans  =
+   2.   3.   5.   8.
+
+--> find(A,2)
+ ans  =
+   2.   3.
+]]></screen>
+    <para>
+        With input numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+B = [0 -1 0 3 ; 0 -1 -0.4 0]
+find(B)
+[i, j] = find(B);
+[i' j']
+      ]]></programlisting>
+    <screen><![CDATA[
+--> B = [0 -1 0 3 ; 0 -1 -0.4 0]
+ B  =
+   0.  -1.   0.    3.
+   0.  -1.  -0.4   0.
+
+--> find(B)
+ ans  =
+   3.   4.   6.   7.
+
+--> [i, j] = find(B);
+--> [i' j']
+ ans  =
+   1.   2.
+   2.   2.
+   2.   3.
+   1.   4.
+]]></screen>
+    <para>
+        With an input hypermatrix of numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+E = grand(2,5,2,"uin",1,6)
+find(E < 4)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> E = grand(2,5,2,"uin",1,6)
+ E  =
+(:,:,1)
+   1.   6.   5.   5.   4.
+   6.   5.   3.   4.   4.
+(:,:,2)
+   2.   4.   3.   6.   5.
+   5.   6.   6.   6.   4.
+
+--> find(E < 4)
+ ans  =
+   1.   6.   11.   15.
+]]></screen>
+    <para>
+         With an input numerical or boolean sparse matrix:
+    </para>
+        <programlisting role="example"><![CDATA[
+C = [0  3  7  0  9  0
+     0  4  0  0  5  0
+     6  0  1  0  3  8
+    ];
+C = sparse(C);
+find(C)
+find(C, 4)
+
+// With input boolean sparse
+D = C > 4
+full(D)
+find(D)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> C = sparse(C);
+--> find(C)
+ ans  =
+    3.    4.    5.    7.    9.    13.    14.    15.    18.
+
+-->find(C, 4)
+ ans  =
+    3.    4.    5.    7.
+
+--> // With input boolean sparse
+--> D = C > 4
+ D  =
+(  3,  6) sparse boolean matrix
+(  1,  3)   T
+(  1,  5)   T
+(  2,  5)   T
+(  3,  1)   T
+(  3,  6)   T
+
+--> full(D)
+ ans  =
+  F F T F T F
+  F F F F T F
+  T F F F F T
+
+-->find(D)
+ ans  =
+    3.    7.    13.    14.    18.
+]]></screen>
+    <para>
+        With the result of a boolean element-wise condition on texts
+    </para>
+        <programlisting role="example"><![CDATA[
+beers = ["Desperados", "Leffe", "Kronenbourg", "Heineken"];
+find(beers == "Leffe")
+find(beers == "1664")
+      ]]></programlisting>
+    <screen><![CDATA[
+--> find(beers == "Leffe")
+ ans  =
+   2.
+
+--> find(beers == "1664")
+ ans  =
+    []
+]]></screen>
+    <para>
+        Addressing selected elements:
+    </para>
+        <programlisting role="example"><![CDATA[
+// a) Through their linearized indices:
+H = [ 0  -2  -8  4  -5  -1
+     -2   2  -9  5   0   1
+    ];
+L = H;
+L(find(L < 0)) = -10
+
+// b) Directly through the array of their boolean status:
+L = H;
+L(L < 0) = -10
+      ]]></programlisting>
+    <screen><![CDATA[
+--> // a) Through their linearized indices:
+--> H = [ 0  -2  -8  4  -5  -1
+  >      -2   2  -9  5   0   1
+  >     ];
+--> L = H;
+--> L(find(L < 0)) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+
+--> // b) Directly through the array of their boolean status:
+--> L = H;
+--> L(L < 0) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+]]></screen>
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
-                <link linkend="boolean">boolean</link>
-
+                <link linkend="vectorfind">vectorfind</link>
             </member>
-
             <member>
-
-                <link linkend="extraction">extraction</link>
-
+                <link linkend="grep">grep</link>
             </member>
-
             <member>
-
-                <link linkend="insertion">insertion</link>
-
+                <link linkend="findobj">findobj</link>
             </member>
-
             <member>
-
-                <link linkend="vectorfind">vectorfind</link>
-
+                <link linkend="boolean">boolean</link>
             </member>
-
         </simplelist>
-
     </refsection>
-
-</refentry>
-
+</refentry>
\ No newline at end of file
index 4670790..8672870 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * along with this program.
  *
  -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="find" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
+          xmlns:scilab="http://www.scilab.org" xml:id="find" xml:lang="pt">
     <refnamediv>
         <refname>find</refname>
-        <refpurpose>encontra índices de elementos verdadeiros em uma matriz ou
-            vetor de booleanos
+        <refpurpose>
+            fornece os índices de elementos %T ou diferentes de zero
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>[ii]=find(x [,nmax])
-            [i1,i2,..]=find(x [,nmax])
+        <synopsis>
+            ii = find(x)
+            [i1,i2,..] = find(x)
+            .. = find(x, nmax)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>pode ser um vetor, matriz ou hipermatriz de booleanos, uma
-                        matriz ou hipermatriz "padrão".
+                    <para>
+                        vetor, matriz ou hipermatriz de booleanos ou de números.
+                        Todos os números diferentes de zero são considerados como %T.
+                        Matrizes esparsas são aceitas.
                     </para>
                 </listitem>
             </varlistentry>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>ii, i1, i2, ..</term>
+                <term>ii</term>
                 <listitem>
-                    <para>vetores de índices inteiros ou matrizes vazias</para>
+                    <para>
+                        vetor de linha de índices linearizados de elementos %T ou diferentes
+                        de zero, ou matriz vazia [].
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>i1, i2, ..</term>
+                <listitem>
+                    <para>
+                        vetores de linha de índices direcionais, ou matriz vazia [].
+                    </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
         <title>Exemplos</title>
+        <para>
+            With input booleans:
+        </para>
+        <programlisting role="example"><![CDATA[
+A = [%F %T %T %F ; %T %F %F %T]
+find(A)
+find(A,2)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> A = [%F %T %T %F ; %T %F %F %T]
+ A  =
+  F T T F
+  T F F T
+
+--> find(A)
+ ans  =
+   2.   3.   5.   8.
+
+--> find(A,2)
+ ans  =
+   2.   3.
+]]></screen>
+    <para>
+        With input numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+B = [0 -1 0 3 ; 0 -1 -0.4 0]
+find(B)
+[i, j] = find(B);
+[i' j']
+      ]]></programlisting>
+    <screen><![CDATA[
+--> B = [0 -1 0 3 ; 0 -1 -0.4 0]
+ B  =
+   0.  -1.   0.    3.
+   0.  -1.  -0.4   0.
+
+--> find(B)
+ ans  =
+   3.   4.   6.   7.
+
+--> [i, j] = find(B);
+--> [i' j']
+ ans  =
+   1.   2.
+   2.   2.
+   2.   3.
+   1.   4.
+]]></screen>
+    <para>
+        With an input hypermatrix of numbers:
+    </para>
+        <programlisting role="example"><![CDATA[
+E = grand(2,5,2,"uin",1,6)
+find(E < 4)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> E = grand(2,5,2,"uin",1,6)
+ E  =
+(:,:,1)
+   1.   6.   5.   5.   4.
+   6.   5.   3.   4.   4.
+(:,:,2)
+   2.   4.   3.   6.   5.
+   5.   6.   6.   6.   4.
+
+--> find(E < 4)
+ ans  =
+   1.   6.   11.   15.
+]]></screen>
+    <para>
+         With an input numerical or boolean sparse matrix:
+    </para>
+        <programlisting role="example"><![CDATA[
+C = [0  3  7  0  9  0
+     0  4  0  0  5  0
+     6  0  1  0  3  8
+    ];
+C = sparse(C);
+find(C)
+find(C, 4)
+
+// With input boolean sparse
+D = C > 4
+full(D)
+find(D)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> C = sparse(C);
+--> find(C)
+ ans  =
+    3.    4.    5.    7.    9.    13.    14.    15.    18.
+
+-->find(C, 4)
+ ans  =
+    3.    4.    5.    7.
+
+--> // With input boolean sparse
+--> D = C > 4
+ D  =
+(  3,  6) sparse boolean matrix
+(  1,  3)   T
+(  1,  5)   T
+(  2,  5)   T
+(  3,  1)   T
+(  3,  6)   T
+
+--> full(D)
+ ans  =
+  F F T F T F
+  F F F F T F
+  T F F F F T
+
+-->find(D)
+ ans  =
+    3.    7.    13.    14.    18.
+]]></screen>
+    <para>
+        With the result of a boolean element-wise condition on texts
+    </para>
         <programlisting role="example"><![CDATA[
-A=rand(1,20);
-w=find(A<0.4)
-A(w)
-w=find(A>100)
+beers = ["Desperados", "Leffe", "Kronenbourg", "Heineken"];
+find(beers == "Leffe")
+find(beers == "1664")
+      ]]></programlisting>
+    <screen><![CDATA[
+--> find(beers == "Leffe")
+ ans  =
+   2.
 
-B=rand(1,20);
-w=find(B<0.4,2) //no máximo dois valores retornados
+--> find(beers == "1664")
+ ans  =
+    []
+]]></screen>
+    <para>
+        Addressing selected elements:
+    </para>
+        <programlisting role="example"><![CDATA[
+// a) Through their linearized indices:
+H = [ 0  -2  -8  4  -5  -1
+     -2   2  -9  5   0   1
+    ];
+L = H;
+L(find(L < 0)) = -10
 
-H=rand(4,3,5); //uma hipermatriz
-[i,j,k]=find(H>0.9)
+// b) Directly through the array of their boolean status:
+L = H;
+L(L < 0) = -10
+      ]]></programlisting>
+    <screen><![CDATA[
+--> // a) Through their linearized indices:
+--> H = [ 0  -2  -8  4  -5  -1
+  >      -2   2  -9  5   0   1
+  >     ];
+--> L = H;
+--> L(find(L < 0)) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
 
-H(i(1),j(1),k(1))
- ]]></programlisting>
+--> // b) Directly through the array of their boolean status:
+--> L = H;
+--> L(L < 0) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>Ver Também</title>
         <simplelist type="inline">
             <member>
-                <link linkend="boolean">boolean</link>
+                <link linkend="vectorfind">vectorfind</link>
             </member>
             <member>
-                <link linkend="extraction">extraction</link>
+                <link linkend="grep">grep</link>
             </member>
             <member>
-                <link linkend="insertion">insertion</link>
+                <link linkend="findobj">findobj</link>
             </member>
             <member>
-                <link linkend="vectorfind">vectorfind</link>
+                <link linkend="boolean">boolean</link>
             </member>
         </simplelist>
     </refsection>
diff --git a/scilab/modules/elementary_functions/help/ru_RU/searchandsort/find.xml b/scilab/modules/elementary_functions/help/ru_RU/searchandsort/find.xml
new file mode 100644 (file)
index 0000000..77d0cd7
--- /dev/null
@@ -0,0 +1,290 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ru" xml:id="find">
+    <refnamediv>
+        <refname>find</refname>
+        <refpurpose>даёт индексы элементов с ненулевым значением или значением %T</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Синтаксис</title>
+        <synopsis>
+            ii = find(x)
+            [i1,i2,..] = find(x)
+            .. = find(x, nmax)
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>x</term>
+                <listitem>
+                    <para>
+                        Вектор, матрица или гиперматрица логических значений или чисел.
+                        Все ненулевые числа считаются значениями %T. Принимаются разрежённые 
+                        матрицы.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>nmax</term>
+                <listitem>
+                    <para>
+                        целое число, указывающее максимальное количество индексов для возврата.
+                        Значение по умолчанию равно <literal>-1</literal>, которое стоит для 
+                        "все". Эта опция может использоваться для эффективности, чтобы исключить 
+                        поиск всех индексов.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>ii</term>
+                <listitem>
+                    <para>
+                        вектор-строка линеаризованных индексов с ненулевым значением, или 
+                        значением <literal>%T</literal> или пустая матрица <literal>[]</literal>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>i1, i2, ..</term>
+                <listitem>
+                    <para>
+                        векторы-строки индексов направления или пустая матрица 
+                        <literal>[]</literal>
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Если <varname>x</varname> является матрицей логических значений, то
+        </para>
+        <para>
+            <literal>ii=find(x)</literal> возвращает вектор индексов <literal>i</literal>,
+            для которых <literal>x(i)</literal> соответствует "истине". Если не найден ни один 
+            элемент со значением "истина", то возвращается пустая матрица.
+        </para>
+        <para>
+            <literal>[i1,i2,..]=find(x)</literal> возвращает векторы индексов 
+            <literal>i1</literal> (для строк) и <literal>i2</literal> (для столбцов), 
+            <literal>..</literal> такие, что <literal>x(i1(n),i2(n),..)</literal>
+            соответствует "истине". Если не найден ни один элемент со значением 
+            "истина", то возвращаются пустые матрицы в  <literal>i1</literal>,
+            <literal>i2</literal>, ...
+        </para>
+        <para>
+            Если <varname>x</varname> - это стандартная матрица или гиперматрица,
+            то <literal>find(x)</literal> интерпретируется как 
+            <literal>find(x&lt;&gt;0)</literal>
+        </para>
+        <para>
+            <literal>find([])</literal> возвращает <literal>[]</literal>.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <para>
+            С входными логическими значениями:
+        </para>
+        <programlisting role="example"><![CDATA[
+A = [%F %T %T %F ; %T %F %F %T]
+find(A)
+find(A,2)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> A = [%F %T %T %F ; %T %F %F %T]
+ A  =
+  F T T F
+  T F F T
+
+--> find(A)
+ ans  =
+   2.   3.   5.   8.
+
+--> find(A,2)
+ ans  =
+   2.   3.
+]]></screen>
+    <para>
+        С входными числами:
+    </para>
+        <programlisting role="example"><![CDATA[
+B = [0 -1 0 3 ; 0 -1 -0.4 0]
+find(B)
+[i, j] = find(B);
+[i' j']
+      ]]></programlisting>
+    <screen><![CDATA[
+--> B = [0 -1 0 3 ; 0 -1 -0.4 0]
+ B  =
+   0.  -1.   0.    3.
+   0.  -1.  -0.4   0.
+
+--> find(B)
+ ans  =
+   3.   4.   6.   7.
+
+--> [i, j] = find(B);
+--> [i' j']
+ ans  =
+   1.   2.
+   2.   2.
+   2.   3.
+   1.   4.
+]]></screen>
+    <para>
+        С входными гиперматрицами чисел:
+    </para>
+        <programlisting role="example"><![CDATA[
+E = grand(2,5,2,"uin",1,6)
+find(E < 4)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> E = grand(2,5,2,"uin",1,6)
+ E  =
+(:,:,1)
+   1.   6.   5.   5.   4.
+   6.   5.   3.   4.   4.
+(:,:,2)
+   2.   4.   3.   6.   5.
+   5.   6.   6.   6.   4.
+
+--> find(E < 4)
+ ans  =
+   1.   6.   11.   15.
+]]></screen>
+    <para>
+         С входной числовой или логической разрежённой матрицей:
+    </para>
+        <programlisting role="example"><![CDATA[
+C = [0  3  7  0  9  0
+     0  4  0  0  5  0
+     6  0  1  0  3  8
+    ];
+C = sparse(C);
+find(C)
+find(C, 4)
+
+// С входной логической разрежённой матрицей
+D = C > 4
+full(D)
+find(D)
+      ]]></programlisting>
+    <screen><![CDATA[
+--> C = sparse(C);
+--> find(C)
+ ans  =
+    3.    4.    5.    7.    9.    13.    14.    15.    18.
+
+-->find(C, 4)
+ ans  =
+    3.    4.    5.    7.
+
+--> // With input boolean sparse
+--> D = C > 4
+ D  =
+(  3,  6) sparse boolean matrix
+(  1,  3)   T
+(  1,  5)   T
+(  2,  5)   T
+(  3,  1)   T
+(  3,  6)   T
+
+--> full(D)
+ ans  =
+  F F T F T F
+  F F F F T F
+  T F F F F T
+
+-->find(D)
+ ans  =
+    3.    7.    13.    14.    18.
+]]></screen>
+    <para>
+        С результатом логического поэлементного условия на текстах:
+    </para>
+        <programlisting role="example"><![CDATA[
+beers = ["Desperados", "Leffe", "Kronenbourg", "Heineken"];
+find(beers == "Leffe")
+find(beers == "1664")
+      ]]></programlisting>
+    <screen><![CDATA[
+--> find(beers == "Leffe")
+ ans  =
+   2.
+
+--> find(beers == "1664")
+ ans  =
+    []
+]]></screen>
+    <para>
+        Адресация выбранных элементов:
+    </para>
+        <programlisting role="example"><![CDATA[
+// a) Через их линеаризованные индексы:
+H = [ 0  -2  -8  4  -5  -1
+     -2   2  -9  5   0   1
+    ];
+L = H;
+L(find(L < 0)) = -10
+
+// b) Непосредственно через массив их логического статуса:
+L = H;
+L(L < 0) = -10
+      ]]></programlisting>
+    <screen><![CDATA[
+--> // a) Through their linearized indices:
+--> H = [ 0  -2  -8  4  -5  -1
+  >      -2   2  -9  5   0   1
+  >     ];
+--> L = H;
+--> L(find(L < 0)) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+
+--> // b) Directly through the array of their boolean status:
+--> L = H;
+--> L(L < 0) = -10
+ L  =
+   0.   -10.  -10.   4.  -10.  -10.
+  -10.   2.   -10.   5.   0.    1.
+]]></screen>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="vectorfind">vectorfind</link>
+            </member>
+            <member>
+                <link linkend="grep">grep</link>
+            </member>
+            <member>
+                <link linkend="findobj">findobj</link>
+            </member>
+            <member>
+                <link linkend="boolean">boolean</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>