[src/trunk]: src/common/lib/libprop Add the *_size() variants to the .Nm list...

[pgoyette <pgoyette%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/af707b14a4bf
branches:  trunk
changeset: 351174:af707b14a4bf
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Sun Feb 05 00:47:33 2017 +0000

description:
Add the *_size() variants to the .Nm list so it will be found by
apropos(1).

While here, reorder the function lists to improve readability.

diffstat:

 common/lib/libprop/prop_copyin_ioctl.9 |  59 +++++++++++++++++----------------
 1 files changed, 31 insertions(+), 28 deletions(-)

diffs (116 lines):

diff -r a7cba11fae53 -r af707b14a4bf common/lib/libprop/prop_copyin_ioctl.9
--- a/common/lib/libprop/prop_copyin_ioctl.9    Sun Feb 05 00:24:24 2017 +0000
+++ b/common/lib/libprop/prop_copyin_ioctl.9    Sun Feb 05 00:47:33 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prop_copyin_ioctl.9,v 1.13 2017/02/04 23:32:43 wiz Exp $
+.\"    $NetBSD: prop_copyin_ioctl.9,v 1.14 2017/02/05 00:47:33 pgoyette Exp $
 .\"
 .\" Copyright (c) 2006, 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,35 +31,45 @@
 .Dt PROP_COPYIN_IOCTL 9
 .Os
 .Sh NAME
+.Nm prop_array_copyin ,
+.Nm prop_array_copyin_size ,
 .Nm prop_array_copyin_ioctl ,
-.Nm prop_array_copyout_ioctl ,
-.Nm prop_array_copyin ,
+.Nm prop_array_copyin_ioctl_size ,
 .Nm prop_array_copyout ,
+.Nm prop_array_copyout_ioctl ,
+.Nm prop_dictionary_copyin ,
+.Nm prop_dictionary_copyin_size ,
 .Nm prop_dictionary_copyin_ioctl ,
+.Nm prop_dictionary_copyin_ioctl_size ,
+.Nm prop_dictionary_copyout
 .Nm prop_dictionary_copyout_ioctl ,
-.Nm prop_dictionary_copyin ,
-.Nm prop_dictionary_copyout
 .Nd Copy property lists to and from kernel space
 .Sh SYNOPSIS
 .In prop/proplib.h
 .Ft int
-.Fn prop_array_copyin_ioctl "const struct plistref *pref" \
-    "const u_long cmd" "prop_array_t *arrayp"
-.Ft int
-.Fn prop_array_copyin_ioctl_size "const struct plistref *pref" \
-    "const u_long cmd" "prop_array_t *arrayp" "size_t lim"
-.Ft int
 .Fn prop_array_copyin "const struct plistref *pref" \
     "prop_array_t *arrayp"
 .Ft int
 .Fn prop_array_copyin_size "const struct plistref *pref" \
     "prop_array_t *arrayp" "size_t lim"
 .Ft int
+.Fn prop_array_copyin_ioctl "const struct plistref *pref" \
+    "const u_long cmd" "prop_array_t *arrayp"
+.Ft int
+.Fn prop_array_copyin_ioctl_size "const struct plistref *pref" \
+    "const u_long cmd" "prop_array_t *arrayp" "size_t lim"
+.Ft int
+.Fn prop_array_copyout "struct plistref *pref" \
+    "prop_array_t array"
+.Ft int
 .Fn prop_array_copyout_ioctl "struct plistref *pref" \
     "const u_long cmd" "prop_array_t array"
 .Ft int
-.Fn prop_array_copyout "struct plistref *pref" \
-    "prop_array_t array"
+.Fn prop_dictionary_copyin "const struct plistref *pref" \
+    "prop_dictionary_t *dictp"
+.Ft int
+.Fn prop_dictionary_copyin_size "const struct plistref *pref" \
+    "prop_dictionary_t *dictp" "size_t lim"
 .Ft int
 .Fn prop_dictionary_copyin_ioctl "const struct plistref *pref" \
     "const u_long cmd" "prop_dictionary_t *dictp"
@@ -67,20 +77,13 @@
 .Fn prop_dictionary_copyin_ioctl_size "const struct plistref *pref" \
     "const u_long cmd" "prop_dictionary_t *dictp" "size_t lim"
 .Ft int
-.Fn prop_dictionary_copyin "const struct plistref *pref" \
-    "prop_dictionary_t *dictp"
-.Ft int
-.Fn prop_dictionary_copyin_size "const struct plistref *pref" \
-    "prop_dictionary_t *dictp" "size_t lim"
+.Fn prop_dictionary_copyout "struct plistref *pref" \
+    "prop_dictionary_t dict"
 .Ft int
 .Fn prop_dictionary_copyout_ioctl "struct plistref *pref" \
     "const u_long cmd" "prop_dictionary_t dict"
-.Ft int
-.Fn prop_dictionary_copyout "struct plistref *pref" \
-    "prop_dictionary_t dict"
 .Sh DESCRIPTION
 The
-.Nm prop_array_ioctl ,
 .Nm prop_array_copyin_ioctl ,
 .Nm prop_array_copyin_ioctl_size ,
 .Nm prop_array_copyout_ioctl ,
@@ -109,19 +112,19 @@
 form.
 .Pp
 The functions
+.Nm prop_array_copyin_size ,
 .Nm prop_array_copyin_ioctl_size ,
-.Nm prop_dictionary_copyin_ioctl_size ,
-.Nm prop_array_copyin_size ,
+.Nm prop_dictionary_copyin_size ,
 and
-.Nm prop_dictionary_copyin_size
+.Nm prop_dictionary_copyin_ioctl_size
 take an explicit limit argument
 .Ar lim
 while
+.Nm prop_array_copyin ,
 .Nm prop_array_copyin_ioctl ,
-.Nm prop_dictionary_copyin_ioctl ,
-.Nm prop_array_copyin ,
+.Nm prop_dictionary_copyin ,
 and
-.Nm prop_dictionary_copyin
+.Nm prop_dictionary_copyin_ioctl
 have an implicit size limit of 128KB.
 Attempts to transfer objects larger than the limit result in an
 .Er E2BIG