This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH 3/3] Target remote mode fork and exec docs
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Don Breazeal <donb at codesourcery dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Fri, 13 Nov 2015 10:15:42 +0200
- Subject: Re: [PATCH 3/3] Target remote mode fork and exec docs
- Authentication-results: sourceware.org; auth=none
- References: <1447290000-31393-1-git-send-email-donb at codesourcery dot com> <1447290000-31393-2-git-send-email-donb at codesourcery dot com> <83mvuji2p9 dot fsf at gnu dot org> <56453917 dot 9090801 at codesourcery dot com>
- Reply-to: Eli Zaretskii <eliz at gnu dot 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.