doc/info/pt_BR/Help.texi.update

   1 @c
   2 @c versao pt_BR baseada no md5sum abaixo:
   3 @c 035096e62d02de60369e60c80a03fdcd  Help.texi
   4 @c
   5 @menu
   6 * Documentation::
   7 * Functions and Variables for Help::
   8 @end menu
   9
  10 @c -----------------------------------------------------------------------------
  11 @node Documentation, Functions and Variables for Help, Help, Help
  12 @section Documentation
  13 @c -----------------------------------------------------------------------------
  14
  15 @c SHOULD TALK ABOUT OTHER FORMS OF DOCUMENTATION ASIDE FROM ON-LINE MANUAL.
  16
  17 O manual on-line de usu@'{a}rio do Maxima pode ser visto de diferentes formas.  A partir da
  18 linha de comando interativa do Maxima, o manual de usu@'{a}rio @'{e} visto no formato texto simples por meio do
  19 comando @mref{?}
  20 (i.e., a fun@,{c}@~{a}o @mref{describe})
  21 .  O manual de usu@'{a}rio @'{e}
  22 visto como hipertexto no formato @code{info} por meio do programa visualizador @code{info} e como uma
  23 p@'{a}gina web atrav@'{e}s de qualquer navegador comum.
  24
  25 O comando @mref{example}
  26 mostra exemplos de muitas fun@,{c}@~{o}es do Maxima.  Por exemplo,
  27
  28 @example
  29 (%i1) example (integrate);
  30 @end example
  31
  32 retorna
  33
  34 @example
  35 (%i2) test(f):=block([u],u:integrate(f,x),ratsimp(f-diff(u,x)))
  36 (%o2) test(f) := block([u], u : integrate(f, x),
  37                                          ratsimp(f - diff(u, x)))
  38 (%i3) test(sin(x))
  39 (%o3)                           0
  40 (%i4) test(1/(x+1))
  41 (%o4)                           0
  42 (%i5) test(1/(x^2+1))
  43 (%o5)                           0
  44 @end example
  45
  46 e um pouco mais.
  47
  48 @opencatbox
  49 @category{Intera@,{c}@~{a}o com o console}
  50 @closecatbox
  51
  52 @c -----------------------------------------------------------------------------
  53 @node Functions and Variables for Help,  , Documentation, Help
  54 @section Functions and Variables for Help
  55 @c -----------------------------------------------------------------------------
  56
  57 @c -----------------------------------------------------------------------------
  58 @anchor{apropos}
  59 @deffn {Fun@,{c}@~{a}o} apropos (@var{seqcaracteres})
  60
  61 Buscas por nomes do Maxima que possuem @var{seqcaracteres} aparecendo em qualquer lugar dentro
  62 delas.  Dessa forma, @code{apropos (exp)} retorna uma lista de todos os sinalizadores e fun@,{c}@~{o}es
  63 que possuem @code{exp} como parte de seus nomes, tais como @code{expand}, @code{exp},
  64 e @code{exponentialize}.  Desse modo se voc@^{e} lembra somente um peda@,{c}o do nome de
  65 alguma coisa voc@^{e} pode usar esse comando para encontrar o restante do nome.  Da mesma forma, voc@^{e}
  66 pode dizer @code{apropos (tr_)} para encontrar uma lista de muitos dos comutadores relacionados
  67 ao tradutor lisp, a maioria dos quais iniciam-se com @code{tr_}.
  68
  69 @code{apropos("")} retorna uma lista com todos os nomes do Maxima.
  70
  71 @code{apropos} retorna uma lista vazia @code{[]}, se nenhum nome for encontrado.
  72
  73 Exemplo:
  74
  75 Mostra todos os s@'{i}bolos do Maxima que possuem @code{"gamma"} no nome:
  76
  77 @c ===beg===
  78 @c apropos("gamma");
  79 @c ===end===
  80 @example
  81 (%i1) apropos("gamma");
  82 (%o1) [%gamma, gamma, gammalim, gamma_expand, gamma_incomplete_lower,
  83 gamma_incomplete, gamma_incomplete_generalized,
  84 gamma_incomplete_regularized, Gamma, log_gamma, makegamma,
  85 prefer_gamma_incomplete,
  86 gamma_incomplete_generalized_regularized]
  87 @end example
  88
  89 @opencatbox
  90 @category{Ajuda}
  91 @closecatbox
  92 @end deffn
  93
  94 @c -----------------------------------------------------------------------------
  95 @anchor{demo}
  96 @deffn {Fun@,{c}@~{a}o} demo (@var{nomearquivo})
  97
  98 Avalia express@~{o}es do Maxima dentro de @var{nomearquivo} e mostra os resultados.
  99 @code{demo} interrompe a execu@,{c}@~{a}o ap@'{o}s avalizr cada express@~{a}o e continua ap@'{o}s o
 100 usu@'{a}rio pressionar a tecla enter.  (Se o Xmaxima estiver sendo usado, @code{demo} pode precisar
 101 ver um ponto e v@'{i}rgula @code{;} seguido por um enter.)
 102
 103 A fun@,{c}@~{a}o @code{demo} busca a lista de diret@'{o}rios @mref{file_search_demo}
 104 para encontrar
 105 @code{nomearquivo}.  Se o arquivo tiver o sufixo @code{dem}, o sufixo pode ser
 106 omitido.  Veja tambẽm @mrefdot{file_search}
 107 .
 108
 109 @code{demo} avalia seus argumento.
 110 @code{demo} retorna o nome do arquivo de demonstra@,{c}@~{a}o.
 111
 112 Exemplo:
 113
 114 @example
 115 (%i1) demo ("disol");
 116
 117 batching /home/wfs/maxima/share/simplification/disol.dem
 118  At the _ prompt, type ';' followed by enter to get next demo
 119 (%i2)                      load(disol)
 120
 121 _
 122 (%i3)           exp1 : a (e (g + f) + b (d + c))
 123 (%o3)               a (e (g + f) + b (d + c))
 124
 125 _
 126 (%i4)                disolate(exp1, a, b, e)
 127 (%t4)                         d + c
 128
 129 (%t5)                         g + f
 130
 131 (%o5)                   a (%t5 e + %t4 b)
 132
 133 _
 134 @end example
 135
 136 @opencatbox
 137 @category{Ajuda} @category{Intera@,{c}@~{a}o com o console} @category{File input}
 138 @closecatbox
 139 @end deffn
 140
 141 @c -----------------------------------------------------------------------------
 142 @anchor{describe}
 143 @fnindex Ajuda
 144 @deffn  {Fun@,{c}@~{a}o} describe @
 145 @fname{describe} (@var{caracteres}) @
 146 @fname{describe} (@var{caracteres}, exact) @
 147 @fname{describe} (@var{caracteres}, inexact)
 148
 149 @code{describe(@var{caracteres})} @'{e} equivalente a
 150 @code{describe(@var{caracteres}, exact)}.
 151
 152 @code{describe(@var{seqcaracteres}, exact)} encontra um item com t@'{i}tulo igual
 153 (sens@'{i}vel @`{a} caixa alta ou baixa) a @var{seqcaracteres}, se existir qualquer tal item.
 154
 155 @code{describe(@var{seqcaracteres}, inexact)} encontra todos os itens documentados que possuirem
 156 @var{seqcaracteres} em seus t@'{i}tulos.  Caso hajam mais de um tal item, Maxima pede
 157 ao usu@'{a}rio para selecionar um ou mais itens para mostrar.
 158
 159 Na linha de comando interativa, @code{? qualquercoisa} (com um espa@,{c}o em branco entre @code{?} e
 160 @code{qualquercoisa}) @'{e} equivalente a @code{describe("qualquercoisa", exact)}, e @code{?? qualquercoisa}
 161 @'{e} equivalente a @code{describe("qualquercoisa", inexact)}.
 162
 163 @code{describe("", inexact)} retorna uma lista de todos os t@'{o}picos documentados no
 164 manual on-line.
 165
 166 A fun@,{c}@~{a}o @code{describe}  exige que seus argumentos sejam delimitados por aspas duplas (isso faz com que o argumento n@~{a}o seja avaliado).  @code{describe} retorna @code{true} se
 167 alguma documenta@,{c}@~{a}o for encontrada, de outra forma retorna @code{false}.
 168
 169 Veja tamb@'{e}m @ref{Documentation}.
 170
 171 Exemplo:
 172
 173 @example
 174 (%i1) ?? integ
 175  0: Functions and Variables for Elliptic Integrals
 176  1: Functions and Variables for Integration
 177  2: Introduction to Elliptic Functions and Integrals
 178  3: Introduction to Integration
 179  4: askinteger  (Functions and Variables for Simplification)
 180  5: integerp  (Functions and Variables for Miscellaneous Options)
 181  6: integer_partitions  (Functions and Variables for Sets)
 182  7: integrate  (Functions and Variables for Integration)
 183  8: integrate_use_rootsof  (Functions and Variables for
 184     Integration)
 185  9: integration_constant_counter  (Functions and Variables for
 186     Integration)
 187  10: nonnegintegerp  (Functions and Variables for linearalgebra)
 188 Enter space-separated numbers, `all' or `none': 7 8
 189
 190  -- Function: integrate (<expr>, <x>)
 191  -- Function: integrate (<expr>, <x>, <a>, <b>)
 192      Attempts to symbolically compute the integral of <expr> with
 193      respect to <x>.  `integrate (<expr>, <x>)' is an indefinite
 194      integral, while `integrate (<expr>, <x>, <a>, <b>)' is a
 195      definite integral, [...]
 196
 197  -- Option variable: integrate_use_rootsof
 198      Default value: `false'
 199
 200      When `integrate_use_rootsof' is `true' and the denominator of
 201      a rational function cannot be factored, `integrate' returns
 202      the integral in a form which is a sum over the roots (not yet
 203      known) of the denominator.
 204      [...]
 205 @end example
 206
 207 Nesse exemplo, os itens 7 e 8 foram selecionados (a sa@'{i}da @'{e} encurtada como indicado
 208 atrav@'{e}s de @code{[...]}).  Todos ou nenhum dos itens podem ter sido selecionados pela digita@,{c}@~{a}o de
 209 @code{all} ou de @code{none}, os quais podem ser abreviados para @code{a} ou @code{n},
 210 respectivamente.
 211
 212 @opencatbox
 213 @category{Ajuda} @category{Intera@,{c}@~{a}o com o console}
 214 @closecatbox
 215 @end deffn
 216
 217 @c -----------------------------------------------------------------------------
 218 @anchor{example}
 219 @deffn  {Fun@,{c}@~{a}o} example @
 220 @fname{example} (@var{t@'{o}pico}) @
 221 @fname{example} ()
 222
 223 @code{example (@var{t@'{o}pico})} alguns exemplos de @var{t@'{o}pico}, que pode ser
 224 um s@'{i}mbolo ou uma sequ@^{e}ncia de caracteres.  Para ver exemplos de operadores como @code{if}, @code{do},
 225 ou @code{lambda} o argumento de ve ser uma sequ@^{e}ncia de caracteres, e.g. @code{example ("do")}.
 226 A fun@,{c}@~{a}o @code{example} n@~{a}o @'{e} sens@'{i}vel @`{a} caixa alta ou baixa.  A maioria dos t@'{o}picos s@~{a}o nomes de fun@,{c}@~{a}o.
 227
 228 @code{example ()} retorna uma lista de todos os topicos reconhecidos.
 229
 230 O nome do arquivo contendo os exemplos @'{e} dado pela vari@'{a}vel global de
 231 op@,{c}@~{a}o @mrefcomma{manual_demo}
 232 cujo padr@~{a}o @'{e} @code{"manual.demo"}.
 233
 234 A fun@,{c}@~{a}o @code{example} exige que seus argumentos sejam delimitados por aspas duplas (isso faz com que o argumento n@~{a}o seja avaliado).  A fun@,{c}@~{a}o @code{example} retorna @code{done} a menos que
 235 nenhum exemplo seja encontrado ou n@~{a}o exista argumento, nesse caso @code{example}
 236 retorna a lista de todos os t@'{o}picos reconhecidos.
 237
 238 Exemplos:
 239
 240 @c ===beg===
 241 @c example(append);
 242 @c example("lambda");
 243 @c ===end===
 244 @example
 245 (%i1) example(append);
 246 (%i2) append([x+y,0,-3.2],[2.5e+20,x])
 247 (%o2)             [y + x, 0, - 3.2, 2.5e+20, x]
 248 (%o2)                         done
 249 (%i3) example("lambda");
 250
 251 (%i4) lambda([x,y,z],z^2+y^2+x^2)
 252                                     2    2    2
 253 (%o4)            lambda([x, y, z], z  + y  + x )
 254 (%i5) %(1,2,a)
 255                               2
 256 (%o5)                        a  + 5
 257 (%i6) a+2+1
 258 (%o6)                         a + 3
 259 (%o6)                         done
 260 @end example
 261
 262 @opencatbox
 263 @category{Ajuda} @category{Intera@,{c}@~{a}o com o console}
 264 @closecatbox
 265 @end deffn
 266
 267 @c -----------------------------------------------------------------------------
 268 @anchor{manual_demo}
 269 @defvr {Vari@'{a}vel de op@,{c}@~{a}o} manual_demo
 270 Valor padr@~{a}o: @code{"manual.demo"}
 271
 272 A vari@'{a}vel de op@,{c}@~{a}o @code{manual_demo} especifica o nome do arquivo contendo os exemplos para
 273 a fun@,{c}@~{a}o @code{example}.  Veja @mrefdot{example}
 274
 275 @opencatbox
 276 @category{Ajuda} @category{Vari@'{a}veis globais}
 277 @closecatbox
 278 @end defvr
 279