[Maxima-commits] CVS: maxima/doc/info Help.texi, 1.22, 1.23 Introduction.texi, 1.6, 1.7

[Vadim V. Z. <vv...@us...>]

Update of /cvsroot/maxima/maxima/doc/info
In directory sc8-pr-cvs16.sourceforge.net:/tmp/cvs-serv8137

Modified Files:
	Help.texi Introduction.texi 
Log Message:
Update text and examples about describe ? ??


Index: Help.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/Help.texi,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -r1.22 -r1.23
--- Help.texi	27 May 2007 17:44:18 -0000	1.22
+++ Help.texi	30 May 2007 14:32:24 -0000	1.23
@@ -310,28 +310,38 @@
 
 @example
 (%i1) ?? integ
- 0: (maxima.info)Introduction to Elliptic Functions and Integrals.
- 1: Functions and Variables for Elliptic Integrals.
- 2: Integration.
- 3: Introduction to Integration.
- 4: Functions and Variables for Integration.
- 5: askinteger :Functions and Variables for Simplification.
- 6: integerp :Functions and Variables for Miscellaneous Options.
- 7: integrate :Functions and Variables for Integration.
- 8: integrate_use_rootsof :Functions and Variables for Integration.
- 9: integration_constant_counter :Functions and Variables for Integration.
+ 0: Functions and Variables for Elliptic Integrals
+ 1: Functions and Variables for Integration
+ 2: Introduction to Elliptic Functions and Integrals
+ 3: Introduction to Integration
+ 4: askinteger  (Functions and Variables for Simplification)
+ 5: integerp  (Functions and Variables for Miscellaneous Options)
+ 6: integer_partitions  (Functions and Variables for Sets)
+ 7: integrate  (Functions and Variables for Integration)
+ 8: integrate_use_rootsof  (Functions and Variables for Integration)
+ 9: integration_constant_counter  (Functions and Variables for Integration)
+ 10: nonnegintegerp  (Functions and Variables for linearalgebra)
 Enter space-separated numbers, `all' or `none': 7 8
 
-Info from file /use/local/maxima/doc/info/maxima.info:
- - Function: integrate (expr, var)
- - Function: integrate (expr, var, a, b)
-     Attempts to symbolically compute the integral of `expr' with
-     respect to `var'.  `integrate (expr, var)' is an indefinite
-     integral, while `integrate (expr, var, a, b)' is a definite
+ -- Function: integrate (<expr>, <x>)
+ -- Function: integrate (<expr>, <x>, <a>, <b>)
+     Attempts to symbolically compute the integral of <expr> with
+     respect to <x>.  `integrate (<expr>, <x>)' is an indefinite
+     integral, while `integrate (<expr>, <x>, <a>, <b>)' is a definite
      integral, [...]
+     
+ -- Option variable: integrate_use_rootsof
+     Default value: `false'
+
+     When `integrate_use_rootsof' is `true' and the denominator of a
+     rational function cannot be factored, `integrate' returns the
+     integral in a form which is a sum over the roots (not yet known)
+     of the denominator.
+     [...]
 @end example
 
-In this example, items 7 and 8 were selected.
+In this example, items 7 and 8 were selected 
+(output is shortened as indicated by @code{[...]}.
 All or none of the items could have been selected by entering @code{all} or @code{none},
 which can be abbreviated @code{a} or @code{n}, respectively.
 

Index: Introduction.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/Introduction.texi,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Introduction.texi	27 May 2007 17:44:19 -0000	1.6
+++ Introduction.texi	30 May 2007 14:32:24 -0000	1.7
@@ -24,44 +24,69 @@
 @end example
 
 Maxima can search the info pages.  Use the @kbd{describe} command to show
-all the commands and variables containing a string, and optionally their
-documentation. The question mark @code{?} is an abbreviation for @code{describe}:
+information about the command or all the commands and variables containing 
+a string. 
+The question mark @code{?} (exact search) and double question mark @code{??} 
+(inexact search) are abbreviations for @code{describe}:
 
 @example
-(%i1) ? integ
+(%i1) ?? integ
+ 0: Functions and Variables for Elliptic Integrals
+ 1: Functions and Variables for Integration
+ 2: Introduction to Elliptic Functions and Integrals
+ 3: Introduction to Integration
+ 4: askinteger  (Functions and Variables for Simplification)
+ 5: integerp  (Functions and Variables for Miscellaneous Options)
+ 6: integer_partitions  (Functions and Variables for Sets)
+ 7: integrate  (Functions and Variables for Integration)
+ 8: integrate_use_rootsof  (Functions and Variables for Integration)
+ 9: integration_constant_counter  (Functions and Variables for Integration)
+ 10: nonnegintegerp  (Functions and Variables for linearalgebra)
+Enter space-separated numbers, `all' or `none': 5 4
 
