The synopsis rendered very poorly because of a "Quite Ugly but

syntactically correct" roff mess. Follow the mdoc style guide on
function pointers to improve this a little. Neglect and remove a
comment that advises against trying to fix this.

guidance and ok schwarze@

1 files changed, 8 insertions, 6 deletions

diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3
index a91f37692f5..aeb0fa71299 100644
--- a/lib/libc/gen/signal.3
+++ b/lib/libc/gen/signal.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: signal.3,v 1.54 2015/10/11 09:51:26 guenther Exp $
+.\"	$OpenBSD: signal.3,v 1.55 2016/05/28 18:56:37 tb Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: October 11 2015 $
+.Dd $Mdocdate: May 28 2016 $
 .Dt SIGNAL 3
 .Os
 .Sh NAME
@@ -35,12 +35,14 @@
 .Nd simplified software signal facilities
 .Sh SYNOPSIS
 .In signal.h
-.\" The following is Quite Ugly, but syntactically correct.
-.\" Don't try to fix it.
 .Ft void
-.Fn \*(lp*signal "int sigcatch" "void \*(lp*func\*(rp\*(lpint sigraised\*(rp\*(rp\*(rp\*(lpint"
+.Fo "(*signal(int sigcatch, void (*func)(int sigraised)))"
+.Fa int
+.Fc
 .Ft void
-.Fn \*(lp*bsd_signal "int sigcatch" "void \*(lp*func\*(rp\*(lpint sigraised\*(rp\*(rp\*(rp\*(lpint"
+.Fo "(*bsd_signal(int sigcatch, void (*func)(int sigraised)))"
+.Fa int
+.Fc
 .Sh DESCRIPTION
 The
 .Fn signal