← Back to branch summary

~ubuntu-branches/debian/squeeze/maxima/squeeze

« back to all changes in this revision

Viewing changes to doc/info/maxima_2.html

  • Committer: Bazaar Package Importer
  • Author(s): Camm Maguire
  • Date: 2006-10-18 14:52:42 UTC
  • mto: (1.1.5 upstream)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20061018145242-vzyrm5hmxr8kiosf
Import upstream version 5.10.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/info/maxima_2.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
 
2
<html>
 
3
<!-- Created on September, 20 2006 by texi2html 1.76 -->
 
4
<!--
 
5
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
 
6
            Karl Berry  <karl@freefriends.org>
 
7
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
 
8
            and many others.
 
9
Maintained by: Many creative people <dev@texi2html.cvshome.org>
 
10
Send bugs and suggestions to <users@texi2html.cvshome.org>
 
11
 
 
12
-->
 
13
<head>
 
14
<title>Maxima Manual: 2. Bug Detection and Reporting</title>
 
15
 
 
16
<meta name="description" content="Maxima Manual: 2. Bug Detection and Reporting">
 
17
<meta name="keywords" content="Maxima Manual: 2. Bug Detection and Reporting">
 
18
<meta name="resource-type" content="document">
 
19
<meta name="distribution" content="global">
 
20
<meta name="Generator" content="texi2html 1.76">
 
21
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
 
22
<style type="text/css">
 
23
<!--
 
24
a.summary-letter {text-decoration: none}
 
25
pre.display {font-family: serif}
 
26
pre.format {font-family: serif}
 
27
pre.menu-comment {font-family: serif}
 
28
pre.menu-preformatted {font-family: serif}
 
29
pre.smalldisplay {font-family: serif; font-size: smaller}
 
30
pre.smallexample {font-size: smaller}
 
31
pre.smallformat {font-family: serif; font-size: smaller}
 
32
pre.smalllisp {font-size: smaller}
 
33
span.sansserif {font-family:sans-serif; font-weight:normal;}
 
34
ul.toc {list-style: none}
 
35
body
 
36
{
 
37
    color: black;
 
38
    background: white; 
 
39
    margin-left: 8%;
 
40
    margin-right: 13%;
 
41
}
 
42
 
 
43
h1
 
44
{
 
45
    margin-left: +8%;
 
46
    font-size: 150%;
 
47
    font-family: sans-serif
 
48
}
 
49
 
 
50
h2
 
51
{
 
52
    font-size: 125%;
 
53
    font-family: sans-serif
 
54
}
 
55
 
 
56
h3
 
57
{
 
58
    font-size: 100%;
 
59
    font-family: sans-serif
 
60
}
 
61
 
 
62
h2,h3,h4,h5,h6 { margin-left: +4%; }
 
63
 
 
64
div.textbox
 
65
{
 
66
    border: solid;
 
67
    border-width: thin;
 
68
    /* width: 100%; */
 
69
    padding-top: 1em;
 
70
    padding-bottom: 1em;
 
71
    padding-left: 2em;
 
72
    padding-right: 2em
 
73
}
 
74
 
 
75
div.titlebox
 
76
{
 
77
    border: none;
 
78
    padding-top: 1em;
 
79
    padding-bottom: 1em;
 
80
    padding-left: 2em;
 
81
    padding-right: 2em;
 
82
    background: rgb(200,255,255);
 
83
    font-family: sans-serif
 
84
}
 
85
 
 
86
div.synopsisbox
 
87
{
 
88
    border: none;
 
89
    padding-top: 1em;
 
90
    padding-bottom: 1em;
 
91
    padding-left: 2em;
 
92
    padding-right: 2em;
 
93
     background: rgb(255,220,255);
 
94
    /*background: rgb(200,255,255); */
 
95
    /* font-family: fixed */
 
96
}
 
97
 
 
98
pre.example
 
