doc/info/pt/Bugs.texi

   1 @menu
   2 * Definições para Detecção e Relato de Erros::
   3 @end menu
   4
   5 @node Definições para Detecção e Relato de Erros
   6 @section Definições para Detecção e Relato de Erros
   7 @deffn {Função} run_testsuite ()
   8 @deffnx {Função} run_testsuite (@var{boolean})
   9 @deffnx {Função} run_testsuite (@var{boolean}, @var{boolean})
  10 @deffnx {Função} run_testsuite (@var{boolean}, @var{boolean}, @var{list})
  11 Executa o conjunto de testes do Maxima.  Testes que produzem a resposta
  12 desejada são considerados ``aprovações'' (em inglês, passes) e testes que
  13 não produzem a resposta desejada são marcados como erros.
  14
  15 @code{run_testsuite ()} mostra somente testes que não são aprovados.
  16
  17 @code{run_testsuite (true)} mostra somente testes que são marcados como
  18 erros, bem como as falhas.
  19
  20 @code{run_testsuite (true, true)} mostra todos os testes.
  21
  22 Se for usado o terceiro argumento opcional, que deve ser uma lista,
  23 executam-se unicamente os testes indicados nessa lista. Os nomes de
  24 todos os testes é especificado por @code{testsuite_files}.
  25
  26 @code{run_testsuite} altera a variável de ambiente Maxima.  Tipicamente
  27 um script de teste executa @code{kill} para estabelecer uma variável de
  28 ambiente (uma a saber sem funções definidas pelo utilizador e variáveis)
  29 e então define funções e variáveis apropriadamente para o teste.
  30
  31 @code{run_testsuite} retorna @code{done}.
  32 @end deffn
  33
  34 @defvar testsuite_files
  35
  36 @code{testsuite_files} é o conjunto de testes a ser executado por
  37 @code{run_testsuite}. É uma lista de nomes de ficheiros contendo os
  38 testes a executar. Se alguns dos testes num ficheiro falha de forma
  39 conhecida, então em lugar de listar o nome do ficheiro mostra-se uma
  40 lista com o nome do ficheiro e o número dos testes que falharam.
  41
  42 Por exemplo, a linha seguinte é uma parte do conjunto de testes padrão:
  43
  44 @example
  45  ["rtest13s", ["rtest14", 57, 63]]
  46 @end example
  47
  48 Essa linha especifica o conjunto de testes contidos nos ficheiros "rtest13s" e
  49 "rtest14", em que os testes números 57 e 63 do ficheiro "rtest14" falharam de forma conhecida.
  50 @end defvar
  51
  52 @defun bug_report ()
  53 Mostra os números de versão do Maxima e do Lisp e o apontador para o
  54 sítio onde devem informar-se os erros encontrados no Maxima, para que
  55 possam ser solucionados.  A informação das versões pode ser consultada
  56 também com @code{build_info}.
  57
  58 Quando se informa sobre um erro, é muito útil indicar a versão do Maxima
  59 e do Lisp usadas.
  60
  61 A saída do comando @code{bug_report} é uma sequência de caracteres vazia
  62 @code{""}.
  63 @end defun
  64
  65 @defun build_info ()
  66 Mostra os números de versão do Maxima e do Lisp.
  67
  68 A saída do comando @code{build_info} é uma sequência de caracteres vazia
  69 @code{""}.
  70 @end defun