scilab/modules/functions/help/pt_BR/libraries/genlib.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   4  * Copyright (C) ????-2008 - INRIA
   5  *
   6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
   7  *
   8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
   9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  10  * This file was originally licensed under the terms of the CeCILL v2.1,
  11  * and continues to be available under such terms.
  12  * For more information, see the COPYING file which you should have received
  13  * along with this program.
  14  *
  15  -->
  16 <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="genlib" xml:lang="pt">
  17     <refnamediv>
  18         <refname>genlib</refname>
  19         <refpurpose>constrói biblioteca a partir de funções em um
  20             diretório
  21         </refpurpose>
  22     </refnamediv>
  23     <refsynopsisdiv>
  24         <title>Seqüência de Chamamento</title>
  25         <synopsis>genlib(lib_name [[,dir_name, [ Force [,verb [,Names]]]])
  26             genlib(lib_name [,path=dir_name] [,verbose=verb] [,force=Force] [,names=Names])
  27         </synopsis>
  28     </refsynopsisdiv>
  29     <refsection>
  30         <title>Parâmetros</title>
  31         <variablelist>
  32             <varlistentry>
  33                 <term>lib_name:</term>
  34                 <listitem>
  35                     <para>string. O nome da variável biblioteca a ser (re)criada.</para>
  36                 </listitem>
  37             </varlistentry>
  38             <varlistentry>
  39                 <term>dir_name:</term>
  40                 <listitem>
  41                     <para>string. O nome do diretório onde se deve procurar arquivos
  42                         <literal>.sci</literal>.
  43                     </para>
  44                 </listitem>
  45             </varlistentry>
  46             <varlistentry>
  47                 <term>Force</term>
  48                 <listitem>
  49                     <para>
  50                         booleano (o padrão é <literal>%f</literal>). Para forçar
  51                         recompilação de arquivos .sci, ajuste-o para
  52                         <literal>%t</literal>.
  53                     </para>
  54                 </listitem>
  55             </varlistentry>
  56             <varlistentry>
  57                 <term>verb</term>
  58                 <listitem>
  59                     <para>
  60                         booleano (o padrão é <literal>%f</literal>). Para obter
  61                         informações ajuste-o para <literal>%t</literal>.
  62                     </para>
  63                 </listitem>
  64             </varlistentry>
  65             <varlistentry>
  66                 <term>Names</term>
  67                 <listitem>
  68                     <para>vetor de strings, os nomes das funções a serem inclusas na
  69                         bibilioteca. Por padrão, todos os arquivos sci são levados em
  70                         conta.
  71                     </para>
  72                 </listitem>
  73             </varlistentry>
  74         </variablelist>
  75     </refsection>
  76     <refsection>
  77         <title>Descrição</title>
  78         <para>
  79             Para cada arquivo <literal>.sci</literal> em
  80             <literal>dir_name</literal> (ou apenas para aqueles especificados pelo
  81             argumento <literal>Names</literal>), <literal>genlib</literal> executa um
  82             <literal>exec</literal> e salva as funções no arquivo
  83             <literal>.bin</literal> correspondente. O arquivo <literal>.sci</literal>
  84             só pode conter instruções Scilab. Se um arquivo <literal>.bin</literal>
  85             for mais novo que o arquivo <literal>.sci</literal> assicuadi,
  86             <literal>genlib</literal> não traduz nem salva o arquivo.
  87         </para>
  88         <para>O comportamento padrão pode ser modificado se
  89             <literal>force</literal> for fornecido e ajustado para
  90             <literal>%t</literal>. Neste último caso, a recompilação é sempre feita
  91             para cada arquivo <literal>.sci</literal>.
  92         </para>
  93         <para>
  94             Quando todos os arquivos <literal>.sci</literal> tiverem sido
  95             processados, <literal>genlib</literal> cria uma biblioteca nomeada
  96             <literal>lib_name</literal> e a salva arquivo <literal>lib</literal> em
  97             <literal>dir_name</literal>. Se a variável Scilab
  98             <literal>lib_name</literal> não estiver protegida (ver <link linkend="predef">predef</link>), esta variável é atualizada.
  99         </para>
 100         <para>
 101             Se <literal>verb</literal> estiver ajustado para
 102             <literal>%t</literal> informações são exibidas durante o processo de
 103             construção.
 104         </para>
 105         <para>
 106             Seo argumento <literal>dir_name</literal> não for fornecido e se a
 107             variável Scilab <literal>lib_name</literal> existe e é uma variável
 108             dir_name é tomado como sendo igual a o endereço de bibilioteca
 109             <literal>lib_name</literal> (modo de atualização).
 110         </para>
 111     </refsection>
 112     <refsection>
 113         <title>Restrições</title>
 114         <para>
 115             Scilab assume implicitamente que <literal>foo.sci</literal> define
 116             pelo menos uma função de nome <literal>foo</literal>. Se funções
 117             subsidiárias estiverem inlusas, elas são tornadas conhecidas ao Scilab
 118             apenas depois que função <literal>foo</literal> tiver sido
 119             referencida.
 120         </para>
 121     </refsection>
 122     <refsection role="see also">
 123         <title>Ver Também</title>
 124         <simplelist type="inline">
 125             <member>
 126                 <link linkend="getd">getd</link>
 127             </member>
 128             <member>
 129                 <link linkend="exec">exec</link>
 130             </member>
 131             <member>
 132                 <link linkend="save">save</link>
 133             </member>
 134             <member>
 135                 <link linkend="lib">lib</link>
 136             </member>
 137         </simplelist>
 138     </refsection>
 139 </refentry>