This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH 9/9] Document "target:" sysroot changes


> From: Gary Benson <gbenson@redhat.com>
> Date: Fri, 20 Mar 2015 16:48:07 +0000
> 
> This commit documents the newly added "target:" sysroot feature.

Thanks.

> --- a/gdb/NEWS
> +++ b/gdb/NEWS
> @@ -7,6 +7,11 @@
>    present in the debug info.  This typically includes the compiler version
>    and may include things like its command line arguments.
>  
> +* Paths supplied to the "set sysroot" commands may be prefixed with
> +  "target:" to tell GDB to access shared libraries from the target
> +  system, be it local or remote.  This replaces the prefix "remote:".
> +  The default sysroot has been changed from "" to "target:".

The Gnu Coding Standards frown on using "path" for anything but
PATH-style directory lists.  Please use "directory name" instead.

> +root prefix on the remote file system.  If @var{path} starts with the
> +sequence @file{remote:} this will be converted to the sequence
> +@file{target:} by @code{set sysroot}. @footnote{Historically the

The @footnote should be before the period, and without any whitespace
before it.

> +functionality to retrieve binaries from the remote system was
> +provided by prefixing @var{path} with @file{remote:}} @footnote{If you
> +want to specify a local system root using a directory that happens to
> +be named @file{target:} or @file{remote:}, you need to use some
> +equivalent variant of the name like @file{./target:}.}

The second footnote should not be a footnote, as it is an important
part of the description.

Thanks.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]