From owner-freebsd-doc@FreeBSD.ORG  Thu Dec 23 01:36:53 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 09B8716A4D0
	for <freebsd-doc@freebsd.org>; Thu, 23 Dec 2004 01:36:53 +0000 (GMT)
Received: from rproxy.gmail.com (rproxy.gmail.com [64.233.170.193])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D797943D55
	for <freebsd-doc@freebsd.org>; Thu, 23 Dec 2004 01:36:51 +0000 (GMT)
	(envelope-from joseph.koshy@gmail.com)
Received: by rproxy.gmail.com with SMTP id y7so51936rne
        for <freebsd-doc@freebsd.org>; Wed, 22 Dec 2004 17:36:50 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
	s=beta; d=gmail.com;
	h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:references;
	b=Qylgkbr1Vw5kLP4rmXJaHLGEbRlOjwnwlx6Sjx7o/Ic5LRizVJ/oFKWKp9ZNn30x7x8YIur9lxVGtxqydm/vR6iqf531AhHe6PYEDx83xwY85XO0SVDN3gU8XxXlZknuge01UtHgS45TdS+0OyFi6p3JD6f7ZH2HjAsEsjT4ENw=
Received: by 10.38.15.33 with SMTP id 33mr20544rno;
        Wed, 22 Dec 2004 17:36:50 -0800 (PST)
Received: by 10.38.209.11 with HTTP; Wed, 22 Dec 2004 17:36:50 -0800 (PST)
Message-ID: <84dead72041222173625cff66a@mail.gmail.com>
Date: Thu, 23 Dec 2004 01:36:50 +0000
From: Joseph Koshy <joseph.koshy@gmail.com>
To: Giorgos Keramidas <keramida@freebsd.org>
In-Reply-To: <200412230039.iBN0dnX2055476@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
References: <200412230039.iBN0dnX2055476@freefall.freebsd.org>
cc: freebsd-doc@freebsd.org
cc: freebsd-gnats-submit@freebsd.org
cc: ru@freebsd.org
Subject: Re: docs/72375: prototype error in signal(3)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Joseph Koshy <joseph.koshy@gmail.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 23 Dec 2004 01:36:53 -0000

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