Doc: make python function/method descriptions look as in Python

[Matt Rice]

On Sat, Sep 3, 2011 at 3:27 AM, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: <Paul_Koning@Dell.com>
>> Date: Thu, 1 Sep 2011 15:52:59 -0500
>>
>> I found the descriptions of the Python methods/functions hard to read because they are not shown in Python syntax.
>
> I have no opinion on whether this is desirable or not; I will go with
> whatever others think.  Python is a read-only language for me.

I too find the existing method syntax awkward, and prefer it with all
the parens/brackets