NetBSD Problem Report #49326

From www@NetBSD.org  Mon Oct 27 07:21:14 2014
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.netbsd.org", Issuer "Postmaster NetBSD.org" (verified OK))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 66E9BA654B
	for <gnats-bugs@gnats.NetBSD.org>; Mon, 27 Oct 2014 07:21:14 +0000 (UTC)
Message-Id: <20141027072113.42B5BA666C@mollari.NetBSD.org>
Date: Mon, 27 Oct 2014 07:21:13 +0000 (UTC)
From: henning.petersen@t-online.de
Reply-To: henning.petersen@t-online.de
To: gnats-bugs@NetBSD.org
Subject: Correct errors in man pages csf.9 , pci.9 and ucom.9
X-Send-Pr-Version: www-1.0

>Number:         49326
>Category:       misc
>Synopsis:       Correct errors in man pages csf.9 , pci.9 and ucom.9
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Oct 27 07:25:00 +0000 2014
>Closed-Date:    Mon Oct 27 16:22:55 +0000 2014
>Last-Modified:  Mon Oct 27 16:22:55 +0000 2014
>Originator:     Henning Petersen
>Release:        
>Organization:
>Environment:
>Description:
Correct errors in man pages csf.9 , pci.9 and ucom.9 .
>How-To-Repeat:

>Fix:
diff -u -p -r1.7 csf.9
--- share/man/man9/csf.9	2 Dec 2010 12:54:13 -0000	1.7
+++ share/man/man9/csf.9	27 Oct 2014 06:40:16 -0000
@@ -140,7 +140,7 @@ in order to handle priority adjustment.
 .El
 .Ss Priority adjustment
 .Bl -tag -width compact
-.It Ft void Fn sched_nice "struct proc *, int"
+.It Ft void Fn sched_nice "struct proc *" "int"
 Recalculate the process priority according to its nice value.
 .El
 .Ss General helper functions
===================================================================
diff -u -p -r1.36 pci.9
--- share/man/man9/pci.9	30 Jan 2012 19:20:13 -0000	1.36
+++ share/man/man9/pci.9	27 Oct 2014 06:40:16 -0000
@@ -73,8 +73,8 @@
 "int maxdevs"
 .Ft int
 .Fn pci_activate "pci_chipset_tag_t pc" "pcitag_t tag" "device_t dev" \
-"int (*wakeup)(pci_chipset_tag_t pc, pcitag_t tag" \
-"\t\tdevice_t dev, pcireg_t reg)"
+"int (*wakeup)(pci_chipset_tag_t pc" "pcitag_t tag" \
+"\t\tdevice_t dev" "pcireg_t reg)"
 .Ft int
 .Fn pci_chipset_tag_create "pci_chipset_tag_t opc" "uint64_t present" \
 "const struct pci_overrides *ov" "void *ctx" "pci_chipset_tag_t *pcp"
@@ -87,7 +87,7 @@
 "pcireg_t val"
 .Ft void
 .Fn pci_conf_print "pci_chipset_tag_t pc" "pcitag_t tag" \
-"void (*func)(pci_chipset_tag_t, pcitag_t, const pcireg_t *)"
+"void (*func)(pci_chipset_tag_t" "pcitag_t" "const pcireg_t *)"
 .Ft void
 .Fn pci_conf_capture "pci_chipset_tag_t pc" "pcitag_t tag" \
 "struct pci_conf_state *"
Index: share/man/man9/pfil.9
===================================================================
diff -u -p -r1.16 ucom.9
--- share/man/man9/ucom.9	5 Aug 2012 01:58:36 -0000	1.16
+++ share/man/man9/ucom.9	27 Oct 2014 06:40:16 -0000
@@ -140,7 +140,7 @@ struct ucom_methods {
 .Ed
 .Pp
 .Bl -tag -width indent
-.It Fn "void (*ucom_get_status)" "void *sc, int portno, u_char *lsr, u_char *msr"
+.It Fn "void (*ucom_get_status)" "void *sc" "int portno" "u_char *lsr" "u_char *msr"
 get the status of port
 .Fa portno .
 The status consists of the line status,
@@ -148,33 +148,33 @@ The status consists of the line status,
 and the modem status
 .Fa msr .
 The contents of these two bytes is exactly as for a 16550 UART.
-.It Fn "void (*ucom_set)" "void *sc, int portno, int reg, int onoff"
+.It Fn "void (*ucom_set)" "void *sc" "int portno" "int reg" "int onoff"
 Set (or unset) a particular feature of a port.
-.It Fn "int (*ucom_param)" "void *sc, int portno, struct termios *t"
+.It Fn "int (*ucom_param)" "void *sc" "int portno" "struct termios *t"
 Set the speed, number of data bit, stop bits, and parity of a port
 according to the
 .Xr termios 4
 struct.
-.It Fn "int (*ucom_ioctl)" "void *sc, int portno, u_long cmd, void *data, int flag, struct lwp *l"
+.It Fn "int (*ucom_ioctl)" "void *sc" "int portno" "u_long cmd" "void *data" "int flag" "struct lwp *l"
 implements any non-standard
 .Xr ioctl 2
 that a device needs.
-.It Fn "int (*ucom_open)" "void *sc, int portno"
+.It Fn "int (*ucom_open)" "void *sc" "int portno"
 called just before the
 .Nm
 driver opens the bulk pipes for the port.
-.It Fn "void (*ucom_close)" "void *sc, int portno"
+.It Fn "void (*ucom_close)" "void *sc" "int portno"
 called just after the
 .Nm
 driver closes the bulk pipes for the port.
-.It Fn "void (*ucom_read)" "void *sc, int portno, u_char **ptr, uint32_t *count"
+.It Fn "void (*ucom_read)" "void *sc" "int portno" "u_char **ptr" 

>Release-Note:

>Audit-Trail:
From: "Christos Zoulas" <christos@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/49326 CVS commit: src/share/man/man9
Date: Mon, 27 Oct 2014 08:02:18 -0400

 Module Name:	src
 Committed By:	christos
 Date:		Mon Oct 27 12:02:17 UTC 2014

 Modified Files:
 	src/share/man/man9: csf.9 pci.9 ucom.9

 Log Message:
 PR/49326: Henning Petersen: Correct errors in man pages csf.9 , pci.9 and ucom.9


 To generate a diff of this commit:
 cvs rdiff -u -r1.7 -r1.8 src/share/man/man9/csf.9
 cvs rdiff -u -r1.36 -r1.37 src/share/man/man9/pci.9
 cvs rdiff -u -r1.16 -r1.17 src/share/man/man9/ucom.9

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: wiz@NetBSD.org
State-Changed-When: Mon, 27 Oct 2014 16:22:55 +0000
State-Changed-Why:
Christos committed it, and I backed out parts of it
because we don't split function arguments which have their
own arguments into multiple arguments for Fn.
Thanks!


>Unformatted:

Home	PR Database Search