* Bug 16624 fixed: fullfile() ignored forced final filesep
[scilab.git] / 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>