On 03/02/2017 10:57 PM, Ashutosh Ahelleya wrote:
> Hello,
>
> I am interested in solving the documentation error having ticket number
> #29146 but I have a doubt.
>
> In the description of ticket number #29146
> <
https://trac.sagemath.org/ticket/21946> , I feel within the domain of x
> that is a real number the documentation is correct since the solution is
> shown up to be
> "r1" which is a real number. In case the domain is over complex numbers
> too, what should be the appropriate symbol in place of "r1" to be used to
> fix this?
>
The symbol "z" is used for integers already, so that's out. I wonder if
any of our equation-solving backends ever return complex parameters...
on the other hand, the Maxima documentation doesn't say they're real:
The symbols %r are used to denote arbitrary constants in a solution[1].
So maybe it was an overstatement to say that the "r" parameters are
real, as far as Maxima is concerned. In any case, there is a special
branch in the code that handles the result of x == x,
if s == 'all':
if solution_dict:
ans = [ {x: self.parent().var('r1')} ]
else:
ans = [x == self.parent().var('r1')]
if multiplicities:
return ans,[]
else:
return ans
So you could update the documentation to say that the "r" parameters are
complex, or I guess you could try to add a new type of complex
parameter. If none of our backends ever return them, though, the latter
seems like overkill.
[1]
http://maxima.sourceforge.net/docs/manual/maxima_20.html