Documentation: "Vectorized Operators and Functions"

[lucasb-eyer]

The latest documentation doesn't match reality at all. I think this should be fixed before the 0.3 release, but I'm not sure on how to fix it myself.

This needs to be rephrased or split:

and any version of the operator may be used if one of the inputs is a scalar.

since #853 makes it false for 3. Comparison.
It's also not really true for ^, since A^2 is different from A.^2 and 2.^A works but 2^A doesn't. (I agree with what Julia does here.)

The following built-in functions are also vectorized, whereby the functions act element-wise:

max and min should probably be taken out of that list and a separate paragraph quickly explaining maximum and minimum added.
Is it intended that both minimum(A, A+2) and min(A, A+2) work? The former doesn't seem it should work reading the doc and #4235.

[JeffBezanson]

You're absolutely right.

What do you mean by A.^2 not working? It seems to work for me.

[ivarne]

Also minimum(A, A+2) will probably not do what you want, because the second parameter to minimum is called region and is used if you want the minimum value per region.

[lucasb-eyer]

Oops, typo. I meant to say 2 ^ A. Fixed it in the issue.

[jiahao]

If you really wanted to compute 2^A, you could do expm(ln(2)*A).

[lucasb-eyer]

I don't want to compute these things, just pointing out how documentation != reality. Notice that I said "I agree with what Julia does here."

[jiahao]

I'm merely suggesting a statment that could become part of the documentation fix.