1 @c Language: Brazilian Portuguese, Encoding: iso-8859-1
2 @c /Bugs.texi/1.10/Sat Nov 25 04:02:06 2006//
4 * Definições para Detecção e Relato de Erros::
7 @node Definições para Detecção e Relato de Erros
8 @section Definições para Detecção e Relato de Erros
9 @deffn {Função} run_testsuite ()
10 @deffnx {Função} run_testsuite (@var{boolean})
11 @deffnx {Função} run_testsuite (@var{boolean}, @var{boolean})
12 @deffnx {Função} run_testsuite (@var{boolean}, @var{boolean}, @var{list})
13 Executa o conjunto de testes do Maxima. Testes que produzem a resposta desejada são
14 considerados ``passes,'' e testes que não produzem a resposta
15 desejada, são marcados como erros conhecidos.
17 @code{run_testsuite ()} mostra somente testes que não são aprovados.
19 @code{run_testsuite (true)} mostra somente testes que são marcados como erros conhecidos, bem
22 @code{run_testsuite (true, true)} mostra todos os testes.
24 Se o terceiro argumento opcional for dado, um subconjunto de testes é executado.
25 O subconjunto de testes para executar é dado como uma lista de nomes dos
26 testes. O conjunto completo de testes é especificado por @code{testsuite_files}.
28 @code{run_testsuite} altera a variável de ambiente Maxima.
29 Tipicamente um script de teste executa @code{kill} para estabelecer uma variável de ambiente
30 (uma a saber sem funções definidas pelo usuário e variáveis)
31 e então define funções e variáveis apropriadamente para o teste.
33 @code{run_testsuite} retorna @code{done}.
36 @defvr {Variável de opção} testsuite_files
38 @code{testsuite_files} é o conjunto de testes a ser executado por
39 @code{run_testsuite}. Isso é uma lista de nomes de arquivos contendo
40 os testes a executar. Se alguns dos testes em um arquivo falha de forma conhecida,
41 então em lugar de listar o nome do arquivo, uma lista contendo o
42 nome do arquivo e o número dos testes que falharam é usada.
44 por exemplo, a linha adinate é uma parte do conjunto de testes padrão:
47 ["rtest13s", ["rtest14", 57, 63]]
50 Essa linha especifica a suite de testes que consiste dos arquivos "rtest13s" e
51 "rtest14", mas "rtest14" contém dois testes que falham de forma conhecida: 57
55 @deffn {Função} bug_report ()
56 Imprime os números de versão do Maxima e do Lisp, e chama o link
57 para a página web de informação de erros do projeto Maxima.
58 A informação da versão é a mesma reportada por @code{build_info}.
60 Quando um erro é informado, é muito útil copiar a versão do Maxima
61 e do Lisp dentro da informação do erro.
63 @code{bug_report} retorna uma seq@"{u}ência de caracteres vazia @code{""}.
66 @deffn {Função} build_info ()
67 Imprime um sumário de parâmetros da compilação do Maxima.
69 @code{build_info} retorna uma seq@"{u}ência de caracteres vazia @code{""}.