← Back to branch summary

~ubuntu-branches/ubuntu/natty/mathomatic/natty

« back to all changes in this revision

Viewing changes to doc/mathomatic.1.html

  • Committer: Bazaar Package Importer
  • Author(s): Sandro Tosi
  • Date: 2010-05-27 23:29:55 UTC
  • mfrom: (1.1.26 upstream) (3.1.15 sid)
  • Revision ID: james.westby@ubuntu.com-20100527232955-xzvvnwdzy8c9mdji
Tags: 15.1.1-1
* New upstream release
* debian/patches/10_fix_makefile.dpatch
  - updated to new upstream code
* debian/patches/30_bts-459093_ftbfs_make_test_time.dpatch
  - updated to new upstream code

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/mathomatic.1.html
20
20
<p> 
21
21
<h2><a name='sect2' href='#toc2'>Description</a></h2>
22
22
Mathomatic is a portable Computer Algebra
23
 
System (CAS) that can symbolically solve, simplify, combine, and compare
24
 
equations, perform general complex number and polynomial arithmetic, etc.
25
 
It does some calculus and handles all elementary algebra, except logarithms.
 
23
System (CAS) that can solve, simplify, combine, and compare algebraic equations,
 
24
perform general complex number and polynomial arithmetic, etc. It does some
 
25
calculus and handles all elementary algebra, except logarithms. Plotting
 
26
expressions with gnuplot is also supported. 
 
27
<p> <b>mathomatic</b> is the main Mathomatic
 
28
application that does interactive symbolic-numeric mathematics through a
 
29
console interface. The numerical arithmetic is double precision floating
 
30
point with up to 14 decimal digits accuracy. Many results will be exact,
 
31
because multiple combined floating point numbers can be used for a single
 
32
mathematical value; for example: <b>2^(1/3),</b> which is the cubed root of 2 exactly.
26
33
 
27
 
<p> <b>mathomatic</b> is an interactive symbolic-numeric mathematics interpreter. The
28
 
numerical arithmetic is double precision floating point with up to 14 decimal
29
 
digits accuracy. Many results will be exact. 
30
 
<p> <b>rmath</b> allows you to use Mathomatic
31
 
with input of functions like sin(x) and sqrt(x) automatically expanded
32
 
to equivalent algebraic expressions by the <b>m4</b> macro processor. 
 
34
<p> <b>rmath</b> allows you to use Mathomatic with input of functions like <b>sin(x)</b>
 
35
and <b>sqrt(x)</b> automatically expanded to equivalent algebraic expressions
 
36
by the <b>m4</b> macro processor. 
33
37
<p> 
34
38
<h2><a name='sect3' href='#toc3'>Options</a></h2>
35
39
 
36
40
<dl>
37
41
 
38
 
<dt><b>-b</b>
39
 
</dt>
40
 
<dd>Enable bold colors. Color mode will be turned on and colors will be brighter
41
 
if this option is specified. Same as the "set bold color" command. 
 
42
<dt><b>-b</b> </dt>
 
43
<dd>Enable bold colors. Color mode will
 
44
be turned on and colors will be brighter if this option is specified. Same
 
45
as the "set bold color" command. 
42
46
<p> </dd>
43
47
 
44
48
<dt><b>-c</b> </dt>
45
 
<dd>Toggle
46
 
color mode. This mode outputs ANSI terminal escape sequences to make each
47
 
level of parentheses a different color, for easier reading. Requires a terminal
48
 
emulator that supports ANSI color escape sequences. If the colors are too
49
 
hard to see, use the <b>-b</b> option to increase the brightness. 
 
49
<dd>Toggle color mode. This mode outputs
 
50
ANSI terminal escape sequences to make each level of parentheses a different
 
51
color, for easier reading. Requires a terminal emulator that supports ANSI
 
52
color escape sequences. If the colors are too hard to see, use the <b>-b</b> option
 
53
to increase the brightness. 
50
54
<p> </dd>
51
55
 
52
56
<dt><b>-h</b> </dt>
53
 
<dd>Display a brief
54
 
help message listing all of these options and then exit. 
 
57
<dd>Display a brief help message listing all
 
58
of these options and then exit. 
55
59
<p> </dd>
56
60
 
57
61
<dt><b>-m number</b> </dt>
58
 
<dd>Change
59
 
the memory size of equation spaces. It is followed by a decimal floating
60
 
point number which is a multiplier of the default equation space size. This
61
 
allows larger equation spaces so that manipulating extremely large expressions
62
 
will succeed without getting the "Expression too large" error. Specifying
63
 
a number higher than 100 may make Mathomatic unresponsive. 
 
62
<dd>Change the memory size of equation
 
63
spaces. It is followed by a decimal floating point number which is a multiplier
 