99
{
 
100
    border: none;
 
101
    padding-top: 1em;
 
102
    padding-bottom: 1em;
 
103
    padding-left: 1em;
 
104
    padding-right: 1em;
 
105
    background: rgb(247,242,180); /* kind of sandy */
 
106
    /* background: rgb(200,255,255); */ /* sky blue */
 
107
    font-family: "Lucida Console", monospace
 
108
}
 
109
 
 
110
div.spacerbox
 
111
{
 
112
    border: none;
 
113
    padding-top: 2em;
 
114
    padding-bottom: 2em
 
115
}
 
116
 
 
117
div.image
 
118
{
 
119
    margin: 0;
 
120
    padding: 1em;
 
121
    text-align: center;
 
122
}
 
123
-->
 
124
</style>
 
125
 
 
126
<link rel="icon" href="http://maxima.sourceforge.net/favicon.ico"/>
 
127
</head>
 
128
 
 
129
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
 
130
 
 
131
<a name="Bug-Detection-and-Reporting"></a>
 
132
<a name="SEC2"></a>
 
133
<table cellpadding="1" cellspacing="1" border="0">
 
134
<tr><td valign="middle" align="left">[<a href="maxima_1.html#SEC1" title="Previous section in reading order"> &lt; </a>]</td>
 
135
<td valign="middle" align="left">[<a href="#SEC3" title="Next section in reading order"> &gt; </a>]</td>
 
136
<td valign="middle" align="left"> &nbsp; </td>
 
