.TH "WXMAXIMA" "1" "2024-02-10" "wxMaxima 24.02.1"
.SH "NAME"
wxmaxima \- wxWidgets interface for Maxima

.SH "SYNOPSIS"
.PP
\fBwxmaxima\fR [-v] [-h] [-o <str>] [-e] [-b] [--logtostderr] [--pipe] [--exit-on-error] [-f <str>] [-u <str>] [-l <str>] [-X <str>] [-m <str>] [--enableipc] [input file...]

.SH "DESCRIPTION"
.PP
\fBwxMaxima\fR is a rather self-explanatory graphical
front-end to the Maxima computer algebra system. It
provides a graphical interface and 2D formatted output display
for Maxima. Its menu system facilitates access to a huge part of
the Maxima native set of commands and also to a browsable Maxima
help. The dialogue windows make easy the introduction of
mathematical entities such as limits, matrices, etc. Besides that,
it extends Maxima with a few powerful features like the ability to
create diagrams with one parameter bound to a slider gui control.
.PP
One can create worksheets, which can include mathematical cells (and the
results) but also different headlines, text cells, images, page breaks, etc.
.PP
Maxima is a free (GPL) common lisp implementation based on the
original computer algebra system Macsyma developed at MIT. It
has full documentation (HTML and info) included.
.PP
wxMaxima uses the cross-platform GUI toolkit wxWidgets and
runs natively on many operative systems.

.SH "OPTIONS"
.TP
.I \-h, \-\-help
Help: prints a list of options.

.TP
.I \-v, \-\-version
Prints the current version.

.TP
.I \-b, \-\-batch
processes the file, saves it afterward. Will halt if wxMaxima finds an
error message in Maxima's output and pause if Maxima asks a question.

.TP
.I \-o, \-\-open=<str>
Open a file at startup.

.TP
.I \-e, \-\-eval=<str>
Evaluate the file after opening it.

.TP
.I \-\-logtostderr
Log all "debug messages" sidebar messages to stderr, too.

.TP
.I \-\-pipe
Pipe messages from Maxima to stdout.

.TP
.I \-\-exit-on-error
Close the program on any Maxima error.

.TP
.I \-f, --ini=<str>
Allows specifying a file to store the configuration in

.TP
.I \-u, \-\-use-version=<str>
Use Maxima version <str>.

.TP
.I \-l, \-\-lisp=<str>
Use a Maxima compiled with lisp compiler <str>.

.TP
.I \-X, \-\-extra-args=<str>
Allows to specify extra Maxima arguments

.TP
.I \-m, \-\-maxima=<str>
Allows to specify the location of the Maxima binary.

.TP
.I \-\-enableipc
Lets Maxima control wxMaxima via interprocess communications. Use this option with care.

.SH FILES
.TP
.I ~/.config/wxMaxima.conf
The personal wxMaxima initialization file, where user-specific settings are stored.

.TP
.I ~/.maxima/wxmaxima-init.mac
If the Maxima user directory - usually
.I ~/.maxima/
- contains a text file named
.I wxmaxima-init.mac
the contents of the file are passed to Maxima automatically every time a new worksheet has been started.

.SH BUGS
If you find a bug in wxMaxima, please report it in the
.UR https://github.com/wxMaxima-developers/wxmaxima/issues
wxMaxima bug database
.UE

(Please check first, if it was not already reported.) And if you have a fix,
that would be great. wxMaxima is an open-source project, where you can contribute.

If the issue is a mathematical bug, it might be a bug in Maxima (the
backend, which does the mathematical computations), not wxMaxima
(the graphical frontend).

The Maxima bug database is available at
.UR https://sourceforge.net/p/maxima/bugs/
Sourceforge
.UE

.SH "AUTHORS"
.PP

.IP \[bu] 2
J. Rafael Rodriguez Galvan (Debian project), original author of the manual page
.IP \[bu]
Gunter Königsmann (wxMaxima project)
.IP \[bu]
Wolfgang Dautermannn (wxMaxima project)

.PP
Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU General Public License, Version 2 or any later version
published by the Free Software Foundation.

.SH "SEE ALSO"
.BR maxima(1),
.BR xmaxima(1)

.UR https://wxmaxima-developers.github.io/wxmaxima/
The website of wxMaxima
.UE

.UR https://wxmaxima-developers.github.io/wxmaxima/help.html
wxMaxima documentation and tutorials
.UE