patches to the manual



Attached is a patch to the Maxima manual. The patch fixes outstanding
reported bugs.
Below I report the bugs, the diagnosis and the fix.

2873057
-incorrect version is reported in manual front page
-added @VERSION@

2824360
-missing bug reporting node in manual's detailed menu
-inserted node

2148461
-docs for factor refer to "the field of integers"
-integers replaced by rationals

2424628
-Documentation bug in "4.1 Introduction to Command Line"
  reported output was incorrect for ''sin(1)
-deleted example because it is uninformative

2808568
-Reserved words that aren't reserved
  manual says users *cannot* assign to 'integrate', etc.
  and warns of potential cryptic error messages
-changed 'cannot' to 'should not'

-- 
The University of Edinburgh is a charitable body, registered in
Scotland, with registration number SC005336.

-------------- next part --------------
? maxima/doc/info/include-maxima.texi
? maxima/doc/info/maxima-index.lisp
Index: maxima/doc/info/Command.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/Command.texi,v
retrieving revision 1.46
diff -u -d -r1.46 Command.texi
--- maxima/doc/info/Command.texi	28 Nov 2007 03:36:40 -0000	1.46
+++ maxima/doc/info/Command.texi	5 Oct 2009 18:29:41 -0000
@@ -130,6 +130,23 @@
 (%o2)                          - 1
 @end example
 
+Maxima considers floating point operations by its in-built
+mathematical functions to be a simplification.
+
+ at c ===beg===
+ at c sin(1.0);
+ at c '(sin(1.0));
+ at c ===end===
+ at example
+(%i1) sin(1.0);
+(%o1)                          .8414709848078965
+(%i2) '(sin(1.0));
+(%o2)                          .8414709848078965
+ at end example
+
+
+
+
 @opencatbox
 @category{Evaluation} @category{Operators}
 @closecatbox
@@ -218,26 +235,20 @@
 quote-quote changes the operator from a noun to a verb (if it is not already a verb).
 
 @c ===beg==
- at c sin (1);
- at c ''sin (1);
 @c declare (foo, noun);
 @c foo (x) := x - 1729;
 @c foo (100);
 @c ''foo (100);
 @c ===end==
 @example
-(%i1) sin (1);
-(%o1)                        sin(1)
-(%i2) ''sin (1);
-(%o2)                    0.8414709848079
-(%i3) declare (foo, noun);
-(%o3)                         done
-(%i4) foo (x) := x - 1729;
-(%o4)                 ''foo(x) := x - 1729
-(%i5) foo (100);
-(%o5)                       foo(100)
-(%i6) ''foo (100);
-(%o6)                        - 1629
+(%i1) declare (foo, noun);
+(%o1)                         done
+(%i2) foo (x) := x - 1729;
+(%o2)                 ''foo(x) := x - 1729
+(%i3) foo (100);
+(%o3)                       foo(100)
+(%i4) ''foo (100);
+(%o4)                        - 1629
 @end example
 
 The quote-quote operator is applied by the input parser;
Index: maxima/doc/info/Expressions.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/Expressions.texi,v
retrieving revision 1.64
diff -u -d -r1.64 Expressions.texi
--- maxima/doc/info/Expressions.texi	31 Mar 2009 03:38:43 -0000	1.64
+++ maxima/doc/info/Expressions.texi	5 Oct 2009 18:29:44 -0000
@@ -12,7 +12,7 @@
 @node Introduction to Expressions, Complex, Expressions, Expressions
 @section Introduction to Expressions
 
-There are a number of reserved words which cannot be used as
+There are a number of reserved words which should not be used as
 variable names.   Their use would cause a possibly cryptic syntax error.
 
 @example
Index: maxima/doc/info/Polynomials.texi
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/Polynomials.texi,v
retrieving revision 1.28
diff -u -d -r1.28 Polynomials.texi
--- maxima/doc/info/Polynomials.texi	9 Mar 2008 02:55:45 -0000	1.28
+++ maxima/doc/info/Polynomials.texi	5 Oct 2009 18:29:46 -0000
@@ -301,7 +301,7 @@
 @deffnx {Function} factor (@var{expr}, @var{p})
 Factors the expression @var{expr}, containing any number of
 variables or functions, into factors irreducible over the integers.
- at code{factor (@var{expr}, @var{p})} factors @var{expr} over the field of integers with an element
+ at code{factor (@var{expr}, @var{p})} factors @var{expr} over the field of rationals with an element
 adjoined whose minimum polynomial is @var{p}.
 
 @code{factor} uses @code{ifactors} function for factoring integers.
Index: maxima/doc/info/include-maxima.texi.in
===================================================================
RCS file: /cvsroot/maxima/maxima/doc/info/include-maxima.texi.in,v
retrieving revision 1.3
diff -u -d -r1.3 include-maxima.texi.in
--- maxima/doc/info/include-maxima.texi.in	6 Jan 2009 10:32:57 -0000	1.3
+++ maxima/doc/info/include-maxima.texi.in	5 Oct 2009 18:29:47 -0000
@@ -39,7 +39,7 @@
 @sp 10
 @comment The title is printed in a large font.
 @center @titlefont{Maxima Manual}
- at center Ver. 5.16.3
+ at center Ver. @VERSION@
 @page
 @vskip 0pt plus 1filll
 Maxima is a computer algebra system, implemented in Lisp.
@@ -187,6 +187,10 @@
 
 * Introduction to Maxima::
 
+Bugs 
+
+* Bug Detection and Reporting::
+
 Help
 
 * Lisp and Maxima::