[doc] pathsep() page improved 31/21631/3
Samuel GOUGEON [Sat, 28 Nov 2020 20:11:54 +0000 (21:11 +0100)]
  http://mailinglists.scilab.org/Scilab-users-pathsep-returns-under-linux-tt4041125.html

Change-Id: Ide8a623a73106bed78ed7d51d6f8f60a2fbde3d4

scilab/modules/fileio/help/en_US/path_filename/pathsep.xml
scilab/modules/fileio/help/ja_JP/path_filename/pathsep.xml
scilab/modules/fileio/help/ru_RU/path_filename/pathsep.xml

index d2842ce..cf75637 100644 (file)
@@ -2,9 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Allan CORNET
- * ...
- *
  * 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="pathsep">
+<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="pathsep">
     <refnamediv>
         <refname>pathsep</refname>
-        <refpurpose>returns path separator for current platform</refpurpose>
+        <refpurpose>
+            provides the path separator used in the PATH environment variable of the current OS.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
             <varlistentry>
                 <term>s</term>
                 <listitem>
-                    <para>a string</para>
+                    a character: <literal>";"</literal> on Windows,
+                    or <literal>":"</literal> on Linux.
+                    <para/>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Description</title>
-        <para>
-            <function>pathsep</function> returns path separator (<literal>':'</literal> on GNU/Linux or <literal>';'</literal> on Windows ).
-        </para>
-    </refsection>
-    <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
 pathsep()
-]]></programlisting>
+getenv PATH
+tokens(getenv("PATH"), pathsep())
+     ]]></programlisting>
+        <screen><![CDATA[
+--> pathsep()
+ ans  =
+  ";"
+
+--> getenv PATH
+  "C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\OpenSSH\; ..."
+
+--> tokens(getenv("PATH"), pathsep())
+ ans  =
+  "C:\Windows\system32"
+  "C:\Windows"
+  "C:\Windows\System32\Wbem"
+  "C:\Windows\System32\OpenSSH\"
+  "C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common"
+  "C:\Program Files\NVIDIA Corporation\NVIDIA NGX"
+]]></screen>
+    </refsection>
+    <refsection role="see also">
+        <title>See also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="filesep">filesep</link>
+            </member>
+            <member>
+                <link linkend="getenv">getenv</link>
+            </member>
+        </simplelist>
     </refsection>
 </refentry>
index ab0fbab..d643204 100644 (file)
@@ -2,9 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Allan CORNET
- * ...
- *
  * 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="pathsep">
+<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="pathsep">
     <refnamediv>
         <refname>pathsep</refname>
-        <refpurpose>カレントのプラットフォームのパスセパレータを返す</refpurpose>
+        <refpurpose>
+            現在のオペレーティングシステムのPATH環境変数で使用されるパス区切り文字を提供します.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
             <varlistentry>
                 <term>s</term>
                 <listitem>
-                    <para>文字列</para>
+                    キャラクター  Windowsでは ";", Linuxでは ":".
+                    <para/>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>説明</title>
-        <para>パスセパレータを返します. ( Linuxでは ':', Windows では ';' )</para>
-    </refsection>
-    <refsection>
         <title>例</title>
         <programlisting role="example"><![CDATA[
 pathsep()
-]]></programlisting>
+getenv PATH
+tokens(getenv("PATH"), pathsep())
+     ]]></programlisting>
+        <screen><![CDATA[
+--> pathsep()
+ ans  =
+  ";"
+
+--> getenv PATH
+  "C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\OpenSSH\; ..."
+
+--> tokens(getenv("PATH"), pathsep())
+ ans  =
+  "C:\Windows\system32"
+  "C:\Windows"
+  "C:\Windows\System32\Wbem"
+  "C:\Windows\System32\OpenSSH\"
+  "C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common"
+  "C:\Program Files\NVIDIA Corporation\NVIDIA NGX"
+]]></screen>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="filesep">filesep</link>
+            </member>
+            <member>
+                <link linkend="getenv">getenv</link>
+            </member>
+        </simplelist>
     </refsection>
 </refentry>
index 9b8020f..4ca6a76 100644 (file)
@@ -2,9 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Allan CORNET
- * ...
- *
  * 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="ru" xml:id="pathsep">
+<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="pathsep">
     <refnamediv>
         <refname>pathsep</refname>
-        <refpurpose>возвращает разделитель пути для текущей платформы</refpurpose>
+        <refpurpose>предоставляет разделитель путей в переменной среды PATH текущей ОС</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
             <varlistentry>
                 <term>s</term>
                 <listitem>
-                    <para>строковое значение</para>
+                    символ: <literal> ";" </literal> в Windows, или <literal> ":" </literal> в Linux.
+                    <para/>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Описание</title>
-        <para>
-            <function>pathsep</function> возвращает разделитель пути (<literal>':'</literal> в GNU/Linux или <literal>';'</literal> в Windows).
-        </para>
-    </refsection>
-    <refsection>
         <title>Примеры</title>
         <programlisting role="example"><![CDATA[
 pathsep()
-]]></programlisting>
+getenv PATH
+tokens(getenv("PATH"), pathsep())
+     ]]></programlisting>
+        <screen><![CDATA[
+--> pathsep()
+ ans  =
+  ";"
+
+--> getenv PATH
+  "C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\OpenSSH\; ..."
+
+--> tokens(getenv("PATH"), pathsep())
+ ans  =
+  "C:\Windows\system32"
+  "C:\Windows"
+  "C:\Windows\System32\Wbem"
+  "C:\Windows\System32\OpenSSH\"
+  "C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common"
+  "C:\Program Files\NVIDIA Corporation\NVIDIA NGX"
+]]></screen>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="filesep">filesep</link>
+            </member>
+            <member>
+                <link linkend="getenv">getenv</link>
+            </member>
+        </simplelist>
     </refsection>
 </refentry>