Documentation updated

docs/pyerrors/special.html

@@ -3015,7 +3015,7 @@ and 2 for a 1D array of points:</p>
 <pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="n">fig</span><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">subplots</span><span class="p">()</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">x</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linspace</span><span class="p">(</span><span class="o">-</span><span class="mf">5.</span><span class="p">,</span> <span class="mf">5.</span><span class="p">,</span> <span class="mi">1000</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">4</span><span class="p">):</span>
-<span class="gp">... </span>    <span class="n">ax</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">ive</span><span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">x</span><span class="p">),</span> <span class="n">label</span><span class="o">=</span><span class="sa">f</span><span class="s1">&#39;$I_</span><span class="si">{</span><span class="n">i</span><span class="si">!r}</span><span class="s1">(z)\cdot e^</span><span class="se">{{</span><span class="s1">-|z|</span><span class="se">}}</span><span class="s1">$&#39;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="n">ax</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">ive</span><span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">x</span><span class="p">),</span> <span class="n">label</span><span class="o">=</span><span class="sa">fr</span><span class="s1">&#39;$I_</span><span class="si">{</span><span class="n">i</span><span class="si">!r}</span><span class="s1">(z)\cdot e^</span><span class="se">{{</span><span class="s1">-|z|</span><span class="se">}}</span><span class="s1">$&#39;</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">ax</span><span class="o">.</span><span class="n">legend</span><span class="p">()</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">ax</span><span class="o">.</span><span class="n">set_xlabel</span><span class="p">(</span><span class="sa">r</span><span class="s2">&quot;$z$&quot;</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
@@ -3701,11 +3701,14 @@ as NaN. Default is False (no sign information).</p>
 <li><strong>res</strong> (ndarray):
 The result, <code>np.log(np.sum(np.exp(a)))</code> calculated in a numerically
 more stable way. If <code>b</code> is given then <code>np.log(np.sum(b*np.exp(a)))</code>
-is returned.</li>
+is returned. If <code>return_sign</code> is True, <code>res</code> contains the log of
+the absolute value of the argument.</li>
 <li><strong>sgn</strong> (ndarray):
-If return_sign is True, this will be an array of floating-point
-numbers matching res and +1, 0, or -1 depending on the sign
-of the result. If False, only one result is returned.</li>
+If <code>return_sign</code> is True, this will be an array of floating-point
+numbers matching res containing +1, 0, -1 (for real-valued inputs)
+or a complex phase (for complex inputs). This gives the sign of the
+argument of the logarithm in <code>res</code>.
+If <code>return_sign</code> is False, only one result is returned.</li>
 </ul>
 
 <h6 id="see-also">See Also</h6>