From c3f58005d92e5ac189e7dcb2d6d868ed5a0f27fa Mon Sep 17 00:00:00 2001
From: Dmitry Chagin <dchagin@FreeBSD.org>
Date: Fri, 14 Jul 2023 00:15:47 +0300
Subject: [PATCH] signal: Remove gsignal references from manuals
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Reported by:		Mina Galić, mhorne
Reviewed by:		Mina Galić, mhorne
Differential Revision:	https://reviews.freebsd.org/D41020
MFC after:		1 week
---
 ObsoleteFiles.inc        |  3 +++
 share/man/man9/Makefile  |  3 +--
 share/man/man9/psignal.9 | 23 +----------------------
 share/man/man9/signal.9  |  3 +--
 4 files changed, 6 insertions(+), 26 deletions(-)

diff --git a/ObsoleteFiles.inc b/ObsoleteFiles.inc
index bde97dfecb5..c2f629133fd 100644
--- a/ObsoleteFiles.inc
+++ b/ObsoleteFiles.inc
@@ -52,6 +52,9 @@
 #   xargs -n1 | sort | uniq -d;
 # done
 
+# 20230714: gsignal
+OLD_FILES+=/usr/share/man/man9/gsignal.9.gz
+
 # 20230626: Only install sys/dev/nvme/nvme.h to /usr/include
 OLD_FILES+=usr/include/dev/nvme/nvme_private.h
 
diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index 45f9ec9b051..ab373e22b18 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -1829,8 +1829,7 @@ MLINKS+=prng.9 prng32.9 \
 	prng.9 prng64_bounded.9
 MLINKS+=proc_rwmem.9 proc_readmem.9 \
 	proc_rwmem.9 proc_writemem.9
-MLINKS+=psignal.9 gsignal.9 \
-	psignal.9 pgsignal.9 \
+MLINKS+=psignal.9 pgsignal.9 \
 	psignal.9 tdsignal.9
 MLINKS+=pwmbus.9 pwm.9
 MLINKS+=random.9 arc4rand.9 \
diff --git a/share/man/man9/psignal.9 b/share/man/man9/psignal.9
index aa170322e7c..936f47f930e 100644
--- a/share/man/man9/psignal.9
+++ b/share/man/man9/psignal.9
@@ -28,14 +28,13 @@
 .\"	$NetBSD: psignal.9,v 1.1 1996/06/22 22:57:35 pk Exp $
 .\" $FreeBSD$
 .\"
-.Dd October 8, 2011
+.Dd July 14, 2023
 .Dt PSIGNAL 9
 .Os
 .Sh NAME
 .Nm psignal ,
 .Nm kern_psignal ,
 .Nm pgsignal ,
-.Nm gsignal ,
 .Nm tdsignal
 .Nd post signal to a thread, process, or process group
 .Sh SYNOPSIS
@@ -46,8 +45,6 @@
 .Ft void
 .Fn pgsignal "struct pgrp *pgrp" "int signum" "int checkctty"
 .Ft void
-.Fn gsignal "int pgid" "int signum"
-.Ft void
 .Fn tdsignal "struct thread *td" "int signum"
 .Sh DESCRIPTION
 These functions post a signal to a thread or one or more processes.
@@ -129,24 +126,6 @@ is
 no action is taken.
 .Pp
 The
-.Fn gsignal
-function posts signal number
-.Fa signum
-to each member of the process group identified by the group id
-.Fa pgid .
-.Fn gsignal
-first finds the group structure associated with
-.Fa pgid ,
-then invokes
-.Fn pgsignal
-with the argument
-.Fa checkctty
-set to zero.
-If
-.Fa pgid
-is zero no action is taken.
-.Pp
-The
 .Fn tdsignal
 function posts signal number
 .Fa signum
diff --git a/share/man/man9/signal.9 b/share/man/man9/signal.9
index a2e54fef012..d6906f359c1 100644
--- a/share/man/man9/signal.9
+++ b/share/man/man9/signal.9
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 8, 2013
+.Dd July 14, 2023
 .Dt SIGNAL 9
 .Os
 .Sh NAME
@@ -430,7 +430,6 @@ function returns either a valid signal number or zero.
 .Fn issignal
 returns either a valid signal number or zero.
 .Sh SEE ALSO
-.Xr gsignal 9 ,
 .Xr pgsignal 9 ,
 .Xr psignal 9
 .Sh AUTHORS