From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28724 invoked by alias); 6 Sep 2011 20:07:03 -0000 Received: (qmail 28713 invoked by uid 22791); 6 Sep 2011 20:07:01 -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 ausc60pc101.us.dell.com (HELO ausc60pc101.us.dell.com) (143.166.85.206) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 06 Sep 2011 20:06:48 +0000 X-Loopcount0: from 10.170.28.41 From: To: CC: , Date: Tue, 06 Sep 2011 20:25:00 -0000 Subject: RE: Doc: make python function/method descriptions look as in Python Message-ID: <09787EF419216C41A903FD14EE5506DD0153491B04@AUSX7MCPC103.AMER.DELL.COM> References: <09787EF419216C41A903FD14EE5506DD015343BFAE@AUSX7MCPC103.AMER.DELL.COM> <837h5p2a6g.fsf@gnu.org> <09787EF419216C41A903FD14EE5506DD01534911A3@AUSX7MCPC103.AMER.DELL.COM> <09787EF419216C41A903FD14EE5506DD01534916A6@AUSX7MCPC103.AMER.DELL.COM> <09787EF419216C41A903FD14EE5506DD0153491A82@AUSX7MCPC103.AMER.DELL.COM> <8362l5jvao.fsf@gnu.org> In-Reply-To: <8362l5jvao.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/msg00099.txt.bz2 >> I spotted one problem. Changing the description of gdb.prompt_hook from= a defop to a defun made the xref{prompt_hook} not work. Either that or i= t was broken already. I made it xref{gdb.prompt_hook} but that produces an= error when I click on that cross-reference. What's the texinfo magic to = define what xref points to? >That magic is @anchor, but you broke it because you changed the name of th= e anchor, which you shouldn't: > >> -@defop Operation {@value{GDBN}} prompt_hook current_prompt=20 >> -@anchor{prompt_hook} >> +@defun gdb.prompt_hook (current_prompt) @anchor{gdb.prompt_hook} > >You shouldn't change the @anchor line at all, because its label has nothin= g to do with the method name. It's just a label, is not visible to the rea= der, and it _must_ match the label inside @xref. You cannot change one wit= hout changing the other to match. I changed both -- that way the cross-reference appears as "Note: gdb.promp_= hook" or "See gdb.prompt_hook". paul