From: James A. <amu...@us...> - 2002-08-23 14:52:08
|
Update of /cvsroot/maxima/maxima/doc/man In directory usw-pr-cvs1:/tmp/cvs-serv15165 Modified Files: maxima.1 Log Message: Remainder updated for new Maxima interface, etc. Index: maxima.1 =================================================================== RCS file: /cvsroot/maxima/maxima/doc/man/maxima.1,v retrieving revision 1.4 retrieving revision 1.5 diff -u -d -r1.4 -r1.5 --- maxima.1 20 Aug 2002 19:24:22 -0000 1.4 +++ maxima.1 23 Aug 2002 14:52:05 -0000 1.5 @@ -1,4 +1,4 @@ -.TH MAXIMA 1L "August 19, 2002" +.TH MAXIMA 1L "August 23, 2002" .ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2 .ds Ts T\s-2RAN\s+2S\s-2CRIPT\s+2 .if t .ds Te T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X @@ -11,7 +11,8 @@ .ds Li "L\s-2ISP\s+2 .ds Ky "GNU Common L\s-2ISP\s+2 .ds Pr \fIprefix\fR -%" +.ds Vr \fIversion\fR + .SH NAME maxima \- Common LISP version of MACSYMA symbolic mathematics package released under the GNU Public License @@ -25,7 +26,7 @@ [\fIoptions\fR] .SH DESCRIPTION .I Maxima -is a version of the MIT-developed MACSYMA system, modifed to run under +is a version of the MIT-developed MACSYMA system, modified to run under \*(Cl. It is an interactive expert system and programming environment for symbolic and numerical mathematical manipulation. Written in \*(Li, it allows differentiation, integration, solution of linear or @@ -36,7 +37,7 @@ \*(Li-like functions and pattern matching facilities are provided. Files containing .I maxima -objects may be read from and written to disc files. Pre-written +objects may be read from and written to disk files. Pre-written .I maxima commands may be read from a file and executed, allowing batch-mode use. @@ -216,40 +217,95 @@ .I maxima to flush the buffer. .SH PLOTTING COMMANDS +Maxima is capable of producing 2- and 3-dimensional plots. Here is a +simple 2-dimensional example .LP -.B plot2d(sin(x),[x,-2,2]); +.B plot2d(sin(x),[x,-2*%pi,2*%pi]); +.LP +and a simple 3-dimensional example .LP .B plot3d(2^(-u^2+v^2),[u,-5,5],[v,-7,7]); .LP -the plots are now done using tcl/tk. -.SH FILES -.TP 2.2i -.I \*(Pr/lib/maxima-X-X -primary directory -.TP 2.2i -.I \*(Pr/lib/maxima-X-X/info +By default plotting is done by a TCL/Tk application supplied with +Maxima. If is gnuplot is available, it can be used by setting a plot +option as follows .LP -primary documentation directory, containing emacs style info files which -are used for the 'describe' command, and also for viewing under emacs. -There are also .html files for web browsers, and .texi files for running through -tex, to obtain a printed version of the manual. -.TP 2.2i -.I -maxima mode -.TP 2.2i -.I \*(Pr/lib/maxima-X-X/elisp/maxima-mode.el +.B set_plot_option([PLOT_FORMAT,gnuplot]); .LP -finding documentation on using maxima in gnu emacs. -There is also source level debugging, -if you run maxima over dbl in emacs, and use commands such as -.TP 2.2i -.I -:br myfun -to set a breakpoint +For more information, see "? plot". +.SH FILES +.TP 1.0i +.I \*(Pr/lib/maxima/\*(Vr/binary-\fIlisp\fR +Compiled files for lisp implementation \fIlisp\fR +.TP 1.0i +.I \*(Pr/info +primary documentation directory, containing info files which +are used for the 'describe' command, and also for viewing under emacs +or other info viewer. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/doc/html +HTML version of info documentation. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/demo +Maxima demo files. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/emacs +Elisp files for use with Emacs or XEmacs. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/share +Contributed external packages. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/doc/share +Documentation for contributed external packages. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/src +Complete Maxima source. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/tests +Test suite. +.TP 1.0i +.I \*(Pr/share/maxima/\*(Vr/xmaxima +Xmaxima support files. +.TP 1.0i +.I \*(Pr/libexec/maxima/\*(Vr/ +Maxima utility scripts. +.SH ENVIRONMENT VARIABLES .TP -Executables: -.I \*(Pr/bin/maxima and \*(Pr/bin/xmaxima +\fBMAXIMA_USERDIR\fR +Points to a directory for user customization files. Maxima's default search +paths include \fBMAXIMA_USERDIR\fR. Default value: \fB$HOME/.maxima\fR. +.TP +\fBMAXIMA_PREFIX\fR +Maxima looks for its input files in the directory configured at +compile time, \*(Pr. Maxima can be relocated to a different directory +as long as the maxima script maintains the same relative position with +respect to the Maxima input files. If, for some reason, the maxima +script needs to be relocated independently, \fBMAXIMA_PREFIX\fR needs to be +set to point to the top of the tree holding the input files. +.TP +\fBMAXIMA_DIRECTORY\fR +\fBMAXIMA_DIRECTORY\fR is equivalent to \fBMAXIMA_PREFIX\fR. It is +included only for backward compatibility with older versions of Maxima. .LP +Maxima uses several other environment variables for communication +between the maxima script and the lisp image. All such variables start +with \fIMAXIMA_\fR. They should not need to be modified by the user. +.SH CUSTOMIZATION FILES +.TP +\fBmaximarc\fR +\fBmaixmarc\fR is sourced by the maxima script at startup. It should +be located in \fB$MAXIMA_USERDIR\fR (see above). \fBmaximarc\fR can be +used, \fIe.g.\fR, to change the user's default lisp implementation +choice to CMUCL by including the line "MAXIMA_LISP=cmucl". +.TP +\fBmaxima-init.lisp\fR +At startup, maxima will load the lisp file \fBmaxima-init.lisp\fR if it is +found in the search path. +.TP +\fBmaxima-init.mac\fR +At startup, maxima will load the maxima file \fBmaxima-init.mac\fR if it is +found in the search path. +.SH REFERENCES Old Reference: .I "MACSYMA Reference Manual" (volumes 1 and 2). @@ -259,27 +315,36 @@ January 1983. .LP Newer references: -.I http://www.ma.utexas.edu/maxima.html +.I http://maxima.sourceforge.net .SH BUGS .I Maxima -is a complex system and there are undoubtedly bugs present. -Use at your own risk. -.SH AUTHOR -MACSYMA (Project MAC's SYmbolic MAnipulation System) was developed by the -Mathlab group of the MIT Laboratory for Computer Science (originally known -as Project MAC), during the years 1969-1972. -Their work was supported by grants NSG 1323 of the National -Aeronautics and Space Administration, N00014-77-C-0641 of the Office of Naval +is a complex system. It includes both known and unknown bugs. +Use at your own risk. The Maxima bug database is available at +.LP +http://sourceforge.net/tracker/?atid=104933&group_id=4933&func=browse +.LP +New bug reports are always appreciated. Please include the output of +the Maxima function "build_info()" with the report. +.SH AUTHORS + +MACSYMA (Project MAC's SYmbolic MAnipulation System) was developed by +the Mathlab group of the MIT Laboratory for Computer Science +(originally known as Project MAC), during the years 1969-1972. Their +work was supported by grants NSG 1323 of the National Aeronautics and +Space Administration, N00014-77-C-0641 of the Office of Naval Research, ET-78-C-02-4687 of the U.S. Department of Energy, and -F49620-79-C-020 of the U.S. Air Force. -MACSYMA was further modifed for use -under the UNIX operating system (for use on DEC VAX computers and Sun -workstations), by Richard Fateman and colleagues at the University of -California at Berkeley; this version of MACSYMA is known as VAXIMA. -The present version is a re-working of the public domain MIT MACSYMA -for \*(Ky, prepared by William Schelter, University of Texas at Austin -(wf...@ma...). It contains numerous additions, extensions and enhancements -of the original. The original version of this -manual page was written by R. P. C. Rodgers, UCSF School of Pharmacy, San Francisco, CA 94143 -(ro...@ma...) in 1989. +F49620-79-C-020 of the U.S. Air Force. MACSYMA was further modified +for use under the UNIX operating system (for use on DEC VAX computers +and Sun workstations), by Richard Fateman and colleagues at the +University of California at Berkeley; this version of MACSYMA is known +as VAXIMA. The present version stems from a re-working of the public +domain MIT MACSYMA for \*(Ky, prepared by William Schelter, University +of Texas at Austin until his passing away in 2001. It contains +numerous additions, extensions and enhancements of the original. The +original version of this manual page was written by R. P. C. Rodgers, +UCSF School of Pharmacy, San Francisco, CA 94143 +(ro...@ma...) in 1989. It was extensively revised by +James Amundson in 2002. + +Maxima is now developed and maintained by the Maxima project at <http://maxima.sourcforge.net>. .\" |