From 7223eb8917de4135a3c87e40a3bf09067bf1ed89 Mon Sep 17 00:00:00 2001
From: jca <jca@openbsd.org>
Date: Thu, 26 Feb 2026 17:41:19 +0000
Subject: [PATCH] Add hints regarding colors etc used by default in recent GDB
 releases

so that we can just answer "check the readme" when asked about it. :)
---
 devel/gdb/Makefile   |  1 +
 devel/gdb/pkg/PLIST  |  1 +
 devel/gdb/pkg/README | 15 +++++++++++++++
 3 files changed, 17 insertions(+)
 create mode 100644 devel/gdb/pkg/README

diff --git a/devel/gdb/Makefile b/devel/gdb/Makefile
index f290da17021..dc9e341b087 100644
--- a/devel/gdb/Makefile
+++ b/devel/gdb/Makefile
@@ -5,6 +5,7 @@ COMMENT=	GNU debugger
 CATEGORIES=	devel
 
 DISTNAME=	gdb-17.1
+REVISION=	0
 
 HOMEPAGE=	https://www.gnu.org/software/gdb/
 
diff --git a/devel/gdb/pkg/PLIST b/devel/gdb/pkg/PLIST
index d2bdd51deab..4c6cada5e6a 100644
--- a/devel/gdb/pkg/PLIST
+++ b/devel/gdb/pkg/PLIST
@@ -13,6 +13,7 @@ include/gdb/jit-reader.h
 @man man/man1/egdb.1
 @man man/man1/egdbserver.1
 @man man/man5/egdbinit.5
+share/doc/pkg-readmes/${PKGSTEM}
 share/gdb/python/
 share/gdb/python/gdb/
 share/gdb/python/gdb/FrameDecorator.py
diff --git a/devel/gdb/pkg/README b/devel/gdb/pkg/README
new file mode 100644
index 00000000000..b3114067fce
--- /dev/null
+++ b/devel/gdb/pkg/README
@@ -0,0 +1,15 @@
++-------------------------------------------------------------------------------
+| Running ${PKGSTEM} on OpenBSD
++-------------------------------------------------------------------------------
+
+Colors and emoji characters
+===========================
+
+A common question with recent GDB releases is how to disable the use of
+colors and emoji.  To disable both, set
+
+  set style enabled off
+
+in your ~/.gdbinit or export NO_COLOR=1 in your environment (may also
+affect other software).  See "Output Styling" in the info file for
+more fine-grained settings.