* Bug 10668 fixed: bloc2ss() page was inaccurate 95/19895/6
Samuel GOUGEON [Sat, 17 Mar 2018 07:23:43 +0000 (08:23 +0100)]
  http://bugzilla.scilab.org/10668

Change-Id: I88bd34836572dc5114c0de8bbe33338d458f774f

scilab/CHANGES.md
scilab/modules/elementary_functions/help/en_US/signalprocessing/bloc2ss.xml
scilab/modules/elementary_functions/help/ja_JP/signalprocessing/bloc2ss.xml
scilab/modules/elementary_functions/help/pt_BR/signalprocessing/bloc2ss.xml
scilab/modules/elementary_functions/help/ru_RU/signalprocessing/bloc2ss.xml

index eb0e9b6..5a4fce5 100644 (file)
@@ -443,6 +443,7 @@ Known issues
 * [#10190](http://bugzilla.scilab.org/show_bug.cgi?id=10190): Xcos blocks and labels positioning were not aligned to the grid on creation.
 * [#10197](http://bugzilla.scilab.org/show_bug.cgi?id=10197): creating implicit vector of integers could fail.
 * [#10639](http://bugzilla.scilab.org/show_bug.cgi?id=10639): The page of `intersect` poorly described the arguments. Examples were not illustrated.
+* [#10668](http://bugzilla.scilab.org/show_bug.cgi?id=10668): Some words in the `bloc2ss` page were inaccurate or misleading.
 * [#10918](http://bugzilla.scilab.org/show_bug.cgi?id=10918): After `a=5`, `a([%t ; %f])` returned `[5 ; 2.1e-314]` instead of `5`.
 * [#11240](http://bugzilla.scilab.org/show_bug.cgi?id=11240): `A=[]; clear B; [A($+1),B]=1;` crashed Scilab.
 * [#11435](http://bugzilla.scilab.org/show_bug.cgi?id=11435): The demo `Simulation => Flow => Blackhole` reliability had to be checked. Its displayed speed value was truncated.
index c224220..4327ec7 100644 (file)
  * 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="bloc2ss" xml:lang="en">
+<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="bloc2ss" xml:lang="en">
     <refnamediv>
         <refname>bloc2ss</refname>
         <refpurpose>block-diagram to state-space conversion</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>[sl]=bloc2ss(blocd)</synopsis>
+        <synopsis>sl = bloc2ss(blocd)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -60,7 +63,7 @@ list('link','name_of_link',
  ]]></programlisting>
         <para>
             The strings <literal>'transfer'</literal> and
-            <literal>'links'</literal> are keywords which indicate the type of element
+            <literal>'link'</literal> are keywords which indicate the type of element
             in the block diagram.
         </para>
         <para>Case 1 : the second parameter of the list is a character string
@@ -95,14 +98,26 @@ list('link','name_of_link',
             <literal>['1','1']</literal>.
         </para>
         <para>
-            There are 4 links. The first one (named <literal>'U'</literal>)
-            links the input (port 0 of fictitious block -1, omitted) to port 1 of the
-            adder. The second and third one link respectively (output)port 1 of the
-            adder to (input)port 1 of system <literal>S1</literal>, and (output)port 1
-            of <literal>S1</literal> to (input)port 1 of <literal>S2</literal>. The
-            fourth link (named <literal>'Y'</literal>) links (output)port 1 of
-            <literal>S2</literal> to the output (port 0 of fictitious block -1,
-            omitted) and to (input)port 2 of the adder.
+            There are 4 links:
+            <itemizedlist>
+              <listitem>
+                The first one (named <literal>'U'</literal>) links the input
+                (port 0 of fictitious block -1, omitted) to port 1 of the adder.
+              </listitem>
+              <listitem>
+                The second one links the (output)port 1 of the adder to the (input)port 1 of system
+                <literal>S1</literal>.
+              </listitem>
+              <listitem>
+                The third one links the (output)port 1 of <literal>S1</literal> to
+                the (input)port 1 of <literal>S2</literal>.
+              </listitem>
+              <listitem>
+                The fourth link (named <literal>'Y'</literal>) links (output)port 1 of
+                <literal>S2</literal> to the output (port 0 of fictitious block -1,
+                omitted) and to (input)port 2 of the adder.
+              </listitem>
+          </itemizedlist>
         </para>
     </refsection>
     <refsection>
@@ -142,7 +157,7 @@ syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
             of the evaluation call <literal>sl=bloc2ss(syst);</literal> is a
             state-space representation for <literal>1/(s^2+s-1)</literal>.
         </para>
-        <para>[2] LFT example</para>
+        <para>[2] Example of LFT (Linear Fractional Transformation):</para>
         <programlisting role="example"><![CDATA[
 //Initialization
 syst=list('blocd');
index dcc56e5..d7785c8 100644 (file)
@@ -1,5 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Serge STEER
  * 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="bloc2ss" xml:lang="ja">
-
+<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="bloc2ss" xml:lang="ja">
     <refnamediv>
-
         <refname>bloc2ss</refname>
-
         <refpurpose>ブロック図を状態空間表現に変換</refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
-        <synopsis>[sl]=bloc2ss(blocd)</synopsis>
-
+        <synopsis>sl = bloc2ss(blocd)</synopsis>
     </refsynopsisdiv>
-
     <refsection>
-
         <title>引数</title>
-
         <variablelist>
-
             <varlistentry>
-
                 <term>blocd</term>
-
                 <listitem>
-
                     <para>リスト</para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>sl</term>
-
                 <listitem>
-
                     <para>リスト</para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             線形システムのブロック図表現を指定すると,
-
             <literal>bloc2ss</literal>はこの形式を状態空間線形システムに
-
             変換します.
-
             リスト <literal>blocd</literal>の最初の要素は,
-
             文字列 <literal>'blocd'</literal>である必要があります.
-
             このリストのその他の各要素はそれ自体,以下の型のリストとなります:
-
         </para>
-
         <programlisting role=""><![CDATA[
 list('transfer','name_of_linear_system')
  ]]></programlisting>
-
         <programlisting role=""><![CDATA[
 list('link','name_of_link',
              [number_of_upstream_box,upstream_box_port],
@@ -99,119 +63,70 @@ list('link','name_of_link',
              [downstream_box_2,downstream_box_2_portnumber],
              ...)
  ]]></programlisting>
-
         <para>
-
             文字列 <literal>'transfer'</literal> および
-
-            <literal>'links'</literal> はブロック図の中での要素の型を示す
-
+            <literal>'link'</literal> はブロック図の中での要素の型を示す
             キーワードです.
-
         </para>
-
         <para>ケース1 :
-
             リストの2番目のパラメータは,
-
             状態空間表現(<literal>syslin</literal> リスト)または伝達関数形式(有理数の行列)
-
             で指定される
-
             線形システムのScilab名を指す(またはそのように評価される)文字列
-
             です.
-
         </para>
-
         <para>
-
             各伝達関数ブロックには1つの整数値がふられます.
-
             伝達関数ブロックの各入力および出力にも整数値の番号がふられます.
-
             (例を参照)
-
         </para>
-
         <para>ケース2 :
-
             ブロック図表現の2種類目の要素はリンクです.
-
             リンクは,
-
             対<literal>[number_of_upstream_box,upstream_box_port]</literal>で
-
             表されるブロックの出力と
-
             他のブロックの入力を結合します.
-
             この際,各入力は,対
-
             <literal>[downstream_box_i,downstream_box_i_portnumber]</literal>
-
             のように表されます.
-
         </para>
-
         <para>ブロックの異なる要素を任意の順序で
-
             定義できます.
-
         </para>
-
         <para>例えば,</para>
-
         <para>
-
             [1] ゲイン1のフィードバックを有する<literal>S1*S2</literal>.
-
         </para>
-
         <para>
-
             3つの伝達関数, <literal>S1</literal> (番号
-
             <literal>n_s1=2</literal>) , <literal>S2</literal> (番号
-
             <literal>n_s2=3</literal>) および伝達関す記号が<literal>['1','1']</literal>
-
             となる加算器  (番号
-
             <literal>n_add=4</literal>) があります.
-
         </para>
-
         <para>
-
-            リンクは 4 つあります. 最初のリンク (名前は <literal>'U'</literal>)
-
-            入力 を加算器のポート1に結合します.
-
-            2番目と3番目のリンクはそれぞれ,
-
-            加算器の(出力)ポート1をシステム<literal>S1</literal>の(入力)ポート1,
-
-            <literal>S1</literal>の(出力)ポート1を<literal>S2</literal>の(入力)ポート1
-
-            に結合します.
-
-            (<literal>'Y'</literal>という名前の)4番目のリンクは,
-
-            <literal>S2</literal>の出力ポート1を出力
-
-            (仮想的なブロック -1 のポート0, 省略されている)
-
-            および加算器の(入力)ポート2に結合します.
-
+            リンクは 4 つあります :
+            <itemizedlist>
+              <listitem>
+                最初のリンク (名前は <literal>'U'</literal>) 入力 を加算器のポート1に結合します.
+              </listitem>
+              <listitem>
+                2番目と3番目のリンクはそれぞれ,
+                加算器の(出力)ポート1をシステム<literal>S1</literal>の(入力)ポート1,
+                <literal>S1</literal>の(出力)ポート1を<literal>S2</literal>の(入力)ポート1
+                に結合します.
+              </listitem>
+              <listitem>
+                (<literal>'Y'</literal>という名前の)4番目のリンクは,
+                <literal>S2</literal>の出力ポート1を出力
+                (仮想的なブロック -1 のポート0, 省略されている)
+                および加算器の(入力)ポート2に結合します.
+              </listitem>
+          </itemizedlist>
         </para>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
 //Initialization
 syst=list('blocd'); l=1;
@@ -228,19 +143,12 @@ l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
 // Outputs // -1 -> output 1
 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
  ]]></programlisting>
-
         <para>
-
             <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal>を指定すると,
-
             評価コール<literal>sl=bloc2ss(syst);</literal>の結果は,
-
             <literal>1/(s^2+s-1)</literal>の状態空間表現となります.
-
         </para>
-
-        <para>[2] LFT の例</para>
-
+        <para>[2] LFT の例 (Linear Fractional Transformation):</para>
         <programlisting role="example"><![CDATA[
 //Initialization
 syst=list('blocd'); l=1;
@@ -254,9 +162,7 @@ l=l+1;syst(l)=list('link','z',[n_s,1],[-1]);
 l=l+1;syst(l)=list('link','u',[n_k,1],[n_s,2]);
 l=l+1;syst(l)=list('link','y',[n_s,2],[n_k,1]);
  ]]></programlisting>
-
         <para>ただし,</para>
-
         <programlisting role="example"><![CDATA[
 A=[0,1;0,0];
 B=[1;1];
@@ -273,5 +179,4 @@ P=syslin('c',A,B,C,D);
             </member>
         </simplelist>
     </refsection>
-</refentry>
-
+</refentry>
\ No newline at end of file
index efd6c5a..a6aa85a 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA - Serge STEER
  * 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:ns4="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="bloc2ss" 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:ns4="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="bloc2ss" xml:lang="pt">
     <refnamediv>
         <refname>bloc2ss</refname>
-        <refpurpose>conversão de diagrama de blocos para espaço de estados
+        <refpurpose>conversão de diagrama de blocos para espaço de estados
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>[sl]=bloc2ss(blocd)</synopsis>
+        <title>Seqüência de Chamamento</title>
+        <synopsis>sl = bloc2ss(blocd)</synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>blocd</term>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
-        <para>Dada uma representação em diagrama de blocos de um sistema linear,
-            <literal>bloc2ss</literal> converte esta representação em um sistema
-            linear de espaço de estados. O primeiro elemento da lista
+        <title>Descrição</title>
+        <para>Dada uma representação em diagrama de blocos de um sistema linear,
+            <literal>bloc2ss</literal> converte esta representação em um sistema
+            linear de espaço de estados. O primeiro elemento da lista
             <literal>blocd</literal> deve ser o string (cadeia de caracteres)
-            <literal>'blocd'</literal>. Cada outro elemento desta lista é, por si
+            <literal>'blocd'</literal>. Cada outro elemento desta lista é, por si
             mesmo, uma lista de um dos seguintes tipos :
         </para>
         <programlisting role=""><![CDATA[
 list('transfer','nome_do_sistema_linear')
  ]]></programlisting>
         <programlisting role=""><![CDATA[
-list('link','nome_do_link', [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
-               [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
-               [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
+list('link','nome_do_link', [número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior],
+               [caixa_de_fluxo_inferior_1,número_de_porta_da_caixa_inferior_1],
+               [caixa_de_fluxo_inferior_2,número_de_porta_da_caixa_inferior_2],
                ...)
  ]]></programlisting>
         <para>
             Os strings <literal>'transfer'</literal> e
-            <literal>'links'</literal> são palavras-chaves as quais indicam o tipo de
-            elemento no diagrama de blocos ("transfer"=transferência, "link"=
-            ligação).
+            <literal>'link'</literal> são palavras-chaves as quais indicam o tipo de
+            elemento no diagrama de blocos ("transfer"=transferência, "link"=
+            ligação).
         </para>
-        <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
-            (para uma possível avaliação posterior) ao nome Scilab de um sistema
-            linear dado em representação de espaço de estados (lista
-            <literal>syslin</literal>) ou em forma de trasnferência (matriz de razões
-            de polinômios).
+        <para>Caso 1: o segundo parâmetro da lista é um string que pode se referir
+            (para uma possível avaliação posterior) ao nome Scilab de um sistema
+            linear dado em representação de espaço de estados (lista
+            <literal>syslin</literal>) ou em forma de trasnferência (matriz de razões
+            de polinômios).
         </para>
-        <para>A cada bloco de transferência é associado um inteiro. A cada entrada
-            e saida de um bloco de transferência, também é associado seu número, um
+        <para>A cada bloco de transferência é associado um inteiro. A cada entrada
+            e saida de um bloco de transferência, também é associado seu número, um
             inteiro (ver exemplos).
         </para>
-        <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
-            de blocos é um link. Um link liga uma saída de um bloco representado pelo
+        <para>Caso 2: O segundo tipo de elemento em uma representação de diagrama
+            de blocos é um link. Um link liga uma saída de um bloco representado pelo
             par <literal>[
-                número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]
+                número_de_caixa_de_fluxo_superior,porta_da_caixa_de_fluxo_superior]
             </literal>
             ,
-            a diferentes entradas de outros blocos. Cada tal entrada é representada
-            pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
+            a diferentes entradas de outros blocos. Cada tal entrada é representada
+            pelo par [caixa_de_fluxo_inferior_i,número_de_porta_da_caixa_inferior_i]
             .
         </para>
         <para>Os diferentes elementos de um diagrama de blocos podem ser definidos
-            em ordem arbitrária.
+            em ordem arbitrária.
         </para>
         <para>Por exmeplo:</para>
         <para>
@@ -94,24 +97,36 @@ list('link','nome_do_link', [n
             unidade.
         </para>
         <para>
-            Há 3 transferências <literal>S1</literal> (número
-            <literal>n_s1=2</literal>) , <literal>S2</literal> (número
-            <literal>n_s2=3</literal>) e um adicionador ("adder") (número
-            <literal>n_add=4</literal>) com função de transferência simbólica
+            Há 3 transferências <literal>S1</literal> (número
+            <literal>n_s1=2</literal>) , <literal>S2</literal> (número
+            <literal>n_s2=3</literal>) e um adicionador ("adder") (número
+            <literal>n_add=4</literal>) com função de transferência simbólica
             <literal>['1','1']</literal>.
         </para>
         <para>
-            Há 4 links. O primeiro (de nome <literal>'U'</literal>) liga a
-            entrada (porta 0 de bloco fictício -1, omitido) à porta 1 do adicionador.
-            Os segundo e terceiro ligam respectivamente a porta (de saída) 1 do
-            adicionador à porta (de entrada) 1 do sistema <literal>S1</literal>, e a
-            porta (de saída) 1 de <literal>S1</literal> à porta (de entrada) 1 de
-            <literal>S2</literal>. O quarto link (de nome <literal>'Y'</literal>) liga
-            a porta (de saída) 1 de <literal>S2</literal> à saída (porta 0 do bloco
-            fictício -1, omitido) e à porta (de entrada) 2 do adicionador.
+            Há 4 links :
+            <itemizedlist>
+                <listitem>
+                  O primeiro (de nome <literal>'U'</literal>) liga a entrada (porta 0 de bloco
+                  fictício -1, omitido) à porta 1 do adicionador.
+              </listitem>
+              <listitem>
+                Os segundo liga a porta (de saída) 1 do  adicionador à porta (de entrada) 1 do
+                sistema <literal>S1</literal>.
+              </listitem>
+              <listitem>
+                Os terceiro liga a porta (de saída)  1 de <literal>S1</literal> à porta
+                (de entrada) 1 de <literal>S2</literal>.
+              </listitem>
+              <listitem>
+                O quarto link (de nome <literal>'Y'</literal>) liga  a porta (de saída) 1 de
+                <literal>S2</literal> à saída (porta 0 do bloco fictício -1, omitido) e à porta
+                (de entrada) 2 do adicionador.
+              </listitem>
+           </itemizedlist>
         </para>
         <programlisting role="example"><![CDATA[
-//Inicialização
+//Inicialização
 syst=list('blocd'); l=1;
 
 //Sistemas
@@ -127,19 +142,19 @@ l=l+1;syst(l)=list('link','U1',[-1],[n_adder,1]);
 l=l+1;syst(l)=list('link',' ',[n_adder,1],[n_s1,1]);
 l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
 
-// Saídas // -1 -> saída 1
+// Saídas // -1 -> saída 1
 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
  ]]></programlisting>
         <para>
             Com <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal> o resultado
-            da avaliação de chamada <literal>sl=bloc2ss(syst);</literal> é uma
-            representação em estado-espaço para <literal>1/(s^2+s-1)</literal>.
+            da avaliação de chamada <literal>sl=bloc2ss(syst);</literal> é uma
+            representação em estado-espaço para <literal>1/(s^2+s-1)</literal>.
         </para>
-        <para>[2] exemplo da transformação linear fracional (TLF e, em inglês
+        <para>[2] exemplo da transformação linear fracional (TLF e, em inglês
             LFT):
         </para>
         <programlisting role="example"><![CDATA[
-//Inicialização
+//Inicialização
 syst=list('blocd'); l=1;
 
 //Sistema (planta de blocos 2x2)
@@ -164,7 +179,7 @@ P=syslin('c',A,B,C,D);
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
-        <title>Ver Também</title>
+        <title>Ver Também</title>
         <simplelist type="inline">
             <member>
                 <link linkend="poly">poly</link>
index 735e631..e33285c 100644 (file)
  * 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="bloc2ss" xml:lang="ru">
+<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="bloc2ss" xml:lang="ru">
     <refnamediv>
         <refname>bloc2ss</refname>
         <refpurpose>преобразование блок-схемы в пространство состояний</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
-        <synopsis>[sl]=bloc2ss(blocd)</synopsis>
+        <synopsis>sl = bloc2ss(blocd)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
     <refsection>
         <title>Описание</title>
         <para>
-            Заданную линейную систему в виде блок-схемы <literal>bloc2ss</literal> преобразует в линейную систему пространство состояний. Первый элемент списка  <literal>blocd</literal> должен быть строкой <literal>'blocd'</literal>. Остальные элементы этого списка должны сами по себе быть списками одного из следующего типа:
+            Заданную линейную систему в виде блок-схемы <literal>bloc2ss</literal> преобразует
+            в линейную систему пространство состояний. Первый элемент списка
+           <literal>blocd</literal> должен быть строкой <literal>'blocd'</literal>.
+           Остальные элементы этого списка должны сами по себе быть списками одного из следующего типа:
         </para>
         <programlisting><![CDATA[
 list('transfer','name_of_linear_system')
@@ -60,7 +66,8 @@ list('link','name_of_link',
             словами, которые указывают тип элемента в блок-схеме.
         </para>
         <para>
-            Случай 1: второй параметр списка является символьной строкой, которая может ссылаться (для возможного дальнейшего вычисления) на Scilab-имя линейной системы,
+            Случай 1: второй параметр списка является символьной строкой, которая может ссылаться
+            (для возможного дальнейшего вычисления) на Scilab-имя линейной системы,
             заданной в виде пространства состояний  (список <literal>syslin</literal>) или в
             передаточной форме (матрица или рациональные дроби).
         </para>
@@ -69,8 +76,13 @@ list('link','name_of_link',
             передаточного блока также присваивается свой номер, целое число (см. примеры).
         </para>
         <para>
-            Случай 2: второй вид элемента в представлении блок-схемы - это связь (link). Связь связывает один выход блока, представленного парой <literal>[number_of_upstream_box,upstream_box_port]</literal> (то есть <literal>[номер_предшествующего_блока,порт_предшествующего_блока]</literal>), с различными входами других блоков. Каждый такой вход предсталяется парой
-            <literal>[downstream_box_i,downstream_box_i_portnumber]</literal> (то есть <literal>[последующий_блок_i,номер_порта_последующего_блока_i]</literal>).
+            Случай 2: второй вид элемента в представлении блок-схемы - это связь (link).
+            Связь связывает один выход блока, представленного парой
+            <literal>[number_of_upstream_box,upstream_box_port]</literal>
+            (то есть <literal>[номер_предшествующего_блока,порт_предшествующего_блока]</literal>),
+            с различными входами других блоков. Каждый такой вход предсталяется парой
+            <literal>[downstream_box_i,downstream_box_i_portnumber]</literal>
+            (то есть <literal>[последующий_блок_i,номер_порта_последующего_блока_i]</literal>).
         </para>
         <para>
             Различные элементы блок-схемы могут определяться в произвольном порядке.
@@ -82,16 +94,27 @@ list('link','name_of_link',
         <para>
             Есть три передаточных звена <literal>S1</literal> (число
             <literal>n_s1=2</literal>) , <literal>S2</literal> (число
-            <literal>n_s2=3</literal>) и сумматор (число <literal>n_add=4</literal>) с символической передаточной функцией  <literal>['1','1']</literal>.
+            <literal>n_s2=3</literal>) и сумматор (число <literal>n_add=4</literal>)
+            с символической передаточной функцией  <literal>['1','1']</literal>.
         </para>
         <para>
-            Есть 4 связи. Первая (с именем <literal>'U'</literal>) связывает вход (порт 0
-            условного блока -1 не рассматривается) с портом 1 сумматора. Вторая и третья связи
-            соответственно (выходной) порт 1 сумматора с (входным) портом 1 системы
-            <literal>S1</literal>, а (выходной) порт 1  <literal>S1</literal> с (входным) портом
-            1 <literal>S2</literal>. Четвёртая связь (названная <literal>'Y'</literal>)
-            связывает (выходной) порт 1 <literal>S2</literal> с выходом (порт 0 условного блока
-            -1 не рассматривается) и с (входным) портом 2 сумматора.
+            Есть 4 связи :
+            <itemizedlist>
+              <listitem>
+                Первая (с именем <literal>'U'</literal>) связывает вход (порт 0  условного блока
+                -1 не рассматривается) с портом 1 сумматора.
+              </listitem>
+              <listitem>
+                Вторая и третья связи соответственно (выходной) порт 1 сумматора с (входным)
+                портом 1 системы <literal>S1</literal>, а (выходной) порт 1
+                <literal>S1</literal> с (входным) портом  1 <literal>S2</literal>.
+              </listitem>
+              <listitem>
+                Четвёртая связь (названная <literal>'Y'</literal>)  связывает (выходной)
+                порт 1 <literal>S2</literal> с выходом (порт 0 условного блока -1 не
+                рассматривается) и с (входным) портом 2 сумматора.
+              </listitem>
+            </itemizedlist>
         </para>
     </refsection>
     <refsection>
@@ -117,9 +140,11 @@ l=l+1;syst(l)=list('link',' ',[n_s1,1],[n_s2,1]);
 l=l+1;syst(l)=list('link','Y',[n_s2,1],[-1],[n_adder,2]);
  ]]></programlisting>
         <para>
-            Для <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal> результатом вызова исполнения <literal>sl=bloc2ss(syst);</literal> является представление в пространстве состояний для <literal>1/(s^2+s-1)</literal>.
+            Для <literal>s=poly(0,'s');S1=1/(s+1);S2=1/s;</literal> результатом вызова исполнения
+            <literal>sl=bloc2ss(syst);</literal> является представление в пространстве
+            состояний для <literal>1/(s^2+s-1)</literal>.
         </para>
-        <para>[2] Пример LFT</para>
+        <para>[2] Пример LFT (Linear Fractional Transformation) :</para>
         <programlisting role="example"><![CDATA[
 // Инициализация
 syst=list('blocd'); l=1;