Date: Thu, 23 Dec 2004 01:36:50 +0000 From: Joseph Koshy <joseph.koshy@gmail.com> To: Giorgos Keramidas <keramida@freebsd.org> Cc: ru@freebsd.org Subject: Re: docs/72375: prototype error in signal(3) Message-ID: <84dead72041222173625cff66a@mail.gmail.com> In-Reply-To: <200412230039.iBN0dnX2055476@freefall.freebsd.org> References: <200412230039.iBN0dnX2055476@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Ruslan had a better fix (attached).
(nemesis) $ cvs diff -u signal.3
/usr/src.cvs/lib/libc/gen
Index: signal.3
===================================================================
RCS file: /cvs/FreeBSD/src/lib/libc/gen/signal.3,v
retrieving revision 1.38
diff -u -u -r1.38 signal.3
--- signal.3 3 Jul 2004 22:30:08 -0000 1.38
+++ signal.3 23 Dec 2004 07:13:28 -0000
@@ -42,16 +42,24 @@
.Lb libc
.Sh SYNOPSIS
.In signal.h
-.\" The following is Quite Ugly, but syntactically correct.
-.\" Don't try to
-.\" fix it.
-.Ft void \*(lp*
-.Fn signal "int sig" "void \*(lp*func\*(rp\*(lpint\*(rp\*(rp\*(rp\*(lpint"
+.\" XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX
+.\" The prototype for signal(3) cannot be cleanly marked up in -mdoc
+.\" without the following lower-level tweak.
+.nr in-synopsis-section 0
+.Pp
+.Ft "void \*(lp*" Ns
+.Fo signal
+.Fa "int sig"
+.Fa "void \*(lp*func\*(rp\*(lpint\*(rp"
+.Fc Ns
+.Ft "\*(rp\*(lpint\*(rp" ;
.Pp
+.nr in-synopsis-section 1
+.\" XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX
or in
-.Fx Ns 's
+.Fx Ap s
equivalent but easier to read typedef'd version:
-.Ft typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp" ;
+.Vt typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp" ;
.Ft sig_t
.Fn signal "int sig" "sig_t func"
.Sh DESCRIPTION
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?84dead72041222173625cff66a>