From 201f2fe573789e98dbcbd1c66036b9f3835f259e Mon Sep 17 00:00:00 2001
From: John Baldwin <jhb@FreeBSD.org>
Date: Wed, 5 Jul 2017 15:23:30 +0000
Subject: [PATCH] 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).

Reviewed by:	emaste
MFC after:	3 days
Differential Revision:	https://reviews.freebsd.org/D11477
---
 gnu/usr.bin/gdb/gdb/gdb.1   |  5 +++++
 gnu/usr.bin/gdb/kgdb/kgdb.1 | 12 +++++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/gnu/usr.bin/gdb/gdb/gdb.1 b/gnu/usr.bin/gdb/gdb/gdb.1
index ee84659ac578..635e5c311882 100644
--- a/gnu/usr.bin/gdb/gdb/gdb.1
+++ b/gnu/usr.bin/gdb/gdb/gdb.1
@@ -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
diff --git a/gnu/usr.bin/gdb/kgdb/kgdb.1 b/gnu/usr.bin/gdb/kgdb/kgdb.1
index 58d0786dbed7..8ebfbf55ce9f 100644
--- a/gnu/usr.bin/gdb/kgdb/kgdb.1
+++ b/gnu/usr.bin/gdb/kgdb/kgdb.1
@@ -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