svn commit: r320824 - in stable: 10/gnu/usr.bin/gdb/gdb 10/gnu/usr.bin/gdb/kgdb 11/gnu/usr.bin/gdb/gdb 11/gnu/usr.bin/gdb/kgdb

[Rodney W. Grimes]

> Author: jhb
> Date: Sun Jul  9 04:13:33 2017
> New Revision: 320824
> URL: https://svnweb.freebsd.org/changeset/base/320824
> 
> Log:
>   MFC 320675: Add deprecation notices for gdb and kgdb.
>   
>   Even though gdb and kgdb may not be removed for 12.0 on some architectures,
>   the notice is unconditional as these tools will likely be removed at some
>   point in the future when adequate replacements are available (gdb in ports
>   or lldb in base).

Thanks for doing this, but we are still falling slightly short of 17.4 on
deprecation on the aspect of "Use of the deprecated feature generates a warning".

> Modified:
>   stable/10/gnu/usr.bin/gdb/gdb/gdb.1
>   stable/10/gnu/usr.bin/gdb/kgdb/kgdb.1
> Directory Properties:
>   stable/10/   (props changed)
> 
> Changes in other areas also in this revision:
> Modified:
>   stable/11/gnu/usr.bin/gdb/gdb/gdb.1
>   stable/11/gnu/usr.bin/gdb/kgdb/kgdb.1
> Directory Properties:
>   stable/11/   (props changed)
> 
> Modified: stable/10/gnu/usr.bin/gdb/gdb/gdb.1
> ==============================================================================
> --- stable/10/gnu/usr.bin/gdb/gdb/gdb.1	Sun Jul  9 03:57:24 2017	(r320823)
> +++ stable/10/gnu/usr.bin/gdb/gdb/gdb.1	Sun Jul  9 04:13:33 2017	(r320824)
> @@ -44,6 +44,11 @@ gdb \- The GNU Debugger
>  .IR core \||\| procID\c
>  \&\|]\&\|]
>  .ad b
> +.SH DEPRECATION NOTICE
> +This version of gdb is deprecated and will be removed from future versions
> +of the FreeBSD base system.
> +A newer version of gdb is available from ports or packages
> +(devel/gdb).
>  .SH DESCRIPTION
>  The purpose of a debugger such as GDB is to allow you to see what is
>  going on ``inside'' another program while it executes\(em\&or what another
> 
> Modified: stable/10/gnu/usr.bin/gdb/kgdb/kgdb.1
> ==============================================================================
> --- stable/10/gnu/usr.bin/gdb/kgdb/kgdb.1	Sun Jul  9 03:57:24 2017	(r320823)
> +++ stable/10/gnu/usr.bin/gdb/kgdb/kgdb.1	Sun Jul  9 04:13:33 2017	(r320824)
> @@ -24,7 +24,7 @@
>  .\"
>  .\" $FreeBSD$
>  .\"
> -.Dd October 11, 2006
> +.Dd July 5, 2017
>  .Dt KGDB 1
>  .Os
>  .Sh NAME
> @@ -40,6 +40,16 @@
>  .Op Fl d Ar crashdir
>  .Op Fl c Ar core | Fl n Ar dumpnr | Fl r Ar device
>  .Op Ar kernel Op Ar core
> +.Sh DEPRECATION NOTICE
> +This version of
> +.Nm
> +is deprecated and will be removed from future versions of the
> +.Fx
> +base system.
> +A newer version of
> +.Nm
> +is available from ports or packages
> +(devel/gdb).
>  .Sh DESCRIPTION
>  The
>  .Nm
> 
> 

-- 
Rod Grimes                                                 rgrimes at freebsd.org