64
of the default equation space size. This allows larger equation spaces so
 
65
that manipulating extremely large expressions will succeed without getting
 
66
the "Expression too large" error. Specifying a number higher than 100 may
 
67
make Mathomatic unresponsive. 
64
68
<p> </dd>
65
69
 
66
70
<dt><b>-q</b> </dt>
67
 
<dd>Set quiet
68
 
mode. The startup message and prompts are not displayed. This is useful when
69
 
piping or redirecting input into Mathomatic, because the input won&rsquo;t be
70
 
displayed, so prompt output should be turned off. This option does the same
71
 
thing as the "set no prompt" command. 
 
71
<dd>Set quiet mode. The startup message and
 
72
prompts are not displayed. This is useful when piping or redirecting input
 
73
into Mathomatic, because the input won&rsquo;t be displayed, so prompt output
 
74
should be turned off. This option does the same thing as the "set no prompt"
 
75
command. 
72
76
<p> </dd>
73
77
 
74
78
<dt><b>-r</b> </dt>
75
 
<dd>Disable readline input processing.
76
 
Readline allows using the cursor keys and outputs terminal control codes
77
 
which can be turned off with this option. 
 
79
<dd>Disable readline input processing. Readline allows using the
 
80
cursor keys and outputs terminal control codes which can be turned off
 
81
with this option. 
78
82
<p> </dd>
79
83
 
80
84
<dt><b>-s level</b> </dt>
81
 
<dd>Set the enforced security
82
 
level for the Mathomatic session. Level 0 is the default with no security.
83
 
Level 1 disallows shelling out. Level 2 disallows shelling out and writing
84
 
files. Level 3 disallows shelling out and reading/writing files for complete
85
 
security. This run-time option was created for use on open public servers
86
 
that can&rsquo;t use the SECURE compile-time define. 
 
85
<dd>Set the enforced security level for the Mathomatic
 
86
session. Level 0 is the default with no security. Level 1 disallows shelling
 
87
out. Level 2 disallows shelling out and writing files. Level 3 disallows
 
88
shelling out and reading/writing files for complete security. This run-time
 
89
option was created for use on open public servers that can&rsquo;t use the SECURE
 
90
compile-time define. 
87
91
<p> </dd>
88
92
 
89
93
<dt><b>-t</b> </dt>
90
 
<dd>Set test mode. Used when
91
 
testing and comparing output. Bypasses loading startup file, turns off color
92
 
mode and readline, sets wide output mode, ignores pause command, etc. 
 
94
<dd>Set test mode. Used when testing and comparing output.
 
95
Bypasses loading startup file, turns off color mode and readline, sets
 
96
wide output mode, ignores pause command, etc. 
93
97
<p> </dd>
94
98
 
95
 
<dt><b>-u</b>
96
 
</dt>
97
 
<dd>Guarantee that standard output and standard error output are unbuffered.
98
 
Useful when piping. 
 
99
<dt><b>-u</b> </dt>
 
100
<dd>Guarantee that standard
 
101
output and standard error output are unbuffered. Useful when piping. 
99
102
<p> </dd>
100
103
 
101
104
<dt><b>-v</b> </dt>
102
 
<dd>Display version number, compilation options used,
103
 
maximum possible memory usage, then exit. 
 
105
<dd>Display
 
106
version number, compilation options used, maximum possible memory usage,
 
107
then exit. 
104
108
<p> </dd>
105
109
 
106
110
<dt><b>-w</b> </dt>
107
 
<dd>Set wide output mode for an
108
 
unlimited width output device like the "set wide" command does. Sets infinite
109
 
screen columns and rows so that 2D (two dimensional) expression output
110
 
will always succeed and not be downgraded to 1D output when it doesn&rsquo;t fit
111
 
in the display area. Use when redirecting output or with a terminal emulator
112
 
that doesn&rsquo;t wrap lines. This mode only affects 2D output. 
 
111
<dd>Set wide output mode for an unlimited width output device
 
112
like the "set wide" command does. Sets infinite screen columns and rows
 
113
so that 2D (two dimensional) expression output will always succeed and
 
114
not be downgraded to 1D output when it doesn&rsquo;t fit in the display area. Use
 
115
when redirecting output or with a terminal emulator that doesn&rsquo;t wrap lines.
 
116
This mode only affects 2D output. 
113
117
<p> </dd>
114
118
 
115
119
<dt><b>-x</b> </dt>
116
 
<dd>Enable HTML
117
 
output mode (which is also valid XHTML). This makes Mathomatic output suitable
118
 
for inclusion in a web page. The color mode and bold colors flags affect
119
 
this mode, allowing HTML color output. Wide output mode is also set by this
120
 
option, meaning expressions will always be displayed in 2D. 
 
