doc/info/es/Bugs.es.texi

   1 @c English version 2012-01-29
   2 @menu
   3 * Funciones y variables para la detección e informe de fallos::
   4 @end menu
   5
   6
   7 @node Funciones y variables para la detección e informe de fallos,  , Detección e informe de fallos, Detección e informe de fallos
   8
   9 @section Funciones y variables para la detección e informe de fallos
  10
  11 @deffn {Función} run_testsuite ([@var{options}])
  12
  13 Ejecuta el conjunto de pruebas de Maxima. Los tests que producen las
  14 respuestas deseadas son considerados como ``pruebas superadas'', como
  15 los tests que no producen las respuestas deseadas, son marcados como
  16 fallos conocidos.
  17
  18 @code{run_testsuite} admite las siguientes opciones:
  19
  20 @table @code
  21 @item display_all
  22 Muestra todas las pruebas. Normalmente no se muestran las pruebas,
  23 a menos que produzcan fallos. (Su valor por defecto es @code{false}).
  24 @item display_known_bugs
  25 Muestra las pruebas marcadas como fallos ya conocidos. (Su valor
  26 por defecto es @code{false}).
  27 @item tests
  28 Esta es la lista de las pruebas que se deben ejecutar. Cada prueba
  29 se puede especificar, tanto mediante una cadena de texto como
  30 por un símbolo. Por defecto, todas las pruebas se ejecutan. El
  31 conjunto completo de pruebas está especificado en @code{testsuite_files}.
  32 @item time
  33 Muestra información sobre tiempos de ejecución. Si vale @code{true},
  34 se muestran los tiempos de los ficheros de prueba. Si vale @code{all},
  35 se muestran los tiempos de cada prueba individual si @code{display_all}
  36 vale @code{true}. El valor por defecto es @code{false}, por lo que no
  37 se muestra información temporal alguna.
  38 @end table
  39
  40 Por ejemplo, @code{run_testsuite(display_known_bugs = true, tests=[rtest5])}
  41 ejecuta la prueba @code{rtest5} y muestra si está marcada como fallo
  42 conocido.
  43
  44 @code{run_testsuite(display_all = true, tests=["rtest1", rtest1a])} ejecutará
  45 las pruebas @code{rtest1} y @code{rtest2}, mostrando cada una de ellas.
  46
  47 @code{run_testsuite} cambia el entorno de Maxima.
  48 Típicamente un script de test ejecuta @code{kill} para establecer un entorno conocido (llámese uno sin funciones ni variables definidas por el usuario) y entonces define una serie de funciones y variables apropiadas para el test.
  49
  50 @code{run_testsuite} retorna @code{done}.
  51 @end deffn
  52
  53
  54 @defvr {Variable opcional} testsuite_files
  55
  56 @code{testsuite_files} es el conjunto de tests a ejecutar por @code{run_testsuite}. Se trata de una lista con los nombres de los ficheros que contienen los tests a ejecutar. Si se sabe que alguno de los tests de un fichero falla, entonces en lugar de listar el nombre del fichero, se utiliza una lista que contiene el nombre del fichero y los números de los tests que fallan.
  57
  58 Por ejemplo, esta es una parte de los tests por defecto:
  59
  60 @example
  61  ["rtest13s", ["rtest14", 57, 63]]
  62 @end example
  63
  64 Con esto se especifica que el conjunto de tests está formado por los ficheros "rtest13s"  y "rtest14", pero que "rtest14" contiene dos tests que se sabe que causan fallos, el 57 y el 63.
  65 @end defvr
  66
  67
  68 @deffn {Función} bug_report ()
  69 Imprime las versiones de Maxima y de Lisp y proporciona un enlace a la
  70 página web sobre informe de fallos del proyecto Maxima.
  71 La información respecto a las versiones es la misma que reporta la
  72 función @code{build_info}.
  73
  74 Cuando se informa sobre un fallo, es de gran ayuda que se copie la
  75 información relacionada con la versión de Maxima y de Lisp usada,
  76 dentro del propio informe.
  77
  78 @code{bug_report} retorna una cadena vacía @code{""}.
  79 @end deffn
  80
  81 @deffn {Función} build_info ()
  82 Devuelve un resumen de los parÃ¡metros con los que se ha compilado Maxima
  83 en formato de estructura @code{defstruct}. Los campos de la estructura son:
  84 @code{version}, @code{timestamp}, @code{host}, @code{lisp_name} y @code{lisp_version}.
  85 Cuando @code{display2d} toma el valor @code{true}, la estructura se muestra como una
  86 pequeña tabla.
  87
  88 Véase también @code{bug_report}.
  89
  90 Ejemplos:
  91
  92 @c ===beg===
  93 @c build_info ();
  94 @c x : build_info ()$
  95 @c x@version;
  96 @c x@timestamp;
  97 @c x@host;
  98 @c x@lisp_name;
  99 @c x@lisp_version;
 100 @c x;
 101 @c ===end===
 102 @example
 103 @group
 104 (%i1) build_info ();
 105 (%o1)
 106 Maxima version: "5.26.0_16_gb72c64c_dirty"
 107 Maxima build date: "2012-01-29 12:29:04"
 108 Host type: "i686-pc-linux-gnu"
 109 Lisp implementation type: "CMU Common Lisp"
 110 Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches"
 111 @end group
 112 (%i2) x : build_info ()$
 113 @group
 114 (%i3) x@@version;
 115 (%o3)               5.26.0_16_gb72c64c_dirty
 116 @end group
 117 @group
 118 (%i4) x@@timestamp;
 119 (%o4)                  2012-01-29 12:29:04
 120 @end group
 121 @group
 122 (%i5) x@@host;
 123 (%o5)                   i686-pc-linux-gnu
 124 @end group
 125 @group
 126 (%i6) x@@lisp_name;
 127 (%o6)                    CMU Common Lisp
 128 @end group
 129 @group
 130 (%i7) x@@lisp_version;
 131 (%o7)
 132     CVS release-19a 19a-release-20040728 + minimal debian patches
 133 @end group
 134 @group
 135 (%i8) x;
 136 (%o8)
 137 Maxima version: "5.26.0_16_gb72c64c_dirty"
 138 Maxima build date: "2012-01-29 12:29:04"
 139 Host type: "i686-pc-linux-gnu"
 140 Lisp implementation type: "CMU Common Lisp"
 141 Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches"
 142 @end group
 143 @end example
 144 @end deffn
 145