From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 8326 invoked by alias); 3 Sep 2011 21:53:54 -0000 Received: (qmail 8318 invoked by uid 22791); 3 Sep 2011 21:53:53 -0000 X-SWARE-Spam-Status: No, hits=-2.0 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from ausc60ps301.us.dell.com (HELO ausc60ps301.us.dell.com) (143.166.148.206) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 03 Sep 2011 21:53:40 +0000 X-Loopcount0: from 10.170.28.40 From: To: CC: Date: Sun, 04 Sep 2011 08:38:00 -0000 Subject: RE: Doc: make python function/method descriptions look as in Python Message-ID: <09787EF419216C41A903FD14EE5506DD01534911A3@AUSX7MCPC103.AMER.DELL.COM> References: <09787EF419216C41A903FD14EE5506DD015343BFAE@AUSX7MCPC103.AMER.DELL.COM> <837h5p2a6g.fsf@gnu.org> In-Reply-To: <837h5p2a6g.fsf@gnu.org> Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-09/txt/msg00055.txt.bz2 >> -@defun execute command [from_tty] [to_string] >> +@defun execute (command @r{[}, from_tty @r{[}, to_string@r{]}@r{]}) > >You can mark several `]' characters together, like this: > > @defun execute (command @r{[}, from_tty @r{[}, to_string@r{]]}) Thanks, I will use that. I'm a texinfo novice... >> +@defmethod Value string (@r{[}encoding@r{[}, errors@r{[}, >> +length@r{]}@r{]}@r{]}) > >You cannot break any of the @def* lines, they all must be a single line, e= ven if it is long (here and elsewhere). Probably my mailer linewrapping things, I'll make the proposed patch an att= achment next time, or see if I can find another mail program. >Finally, please note that the way you put the parentheses (..) in the >@def* directives, they will be typeset in slant typeface (I think). >So please make a PDF or PS output and eyeball it to make sure you like the= result. If you don't like it, you can use @r{(} and @r{)} like we do with= square brackets. I'll check that. Thanks for the hint.=20=20 paul