Re: [PATCH 3/3] Target remote mode fork and exec docs

[Eli Zaretskii <eliz@gnu.org>]

> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
> From: Don Breazeal <donb@codesourcery.com>
> Date: Thu, 12 Nov 2015 17:12:55 -0800
> 
> >> +In @code{target extended-remote} mode, you can also attach using the
> >> +@value{GDBN} attach command
> >> +(@pxref{Types of Remote Connections: Attaching}).
> > 
> > I don't understand this @pxref -- there's no such node or anchor in
> > the text.  Does this work for you?  (Also, using a colon in
> > cross-reference or node names is a bad idea, as that confuses Info
> > readers.)
> 
> These last two I had fixed in my sandbox but apparently the fixes didn't
> make it into the patch I posted, sorry about that. :-S
> 
> Regarding the @pxrefs that had colons in them, I have a question.  I was
> making a cross-reference into the middle of a section, so
> there is no section heading to use as the name of the reference.  I was
> trying to refer to "The part about Attaching that is in the section
> 'Types of Remote Connections'".  How about:
> 
> @anchor{Attaching in Types of Remote Connections}

That's one possibility, yes.  Another is to use @pxref with 2
arguments (see the Texinfo manual for the details), with the 2nd
argument being some phrase that begins the part of the text to which
you want to jump.  Unfortunately, the second alternative is only
supported by some Info readers, not all of them.

Thanks.