MathGroup Archive 2008

[Date Index] [Thread Index] [Author Index]

Search the Archive

Re: Re: Inequality not documented in 6.0

  • To: mathgroup at
  • Subject: [mg90081] Re: [mg90065] Re: Inequality not documented in 6.0
  • From: Jack L Goldberg 1 <jackgold at>
  • Date: Sat, 28 Jun 2008 05:52:26 -0400 (EDT)
  • References: <>

I beg to disagree.  One place where a beginner could run into trouble 
is pattern matching. I did and I did so precisely on this issue.  
Moreover, I fully disagree with the judgment that the documentation is 
adequate. In my opinion it is far from adequate, it is basically 
non-existent in the sense that most people using Mathematica would 
accept as "adequate" documentation. This is my opinion of course, but 
I want to add again that I ran into this issue and puzzled over it for 
far too long.

Quoting Bill Rowe <readnews at>:

> On 6/26/08 at 5:34 PM, drmajorbob at (DrMajorBob) wrote:
>>> I suppose you aren't counting the description returned by
>>> evaluating,
>>> ?Inequaltity
>> The result of that is:
>> "Inequality represents a sequence of relational statements."
>> Personally, I do NOT count that as documentation,
> =46ine. I don't care to argue this specific point
>> There's not even a "More" button.
> Right. And I believe there is a reason for this fact.
>> How would one type ?Inequality in the first place, if one didn't
>> already know it existed, with precisely that name?
> Better question. Why would you want to do that except as an
> attempt to learn about what is returned by
> FullForm[x>y>=z>a]
> If you think about the documentation for Greater, GreaterEqual
> etc., it makes sense for these to have heads identical to the
> symbol and a separate page since they can take an arbitrary
> number of arguments, i.e., x>y or x>y>z or x>y>z>a etc.
> But this scheme makes no allowance for something like x>y>=z>a.
> Clearly, something more is needed to allow for this possibility.
> But I think it is equally clear the sequence of inequalities is
> far more natural to enter as x>y>=z>a than Inequality[x > y, y
>  >= z, z > a]. Using FullForm it is easy to verify both are the
> same. So, given the far more natural entry possible, what need
> is there for more documentation than what is returned by ?Inequality
>> And how does a newbie know that?
> I would not expect a newbie to know that. In fact, I would not
> be surprised many experienced Mathematica users would think to
> type in ?Inequality without first having seen Inequality in an
> expression they were examining by using FullForm. But I do think
> the documentation that does exist is adequate in this particular
> case for the reasons given above.
> I am not suggesting I think Mathematica documentation is
> complete, clear and cannot be improved. I do think this is not
> an example of an instance where the documentation is incomplete,
> unclear or needs improvement.

  • Prev by Date: Re: Re: Re: font size too small
  • Next by Date: Re: Re: Inequality not documented in 6.0
  • Previous by thread: Re: Inequality not documented in 6.0
  • Next by thread: Re: Re: Inequality not documented in 6.0