- 0: (maxima.info)Introduction to Elliptic Functions and Integrals.
- 1: Functions and Variables for Elliptic Integrals.
- 2: Integration.
- 3: Introduction to Integration.
- 4: Functions and Variables for Integration.
- 5: askinteger :Functions and Variables for Simplification.
- 6: integerp :Functions and Variables for Miscellaneous Options.
- 7: integrate :Functions and Variables for Integration.
- 8: integrate_use_rootsof :Functions and Variables for Integration.
- 9: integration_constant_counter :Functions and Variables for Integration.
-Enter space-separated numbers, `all' or `none': 6 5
+ -- Function: integerp (<expr>)
+     Returns `true' if <expr> is a literal numeric integer, otherwise
+     `false'.
 
-Info from file /usr/local/info/maxima.info:
- - Function: integerp (<expr>)
-     Returns `true' if <expr> is an integer, otherwise `false'.
+     `integerp' returns false if its argument is a symbol, even if the
+     argument is declared integer.
 
+     Examples:
 
- - Function: askinteger (expr, integer)
- - Function: askinteger (expr)
- - Function: askinteger (expr, even)
- - Function: askinteger (expr, odd)
-     `askinteger (expr, integer)' attempts to determine from the
-     `assume' database whether `expr' is an integer.  `askinteger' will
-     ask the user if it cannot tell otherwise, and attempt to install
-     the information in the database if possible.  `askinteger (expr)'
-     is equivalent to `askinteger (expr, integer)'.
+          (%i1) integerp (0);
+          (%o1)                         true
+          (%i2) integerp (1);
+          (%o2)                         true
+          (%i3) integerp (-17);
+          (%o3)                         true
+          (%i4) integerp (0.0);
+          (%o4)                         false
+          (%i5) integerp (1.0);
+          (%o5)                         false
+          (%i6) integerp (%pi);
+          (%o6)                         false
+          (%i7) integerp (n);
+          (%o7)                         false
+          (%i8) declare (n, integer);
+          (%o8)                         done
+          (%i9) integerp (n);
+          (%o9)                         false
 
-     `askinteger (expr, even)' and `askinteger (expr, odd)' likewise
-     attempt to determine if `expr' is an even integer or odd integer,
-     respectively.
+ -- Function: askinteger (<expr>, integer)
+ -- Function: askinteger (<expr>)
+ -- Function: askinteger (<expr>, even)
+ -- Function: askinteger (<expr>, odd)
+     `askinteger (<expr>, integer)' attempts to determine from the
+     `assume' database whether <expr> is an integer.  `askinteger'
+     prompts the user if it cannot tell otherwise, and attempt to
+     install the information in the database if possible.  `askinteger
+     (<expr>)' is equivalent to `askinteger (<expr>, integer)'.
 
-(%o1)                         false
+     `askinteger (<expr>, even)' and `askinteger (<expr>, odd)'
+     likewise attempt to determine if <expr> is an even integer or odd
+     integer, respectively.
+
+(%o1)                                true
 @end example
 
 To use a result in later calculations, you can assign it to a variable or