added log and exp, and adjusted complex page

Author: vlazzarini

docs/math/complex.md

@@ -12,16 +12,28 @@ For Complex and Complex[] types, the following functions are supported
 * [arg](../opcodes/arg.md) - argument 
 * [complex](../opcodes/complex.md) - rectangular conversion 
 * [conj](../opcodes/conj.md) - conjugation
+* [exp](../opcodes/exp.md) - argument 
 * [imag](../opcodes/imag.md) - imaginary part
+* [log](../opcodes/log.md) - logarithm 
 * [polar](../opcodes/polar.md) - polar conversion
 * [real](../opcodes/real.md) - real part
 
+A complex number can be created using the `complex` function/cast (for
+scalars or vector arrays)
+
+``` csound-orc
+complex(real:{k},imag:{k})
+```
+
+
 Assignment and initialisation are also supported with comma-separated arguments for
 both real and imaginary parts respectively, 
 
 ``` csound-orc
-var:Complex = real:{k,i}, imag:{k,i}
+var:Complex = real:{k}, imag:{k}
 ```
 
-
+Generally, operations resulting in Complex types run at both at init
+and perf-time. Operations consuming Complex types run at either init,
+perf, or init and perf, depending on the output type.
 

docs/opcodes/complex.md

@@ -3,19 +3,26 @@ id:complex
 category:Mathematical Operations:Mathematical Functions
 -->
 # conj
-Returns a complex number in rectangular format.
+Returns a complex number, optionally in polar form.
 
 
 ## Syntax
 ``` csound-orc
 complex(var:Complex)
 complex(var:Complex[])
+complex(arg1:k, arg2:k[,isPolar:i])
+complex(real:k[], imag:k[])
+complex(real:a, imag:a)
 ```
 
-where the argument within the parentheses may be an expression. 
 A complex number or a complex array is given as the result of this
-function.
+function. For the k-var version, it is possible to return a polar 
+complex number by setting the optional argument to 1, and the two
+arguments are interpreted as magnitude and angle. 
 
+The other opcode overloads all return in rectangular form, so the opcode can
+be used as a polar-to-rectangular converter. The array and a-sig
+versions return a Complex vector.
 
 
 ## See also

docs/opcodes/exp.md

@@ -7,8 +7,8 @@ Returns e raised to the xth power.
 
 ## Syntax
 ``` csound-orc
-exp(x) (no rate restriction)
-exp(k/i[]) (k- or i-arrays)
+exp({a,k,i,Complex})
+exp({k[],i[],Complex[]})
 ```
 
 where the argument within the parentheses may be an expression. Value converters perform arithmetic translation from units of one kind to units of another. The result can then be a term in a further expression.

docs/opcodes/log.md

@@ -11,8 +11,8 @@ The argument value is restricted for _log_, [log10](../opcodes/log10.md), and [s
 
 ## Syntax
 ``` csound-orc
-log(x) (no rate restriction)
-log(k/i[]) (k- or i-arrays )
+log({a,k,i,Complex}) 
+log({k[],i[],Complex[]}) 
 kout[] log kin[], ibas
 ```