[1/1] doc: update link to Oracle DTrace project

Message ID 20231219144500.19442-2-eduard.sargsyan@intel.com
State New
Headers
Series The link to DTrace needs to be updated |

Checks

Context Check Description
linaro-tcwg-bot/tcwg_gdb_build--master-aarch64 success Testing passed
linaro-tcwg-bot/tcwg_gdb_build--master-arm success Testing passed
linaro-tcwg-bot/tcwg_gdb_check--master-arm success Testing passed
linaro-tcwg-bot/tcwg_gdb_check--master-aarch64 success Testing passed

Commit Message

Sargsyan, Eduard Dec. 19, 2023, 2:45 p.m. UTC
  ---
 gdb/doc/gdb.texinfo | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
  

Comments

Eli Zaretskii Dec. 20, 2023, 11:58 a.m. UTC | #1
> From: Eduard Sargsyan <eduard.sargsyan@intel.com>
> Date: Tue, 19 Dec 2023 14:45:00 +0000
> 
> ---
>  gdb/doc/gdb.texinfo | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
> index 7a5d357b99b..d69c733c723 100644
> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -6141,7 +6141,7 @@ from assembly, C and C@t{++} languages@footnote{See
>  @uref{http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation}
>  for a good reference on how the @acronym{SDT} probes are implemented.}.  
>  
> -@item @code{DTrace} (@uref{http://oss.oracle.com/projects/DTrace})
> +@item @code{DTrace} (@uref{https://docs.oracle.com/en/operating-systems/oracle-linux/dtrace-guide/})
>  @acronym{USDT} probes.  @code{DTrace} probes are usable from C and
>  C@t{++} languages.
>  @end itemize

Thanks, but I wonder whether there are sites that document this but
are not related to specific commercial entities.
  
Sargsyan, Eduard Dec. 20, 2023, 12:01 p.m. UTC | #2
I'm not aware of such. But I believe the new link and old one are "similar" and referring to the same page. Isn't it?

-----Original Message-----
From: Eli Zaretskii <eliz@gnu.org> 
Sent: Wednesday, December 20, 2023 12:58 PM
To: Sargsyan, Eduard <eduard.sargsyan@intel.com>
Cc: gdb-patches@sourceware.org
Subject: Re: [PATCH 1/1] doc: update link to Oracle DTrace project

> From: Eduard Sargsyan <eduard.sargsyan@intel.com>
> Date: Tue, 19 Dec 2023 14:45:00 +0000
> 
> ---
>  gdb/doc/gdb.texinfo | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 
> 7a5d357b99b..d69c733c723 100644
> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -6141,7 +6141,7 @@ from assembly, C and C@t{++} 
> languages@footnote{See  
> @uref{http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementatio
> n}  for a good reference on how the @acronym{SDT} probes are 
> implemented.}.
>  
> -@item @code{DTrace} (@uref{http://oss.oracle.com/projects/DTrace})
> +@item @code{DTrace} 
> +(@uref{https://docs.oracle.com/en/operating-systems/oracle-linux/dtra
> +ce-guide/})
>  @acronym{USDT} probes.  @code{DTrace} probes are usable from C and  
> C@t{++} languages.
>  @end itemize

Thanks, but I wonder whether there are sites that document this but are not related to specific commercial entities.
Intel Deutschland GmbH
Registered Address: Am Campeon 10, 85579 Neubiberg, Germany
Tel: +49 89 99 8853-0, www.intel.de <http://www.intel.de>
Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva  
Chairperson of the Supervisory Board: Nicole Lau
Registered Office: Munich
Commercial Register: Amtsgericht Muenchen HRB 186928
  
Eli Zaretskii Dec. 20, 2023, 1:24 p.m. UTC | #3
> From: "Sargsyan, Eduard" <eduard.sargsyan@intel.com>
> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
> Date: Wed, 20 Dec 2023 12:01:22 +0000
> 
> I'm not aware of such. But I believe the new link and old one are "similar" and referring to the same page. Isn't it?

I get 404 for the old one.

Isn't this page describing the same stuff:

  https://en.wikipedia.org/wiki/DTrace
  
Sargsyan, Eduard Dec. 20, 2023, 1:29 p.m. UTC | #4
Yeah, that's why I made this change. The latest "old" version I've found is here: https://web.archive.org/web/20210702172846/https://oss.oracle.com/projects/DTrace/

-----Original Message-----
From: Eli Zaretskii <eliz@gnu.org> 
Sent: Wednesday, December 20, 2023 2:25 PM
To: Sargsyan, Eduard <eduard.sargsyan@intel.com>
Cc: gdb-patches@sourceware.org
Subject: Re: [PATCH 1/1] doc: update link to Oracle DTrace project

> From: "Sargsyan, Eduard" <eduard.sargsyan@intel.com>
> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
> Date: Wed, 20 Dec 2023 12:01:22 +0000
> 
> I'm not aware of such. But I believe the new link and old one are "similar" and referring to the same page. Isn't it?

I get 404 for the old one.

Isn't this page describing the same stuff:

  https://en.wikipedia.org/wiki/DTrace
Intel Deutschland GmbH
Registered Address: Am Campeon 10, 85579 Neubiberg, Germany
Tel: +49 89 99 8853-0, www.intel.de <http://www.intel.de>
Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva  
Chairperson of the Supervisory Board: Nicole Lau
Registered Office: Munich
Commercial Register: Amtsgericht Muenchen HRB 186928
  
Sargsyan, Eduard Jan. 18, 2024, 11:14 a.m. UTC | #5
So should we use link from Wikipedia? If we want to be just replace old link, to the "same page" we probably need to use the link I have in the patch, but if we want to stay as far away from brands/commercial entities, then probably link to the Wikipedia is better. But in the second case, document reader will need to go to Wikipedia, then follow to links on the Wikipedia page.
Or as an option we can directly use link from Wikipedia: https://dtrace.org/about/
Which approach you find more desirable?

-----Original Message-----
> From: "Eli Zaretskii" <eliz@gnu.org> 
> Date: Wednesday, December 20, 2023 2:25 PM
> Cc: gdb-patches@sourceware.org
> 
> I get 404 for the old one.
>
> Isn't this page describing the same stuff:
>
>  https://en.wikipedia.org/wiki/DTrace
Intel Deutschland GmbH
Registered Address: Am Campeon 10, 85579 Neubiberg, Germany
Tel: +49 89 99 8853-0, www.intel.de <http://www.intel.de>
Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva  
Chairperson of the Supervisory Board: Nicole Lau
Registered Office: Munich
Commercial Register: Amtsgericht Muenchen HRB 186928
  
Eli Zaretskii Jan. 18, 2024, 12:23 p.m. UTC | #6
> From: "Sargsyan, Eduard" <eduard.sargsyan@intel.com>
> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
> Date: Thu, 18 Jan 2024 11:14:53 +0000
> 
> So should we use link from Wikipedia? If we want to be just replace old link, to the "same page" we probably need to use the link I have in the patch, but if we want to stay as far away from brands/commercial entities, then probably link to the Wikipedia is better. But in the second case, document reader will need to go to Wikipedia, then follow to links on the Wikipedia page.
> Or as an option we can directly use link from Wikipedia: https://dtrace.org/about/
> Which approach you find more desirable?

I prefer to link to Wikipedia, since that is unlikely to go away.  But
let's hear what others here think about this.
  
Elena Zannoni Jan. 19, 2024, 4:51 p.m. UTC | #7
On 1/18/24 05:23, Eli Zaretskii wrote:
>> From: "Sargsyan, Eduard" <eduard.sargsyan@intel.com>
>> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
>> Date: Thu, 18 Jan 2024 11:14:53 +0000
>>
>> So should we use link from Wikipedia? If we want to be just replace old link, to the "same page" we probably need to use the link I have in the patch, but if we want to stay as far away from brands/commercial entities, then probably link to the Wikipedia is better. But in the second case, document reader will need to go to Wikipedia, then follow to links on the Wikipedia page.
>> Or as an option we can directly use link from Wikipedia: https://dtrace.org/about/
>> Which approach you find more desirable?
> 
> I prefer to link to Wikipedia, since that is unlikely to go away.  But
> let's hear what others here think about this.

Hi Eli, Eduard,

The docs are indeed on the docs.oracle.com website.

Dtrace.org is not the dtrace for linux work we are doing.

We have a github repo which contains the active development and a
readme.md which explains how to get the various pieces, etc, not sure if
that's is more acceptable: https://github.com/oracle/dtrace-utils

The wikipedia page is pointing to a different CDDL version of dtrace,
which seems to not be in active development.

thanks
elena
  

Patch

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 7a5d357b99b..d69c733c723 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -6141,7 +6141,7 @@  from assembly, C and C@t{++} languages@footnote{See
 @uref{http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation}
 for a good reference on how the @acronym{SDT} probes are implemented.}.  
 
-@item @code{DTrace} (@uref{http://oss.oracle.com/projects/DTrace})
+@item @code{DTrace} (@uref{https://docs.oracle.com/en/operating-systems/oracle-linux/dtrace-guide/})
 @acronym{USDT} probes.  @code{DTrace} probes are usable from C and
 C@t{++} languages.
 @end itemize