From: Dieter K. <cra...@us...> - 2010-06-29 22:29:53
|
Update of /cvsroot/maxima/maxima/doc/info In directory sfp-cvsdas-4.v30.ch3.sourceforge.com:/tmp/cvs-serv7976/doc/info Modified Files: Input.texi Log Message: Adding examples for and reformating the documentation of the option variables %edispflag, display2d, and the functions disp, display. Index: Input.texi =================================================================== RCS file: /cvsroot/maxima/maxima/doc/info/Input.texi,v retrieving revision 1.72 retrieving revision 1.73 diff -u -d -r1.72 -r1.73 --- Input.texi 13 May 2010 21:35:16 -0000 1.72 +++ Input.texi 29 Jun 2010 22:29:44 -0000 1.73 @@ -273,17 +273,35 @@ @end defvr +@c ----------------------------------------------------------------------------- @defvr {Option variable} %edispflag Default value: @code{false} -When @code{%edispflag} is @code{true}, -Maxima displays @code{%e} to a negative exponent as a quotient. -For example, @code{%e^-x} is displayed as @code{1/%e^x}. +When @code{%edispflag} is @code{true}, Maxima displays @code{%e} to a negative +exponent as a quotient. For example, @code{%e^-x} is displayed as @code{1/%e^x}. + +Example: + +@c ===beg=== +@c %e^-10; +@c %edispflag:true$ +@c %e^-10; +@c ===end=== +@example +(%i1) %e^-10; + - 10 +(%o1) %e +(%i2) %edispflag:true$ +(%i3) %e^-10; + 1 +(%o3) ---- + 10 + %e +@end example @opencatbox @category{Exponential and logarithm functions} @category{Display flags and variables} @closecatbox - @end defvr @deffn {Function} %th (@var{i}) @@ -579,12 +597,32 @@ @c @c @end defvar -@c REPHRASE, NEEDS EXAMPLES +@c ----------------------------------------------------------------------------- @deffn {Function} disp (@var{expr_1}, @var{expr_2}, ...) -is like @code{display} but only the value of the -arguments are displayed rather than equations. This is useful for -complicated arguments which don't have names or where only the value -of the argument is of interest and not the name. +is like @code{display} but only the value of the arguments are displayed rather +than equations. This is useful for complicated arguments which don't have names +or where only the value of the argument is of interest and not the name. + +Examples: + +@c ===beg=== +@c b[1,2]:x-x^2$ +@c x:123$ +@c isp(x, b[1,2], sin(1.0)); +@c ===end=== +@example +(%i1) b[1,2]:x-x^2$ +(%i2) x:123$ +(%i3) disp(x, b[1,2], sin(1.0)); + 123 + + 2 + x - x + + .8414709848078965 + +(%o3) done +@end example @opencatbox @category{Display functions} @@ -606,40 +644,69 @@ @end deffn -@c REPHRASE, MORE EXAMPLES +@c ----------------------------------------------------------------------------- @deffn {Function} display (@var{expr_1}, @var{expr_2}, ...) -Displays equations whose left side is -@var{expr_i} unevaluated, and whose right side is the value of the expression -centered on the line. This function is useful in blocks and @code{for} -statements in order to have intermediate results displayed. The -arguments to @code{display} are usually atoms, subscripted variables, or -function calls. See also @code{disp}. +Displays equations whose left side is @var{expr_i} unevaluated, and whose right +side is the value of the expression centered on the line. This function is +useful in blocks and @code{for} statements in order to have intermediate results +displayed. The arguments to @code{display} are usually atoms, subscripted +variables, or function calls. See also @code{disp}. +Examples: + +@c ===beg=== +@c b[1,2]:x-x^2$ +@c x:123$ +@c display(x, b[1,2], sin(1.0)); +@c ===end=== @example -(%i1) display(B[1,2]); +(%i1) b[1,2]:x-x^2$ +(%i2) x:123$ +(%i3) display(x, b[1,2], sin(1.0)); + x = 123 + 2 - B = X - X + b = x - x 1, 2 -(%o1) done + + sin(1.0) = .8414709848078965 + +(%o3) done @end example @opencatbox @category{Display functions} @closecatbox - @end deffn +@c ----------------------------------------------------------------------------- @defvr {Option variable} display2d Default value: @code{true} -When @code{display2d} is @code{false}, -the console display is a string (1-dimensional) form rather than a display -(2-dimensional) form. +When @code{display2d} is @code{false}, the console display is a string +(1-dimensional) form rather than a display (2-dimensional) form. + +Example: + +@c ===beg=== +@c x/(x^2+1); +@c display2d:false$ +@c x/(x^2+1); +@c ===end=== +@example +(%i1) x/(x^2+1); + x +(%o1) ------ + 2 + x + 1 +(%i2) display2d:false$ +(%i3) x/(x^2+1); +(%o3) x/(x^2+1) +@end example @opencatbox @category{Display flags and variables} @closecatbox - @end defvr @defvr {Option variable} display_format_internal |