137
<td valign="middle" align="left">[<a href="maxima_1.html#SEC1" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 
138
<td valign="middle" align="left">[<a href="maxima.html#SEC_Top" title="Up section"> Up </a>]</td>
 
139
<td valign="middle" align="left">[<a href="maxima_3.html#SEC5" title="Next chapter"> &gt;&gt; </a>]</td>
 
140
<td valign="middle" align="left"> &nbsp; </td>
 
141
<td valign="middle" align="left"> &nbsp; </td>
 
142
<td valign="middle" align="left"> &nbsp; </td>
 
143
<td valign="middle" align="left"> &nbsp; </td>
 
144
<td valign="middle" align="left">[<a href="maxima.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
 
145
<td valign="middle" align="left">[<a href="maxima_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 
146
<td valign="middle" align="left">[<a href="maxima_72.html#SEC264" title="Index">Index</a>]</td>
 
147
<td valign="middle" align="left">[<a href="maxima_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 
148
</tr></table>
 
149
<h1 class="chapter"> 2. Bug Detection and Reporting </h1>
 
150
 
 
151
 
 
152
<table class="menu" border="0" cellspacing="0">
 
153
<tr><td align="left" valign="top"><a href="#SEC3">2.1 Introduction to Bug Detection and Reporting</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 
154
</td></tr>
 
155
<tr><td align="left" valign="top"><a href="#SEC4">2.2 Definitions for Bug Detection and Reporting</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
 
156
</td></tr>
 
157
</table>
 
158
 
 
159
<hr size="6">
 
160
<a name="Introduction-to-Bug-Detection-and-Reporting"></a>
 
161
<a name="SEC3"></a>
 
162
<table cellpadding="1" cellspacing="1" border="0">
 
163
<tr><td valign="middle" align="left">[<a href="#SEC2" title="Previous section in reading order"> &lt; </a>]</td>
 
164
<td valign="middle" align="left">[<a href="#SEC4" title="Next section in reading order"> &gt; </a>]</td>
 
165
<td valign="middle" align="left"> &nbsp; </td>
 
166
<td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 
167
<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
 
168
<td valign="middle" align="left">[<a href="maxima_3.html#SEC5" title="Next chapter"> &gt;&gt; </a>]</td>
 
169
<td valign="middle" align="left"> &nbsp; </td>
 
170
<td valign="middle" align="left"> &nbsp; </td>
 
171
<td valign="middle" align="left"> &nbsp; </td>
 
172
<td valign="middle" align="left"> &nbsp; </td>
 
173
<td valign="middle" align="left">[<a href="maxima.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
 
174
<td valign="middle" align="left">[<a href="maxima_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 
175
<td valign="middle" align="left">[<a href="maxima_72.html#SEC264" title="Index">Index</a>]</td>
 
176
<td valign="middle" align="left">[<a href="maxima_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 
177
</tr></table>
 
178
<h2 class="section"> 2.1 Introduction to Bug Detection and Reporting </h2>
 
179
<p>Like all large programs, Maxima contains both known and unknown
 
180
bugs. This chapter describes the built-in facilities for running the
 
181
Maxima test suite as well as reporting new bugs.
 
182
</p>
 
183
<hr size="6">
 
184
<a name="Definitions-for-Bug-Detection-and-Reporting"></a>
 
185
<a name="SEC4"></a>
 
186
<table cellpadding="1" cellspacing="1" border="0">
 
187
<tr><td valign="middle" align="left">[<a href="#SEC3" title="Previous section in reading order"> &lt; </a>]</td>
 
188
<td valign="middle" align="left">[<a href="maxima_3.html#SEC5" title="Next section in reading order"> &gt; </a>]</td>
 
189
<td valign="middle" align="left"> &nbsp; </td>
 
190
<td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 
191
<td valign="middle" align="left">[<a href="#SEC2" title="Up section"> Up </a>]</td>
 
192
<td valign="middle" align="left">[<a href="maxima_3.html#SEC5" title="Next chapter"> &gt;&gt; </a>]</td>
 
193
<td valign="middle" align="left"> &nbsp; </td>
 
194
<td valign="middle" align="left"> &nbsp; </td>
 
195
<td valign="middle" align="left"> &nbsp; </td>
 
196
<td valign="middle" align="left"> &nbsp; </td>
 
197
<td valign="middle" align="left">[<a href="maxima.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
 
198
<td valign="middle" align="left">[<a href="maxima_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 
199
<td valign="middle" align="left">[<a href="maxima_72.html#SEC264" title="Index">Index</a>]</td>
 
200
<td valign="middle" align="left">[<a href="maxima_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 
201
</tr></table>
 
202
<h2 class="section"> 2.2 Definitions for Bug Detection and Reporting </h2>
 
203
<dl>
 
204
<dt><u>Function:</u> <b>run_testsuite</b><i> ()</i>
 
205
<a name="IDX1"></a>
 
206
</dt>
 
207
<dt><u>Function:</u> <b>run_testsuite</b><i> (<var>boolean</var>)</i>
 
208
<a name="IDX2"></a>
 
209
</dt>
 
210
<dt><u>Function:</u> <b>run_testsuite</b><i> (<var>boolean</var>, <var>boolean</var>)</i>
 
211
<a name="IDX3"></a>
 
212
</dt>
 
213
<dt><u>Function:</u> <b>run_testsuite</b><i> (<var>boolean</var>, <var>boolean</var>, <var>list</var>)</i>
 
214
<a name="IDX4"></a>
 
215
</dt>
 
216
<dd><p>Run the Maxima test suite. Tests producing the desired answer are
 
217
considered &quot;passes,&quot; as are tests that do not produce the desired
 
218
answer, but are marked as known bugs.
 
219
</p>
 
220
<p><code>run_testsuite ()</code> displays only tests that do not pass.
 
221
</p>
 
222
<p><code>run_testsuite (true)</code> displays tests that are marked as known bugs, as
 
223
well as failures.
 
224
</p>
 
225
<p><code>run_testsuite (true, true)</code> displays all tests.
 
226
</p>
 
227
<p>If the optional third argument is given, a subset of the tests is run.
 
228
The subset of the tests to run is given as a list of the names of the
 
229
tests.  The complete set of tests is specified by <code>testsuite_files</code>.
 
230
</p>
 
231
<p><code>run_testsuite</code> changes the Maxima environment.
 
232
Typically a test script executes <code>kill</code> to establish a known environment
 
233
(namely one without user-defined functions and variables)
 
234
and then defines functions and variables appropriate to the test.
 
235
</p>
 
236
<p><code>run_testsuite</code> returns <code>done</code>.
 
237
</p></dd></dl>
 
238
 
 
239
<dl>
 
240
<dt><u>Option variable:</u> <b>testsuite_files</b>
 
241
<a name="IDX5"></a>
 
242
</dt>
 
243
<dd><p><code>testsuite_files</code> is the set of tests to be run by
 
244
<code>run_testsuite</code>.  It is a list of names of the files containing
 
245
the tests to run.  If some of the tests in a file are known to fail,
 
246
then instead of listing the name of the file, a list containing the
 
247
file name and the test numbers that fail is used.
 
248
</p>
 
249
<p>For example, this is a part of the default set of tests:
 
250
</p>
 
251
<table><tr><td>&nbsp;</td><td><pre class="example"> [&quot;rtest13s&quot;, [&quot;rtest14&quot;, 57, 63]]
 
252
</pre></td></tr></table>
 
253
<p>This specifies the testsuite consists of the files &quot;rtest13s&quot; and
 
254
&quot;rtest14&quot;, but &quot;rtest14&quot; contains two tests that are known to fail: 57
 
255
and 63.
 
256
</p></dd></dl>
 
257
 
 
258
<dl>
 
259
<dt><u>Function:</u> <b>bug_report</b><i> ()</i>
 
260
<a name="IDX6"></a>
 
261
</dt>
 
262
<dd><p>Prints out Maxima and Lisp version numbers, and gives a link
 
263
to the Maxima project bug report web page.
 
264
The version information is the same as reported by <code>build_info</code>.
 
265
</p>
 
266
<p>When a bug is reported, it is helpful to copy the Maxima
 
267
and Lisp version information into the bug report.
 
268
</p>
 
269
<p><code>bug_report</code> returns an empty string <code>&quot;&quot;</code>.
 
270
</p></dd></dl>
 
271
 
 
272
<dl>
 
273
<dt><u>Function:</u> <b>build_info</b><i> ()</i>
 
274
<a name="IDX7"></a>
 
275
</dt>
 
276
<dd><p>Prints out a summary of the parameters of the Maxima build.
 
277
</p>
 
278
<p><code>build_info</code> returns an empty string <code>&quot;&quot;</code>.
 
279
</p></dd></dl>
 
280
 
 
281
<hr size="6">
 
282
<table cellpadding="1" cellspacing="1" border="0">
 
283
<tr><td valign="middle" align="left">[<a href="#SEC2" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
 
284
<td valign="middle" align="left">[<a href="maxima_3.html#SEC5" title="Next chapter"> &gt;&gt; </a>]</td>
 
285
<td valign="middle" align="left"> &nbsp; </td>
 
286
<td valign="middle" align="left"> &nbsp; </td>
 
287
<td valign="middle" align="left"> &nbsp; </td>
 
288
<td valign="middle" align="left"> &nbsp; </td>
 
289
<td valign="middle" align="left"> &nbsp; </td>
 
290
<td valign="middle" align="left">[<a href="maxima.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
 
291
<td valign="middle" align="left">[<a href="maxima_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
 
292
<td valign="middle" align="left">[<a href="maxima_72.html#SEC264" title="Index">Index</a>]</td>
 
293
<td valign="middle" align="left">[<a href="maxima_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
 
294
</tr></table>
 
295
<p>
 
296
 <font size="-1">
 
297
  This document was generated by <em>Robert Dodier</em> on <em>September, 20 2006</em> using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
 
298
 </font>
 
299
 <br>
 
300
 
 
301
</p>
 
302
</body>
 
303
</html>