120
<dd>Enable HTML output mode (which is also
 
121
valid XHTML). This makes Mathomatic output suitable for inclusion in a web
 
122
page. The color mode and bold colors flags affect this mode, allowing HTML
 
123
color output. Wide output mode is also set by this option, meaning expressions
 
124
will always be displayed in 2D. 
121
125
<p> </dd>
122
126
</dl>
123
127
 
124
128
<h2><a name='sect4' href='#toc4'>General</a></h2>
125
 
After
126
 
any options, text files may be specified on the shell command line that
127
 
will be automatically read in with the read command. 
128
 
<p> Mathomatic is best
129
 
run from within a terminal emulator. It uses console line input and output
130
 
for the user interface. First you type in your algebraic equations in standard
131
 
infix notation, then you can solve them by typing in the variable name
132
 
at the prompt, or perform operations on them with simple English commands.
133
 
Type "help" or "?" for the help command. If the command is longer than 4
134
 
letters, you only need to type in the first 4 letters. Most commands operate
135
 
on the current equation by default. 
136
 
<p> A command preceded by an exclamation
137
 
point (such as "!ls") is taken to be a shell command and is passed unchanged
138
 
to the shell (/bin/sh). "!" by itself invokes the default shell, which is
139
 
specified in the SHELL environment variable. "!" is also the factorial operator.
 
129
After any options, text files may
 
130
be specified on the shell command line that will be automatically read
 
131
in with the read command. 
 
132
<p> Mathomatic is best run from within a terminal
 
133
emulator. It uses console line input and output for the user interface. First
 
134
you type in your mathematical equations in standard infix notation, then
 
135
you can solve them by typing in the variable name at the prompt, or perform
 
136
operations on them with simple English commands. Type "help" or "?" for
 
137
the help command. If the command is longer than 4 letters, you only need
 
138
to type in the first 4 letters. Most commands operate on the current equation
 
139
by default. 
 
140
<p> A command preceded by an exclamation point (such as "!ls")
 
141
is taken to be a shell command and is passed unchanged to the shell (/bin/sh).
 
142
"!" by itself invokes the default shell, which is specified in the SHELL
 
143
environment variable. "!" is also the factorial operator. 
 
144
<p> Complete documentation
 
145
is available in HTML format; see the local documentation directory or online
 
146
at "<a href='http://mathomatic.org/math/doc/'>http://mathomatic.org/math/doc/</a>
 
147
" for the latest Mathomatic documentation.
140
148
 
141
 
<p> Complete documentation is available in HTML format; see the local documentation
142
 
directory or online at "<a href='http://mathomatic.org/math/doc/'>http://mathomatic.org/math/doc/</a>
143
 
" for the latest
144
 
Mathomatic documentation. 
145
149
<p> 
146
150
<h2><a name='sect5' href='#toc5'>Environment</a></h2>
147
151
 
148
152
<dl>
149
153
 
150
154
<dt><b>EDITOR</b> </dt>
151
 
<dd>The EDITOR environment variable
152
 
specifies which text editor to use for the edit command. 
 
155
<dd>The EDITOR environment variable specifies which text
 
156
editor to use for the edit command. 
153
157
<p> </dd>
154
158
</dl>
155
159
 
157
161
 
158
162
<dl>
159
163
 
160
 
<dt><b>~/.mathomaticrc</b>
161
 
</dt>
162
 
<dd>Optional startup file containing Mathomatic set command options. It should
163
 
be a text file with one set option per line. Do not include the word "set".
164
 
 For example, the line "no color" will make Mathomatic default to non-color
165
 
mode, which is useful if you are not using a standard terminal emulator.
166
 
 
 
164
<dt><b>~/.mathomaticrc</b> </dt>
 
165
<dd>Optional startup
 
166
file containing Mathomatic set command options. It should be a text file
 
167
with one set option per line. Do not include the word "set".  For example,
 
168
the line "no color" will make Mathomatic default to non-color mode, which
 
169
is useful if you are not using a standard terminal emulator. 
167
170
<p> </dd>
168
171
</dl>
169
172
 
170
173
<h2><a name='sect7' href='#toc7'>See Also</a></h2>
171
174
<a href='matho-primes.1.html'><b>matho-primes</b>(1)</a>
172
 
, <a href='primorial.1.html'><b>primorial</b>(1)</a>
 
175
,
 
176
<a href='primorial.1.html'><b>primorial</b>(1)</a>
173
177
, <a href='matho-mult.1.html'><b>matho-mult</b>(1)</a>
 
178
, <a href='matho-sum.1.html'><b>matho-sum</b>(1)</a>
174
179
, <a href='matho-pascal.1.html'><b>matho-pascal</b>(1)</a>
175
180
, <a href='matho-sumsq.1.html'><b>matho-sumsq</b>(1)</a>
176
181