doc/info/pt_BR/Bugs.texi.update

   1 @c
   2 @c versao pt_BR baseada no md5sum abaixo:
   3 @c 317105385ccfe3ae53448fa1969c6ccb  Bugs.texi
   4 @c
   5 @menu
   6 * Functions and Variables for Bug Detection and Reporting::
   7 @end menu
   8
   9 @c -----------------------------------------------------------------------------
  10 @node Functions and Variables for Bug Detection and Reporting
  11 @section Functions and Variables for Bug Detection and Reporting
  12 @c -----------------------------------------------------------------------------
  13
  14 @c -----------------------------------------------------------------------------
  15 @anchor{run_testsuite}
  16 @deffn {Fun@,{c}@~{a}o} run_testsuite ([@var{options}])
  17
  18 Executa os aplicativos de teste do Maxima.  Testes que produzem as respostas desejadas s@~{a}o
  19 considerados ``passes,'' @footnote{Nota do tradutor: aprovado.} e tamb@'{e}m os testes que n@~{a}o produzem a resposta
  20 desejada mas que forem marcados como erros conhecidos.
  21
  22 A fun@,{c}@~{a}o @code{run_testsuite} pode ser usada com as seguintes palavras chave opcionais como argumento
  23
  24 @table @code
  25 @item display_all
  26 Mostra todos os testes.  Normalmente, os testes n@~{a}o s@~{a}o mostrados, a menos que o teste
  27 falhe.  (O padr@~{a}o @'{e} @code{false}).
  28 @item display_known_bugs
  29 Mostra os testes que forem marcados como erros conhecidos.  (O padr@~{a}o @'{e} @code{false}).
  30 @item tests
  31 @'{E} um teste @'{u}nico ou uma lista de testes que devem ser executados.  Cada teste pode ser especificado por
  32 ou uma sequ@^{e}ncia de caracteres ou por um s@'{i}mbolo.  Por padr@~{a}o, todos os testes s@~{a}o executados.  O conjunto completo
  33 de testes @'{e} especificado por @mrefdot{testsuite_files}
  34 @item time
  35 Mostra informa@,{c}@~{o}es de tempo.  Se @code{true}, o tempo gasto em cada
  36 arquivo de teste @'{e} mostrado.  Se @code{all}, o tempo para cada teste
  37 individualmente @'{e} mostrado se @code{display_all} for @code{true}.  O padr@~{a}o @'{e}
  38 @code{false}, ent@~{a}o nenhuma informa@,{c}@~{a}o de tempo @'{e} mostrada.
  39 @end table
  40
  41 Por exemplo @code{run_testsuite(display_known_bugs = true, tests=[rtest5])}
  42 executa apenas o teste @code{rtest5} e mostra os testes que estiverem marcados como
  43 erros conhecidos.
  44
  45 @code{run_testsuite(display_all = true, tests=["rtest1", rtest1a])} ir@'{a}
  46 executar os testes @code{rtest1} e @code{rtest2}, e mostrar cada teste.
  47
  48 @code{run_testsuite} muda o ambiente de trabalho do Maxima.
  49 Tipicamente um acript de teste executa um @mref{kill}
  50 para estabelecer um ambiente conhecido
  51 (isto @'{e}, um ambiente sem fun@,{c}@~{o}es e vari@'{a}veis definidas pelo usu@'{a}rio)
  52 e ent@~{a}o define fun@,{c}@~{o}es e vari@'{a}veis apropriadas para o teste.
  53
  54 @code{run_testsuite} retorna @code{done}.
  55
  56 @opencatbox
  57 @category{Depurando}
  58 @closecatbox
  59 @end deffn
  60
  61 @c -----------------------------------------------------------------------------
  62 @anchor{testsuite_files}
  63 @defvr {Vari@'{a}vel de op@,{c}@~{a}o} testsuite_files
  64
  65 A vari@'{a}vel de op@,{c}@~{a}o @code{testsuite_files} cont@'{e}m o conjunto de testes a serem executados por
  66 @mrefdot{run_testsuite}
  67 @'{E} uma lista de nomes de arquivos contendo
  68 os testes a serem executados.  Se algum dos testes em um dos arquivos forem falhas conhecidas,
  69 ent@~{a}o ao inv@'{e}s de listar o nome do arquivo, uma lista contendo o
  70 nome do arquivo e os n@'{u}meros dos testes que falham @'{e} usada.
  71
  72 Por exemplo, adiante temos uma parte do conjunto padr@~{a}o de testes:
  73
  74 @example
  75  ["rtest13s", ["rtest14", 57, 63]]
  76 @end example
  77
  78 Essa parte especifica o teste constitu@'{i}do pelos arquivos "rtest13s" e
  79 "rtest14", mas "rtest14" cont@'{e}m dois testes que falham de forma prevista: 57
  80 e 63.
  81
  82 @opencatbox
  83 @category{Depurando} @category{Vari@'{a}veis globais}
  84 @closecatbox
  85 @end defvr
  86
  87 @c -----------------------------------------------------------------------------
  88 @anchor{bug_report}
  89 @deffn {Fun@,{c}@~{a}o} bug_report ()
  90
  91 Mostra os n@'{u}meros de vers@~{a}o do Maxima e do Lisp, e fornece um link
  92 para a p@'{a}gina do relat@'{o}rio de erros do projeto Maxima.
  93 Essa informa@,{c}@~{a}o de vers@~{a}o @'{e} a mesma informada por @mrefdot{build_info}
  94
  95 Quando um erro @'{e} informado, @'{e} muito @'{u}til copiar as vers@~{o}es
  96 do Maxima e do Lisp dentro do relat@'{o}rio de erro.
  97
  98 @code{bug_report} retorna uma sequ@^{e}ncia de caracteres vazia @code{""}.
  99
 100 @opencatbox
 101 @category{Depurando}
 102 @closecatbox
 103 @end deffn
 104
 105 @c -----------------------------------------------------------------------------
 106 @anchor{build_info}
 107 @deffn {Fun@,{c}@~{a}o} build_info ()
 108
 109 Retorna um resumo dos par@^{a}metros de compila@,{c}@~{a}o do Maxima,
 110 na forma de uma estrutura do Maxima (definida por @code{defstruct}).
 111 Os campos da estrutura s@~{a}o:
 112 @code{version}, @code{timestamp}, @code{host}, @code{lisp_name}, e @code{lisp_version}.
 113 Quando a op@,{c}@~{a}o pretty-printer estiver habilitada (via @code{display2d}@footnote{Nota do tradutor: ``display2d : true''.}),
 114 a estrutura @'{e} mostrada como uma tabela curta.
 115
 116 Veja tamb@'{e}m @mrefdot{bug_report}
 117
 118 Exemplos:
 119
 120 @c ===beg===
 121 @c build_info ();
 122 @c x : build_info ()$
 123 @c x@version;
 124 @c x@timestamp;
 125 @c x@host;
 126 @c x@lisp_name;
 127 @c x@lisp_version;
 128 @c x;
 129 @c ===end===
 130 @example
 131 @group
 132 (%i1) build_info ();
 133 (%o1)
 134 Maxima version: "5.26.0_16_gb72c64c_dirty"
 135 Maxima build date: "2012-01-29 12:29:04"
 136 Host type: "i686-pc-linux-gnu"
 137 Lisp implementation type: "CMU Common Lisp"
 138 Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches"
 139 @end group
 140 (%i2) x : build_info ()$
 141 @group
 142 (%i3) x@@version;
 143 (%o3)               5.26.0_16_gb72c64c_dirty
 144 @end group
 145 @group
 146 (%i4) x@@timestamp;
 147 (%o4)                  2012-01-29 12:29:04
 148 @end group
 149 @group
 150 (%i5) x@@host;
 151 (%o5)                   i686-pc-linux-gnu
 152 @end group
 153 @group
 154 (%i6) x@@lisp_name;
 155 (%o6)                    CMU Common Lisp
 156 @end group
 157 @group
 158 (%i7) x@@lisp_version;
 159 (%o7)
 160     CVS release-19a 19a-release-20040728 + minimal debian patches
 161 @end group
 162 @group
 163 (%i8) x;
 164 (%o8)
 165 Maxima version: "5.26.0_16_gb72c64c_dirty"
 166 Maxima build date: "2012-01-29 12:29:04"
 167 Host type: "i686-pc-linux-gnu"
 168 Lisp implementation type: "CMU Common Lisp"
 169 Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches"
 170 @end group
 171 @end example
 172
 173 @opencatbox
 174 @category{Depurando}
 175 @closecatbox
 176 @end deffn