From owner-freebsd-doc@FreeBSD.ORG  Thu Sep 29 20:09:58 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 1233)
	id C9E2C106566C; Thu, 29 Sep 2011 20:09:58 +0000 (UTC)
Date: Thu, 29 Sep 2011 20:09:58 +0000
From: Alexander Best <arundel@freebsd.org>
To: freebsd-doc@freebsd.org
Message-ID: <20110929200958.GA28932@freebsd.org>
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="OXfL5xGRrasGEqWY"
Content-Disposition: inline
Subject: small kldstat(2) man page adjustment
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
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, 29 Sep 2011 20:09:58 -0000


--OXfL5xGRrasGEqWY
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

hi there,

any thoughts regarding this change? personally i think it makes things a bit
easier to comprehend.

cheers.
alex

--OXfL5xGRrasGEqWY
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="kldstat.2.diff"

diff --git a/lib/libc/sys/kldstat.2 b/lib/libc/sys/kldstat.2
index 7a48296..6340c11 100644
--- a/lib/libc/sys/kldstat.2
+++ b/lib/libc/sys/kldstat.2
@@ -47,7 +47,7 @@ into
 .Fa stat .
 .Bd -literal
 struct kld_file_stat {
-	int         version;        /* set to sizeof(linker_file_stat) */
+	int         version;
 	char        name[MAXPATHLEN];
 	int         refs;
 	int         id;
@@ -58,10 +58,11 @@ struct kld_file_stat {
 .Ed
 .Bl -tag -width XXXaddress
 .It version
-This field is set to the size of the structure mentioned above by the code
-calling
-.Fn kldstat ,
-and not
+This field needs to be set to
+.Fn sizeof "linker_file_stat"
+by the code calling
+.Fn kldstat .
+It will not be set by
 .Fn kldstat
 itself.
 .It name
@@ -76,11 +77,10 @@ The id of the file specified in
 .It address
 The load address of the kld file.
 .It size
-The amount of memory in bytes allocated by the file.
+The amount of memory in bytes allocated by the kld file.
 .It pathname
-The full name of the file referred to by
-.Fa fileid ,
-including the path.
+The full pathname of the file referred to by
+.Fa fileid .
 .El
 .Sh RETURN VALUES
 .Rv -std kldstat

--OXfL5xGRrasGEqWY--