Thu Jan 20 10:44:42 2011 UTC ()
New sentence, new line. Use Dq.


(wiz)
diff -r1.9 -r1.10 src/common/lib/libprop/prop_number.3
diff -r1.7 -r1.8 src/common/lib/libprop/prop_object.3
diff -r1.5 -r1.6 src/common/lib/libprop/prop_send_ioctl.3

cvs diff -r1.9 -r1.10 src/common/lib/libprop/prop_number.3 (expand / switch to unified diff)

--- src/common/lib/libprop/prop_number.3 2008/04/30 13:10:46 1.9
+++ src/common/lib/libprop/prop_number.3 2011/01/20 10:44:42 1.10
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: prop_number.3,v 1.9 2008/04/30 13:10:46 martin Exp $ 1.\" $NetBSD: prop_number.3,v 1.10 2011/01/20 10:44:42 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe. 7.\" by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -140,34 +140,40 @@ If the supplied object isn't a numeric v @@ -140,34 +140,40 @@ If the supplied object isn't a numeric v
140is returned. 140is returned.
141.It Fn prop_number_size "prop_number_t number" 141.It Fn prop_number_size "prop_number_t number"
142Returns 8, 16, 32, or 64, representing the number of bits required to 142Returns 8, 16, 32, or 64, representing the number of bits required to
143hold the value of the object. 143hold the value of the object.
144If the supplied object isn't a numeric value, 144If the supplied object isn't a numeric value,
145.Dv NULL 145.Dv NULL
146is returned. 146is returned.
147.It Fn prop_number_unsigned "prop_number_t number" 147.It Fn prop_number_unsigned "prop_number_t number"
148Returns 148Returns
149.Dv true 149.Dv true
150if the numeric value object has an unsigned value. 150if the numeric value object has an unsigned value.
151.It Fn prop_number_integer_value "prop_number_t number" 151.It Fn prop_number_integer_value "prop_number_t number"
152Returns the signed integer value of the numeric value object. 152Returns the signed integer value of the numeric value object.
153If the supplied object isn't a numeric value, zero is returned. Thus, 153If the supplied object isn't a numeric value, zero is returned.
154it is not possible to distinguish between ``not a prop_number_t'' 154Thus,
155and ``prop_number_t has a value of 0''. 155it is not possible to distinguish between
 156.Dq not a prop_number_t
 157and
 158.Dq prop_number_t has a value of 0 .
156.It Fn prop_number_unsigned_integer_value "prop_number_t number" 159.It Fn prop_number_unsigned_integer_value "prop_number_t number"
157Returns the unsigned integer value of the numeric value object. 160Returns the unsigned integer value of the numeric value object.
158If the supplied object isn't a numeric value, zero is returned. Thus, 161If the supplied object isn't a numeric value, zero is returned.
159it is not possible to distinguish between ``not a prop_number_t'' 162Thus,
160and ``prop_number_t has a value of 0''. 163it is not possible to distinguish between
 164.Dq not a prop_number_t
 165and
 166.Dq prop_number_t has a value of 0 .
161.It Fn prop_number_equals "prop_number_t num1" "prop_number_t num2" 167.It Fn prop_number_equals "prop_number_t num1" "prop_number_t num2"
162Returns 168Returns
163.Dv true 169.Dv true
164if the two numeric value objects are equivalent. 170if the two numeric value objects are equivalent.
165If at least one of the supplied objects isn't a numeric value, 171If at least one of the supplied objects isn't a numeric value,
166.Dv false 172.Dv false
167is returned. 173is returned.
168.It Fn prop_number_equals_integer "prop_number_t number" "int64_t val" 174.It Fn prop_number_equals_integer "prop_number_t number" "int64_t val"
169Returns 175Returns
170.Dv true 176.Dv true
171if the object's value is equivalent to the signed value 177if the object's value is equivalent to the signed value
172.Fa val . 178.Fa val .
173If the supplied object isn't a numerical value or if 179If the supplied object isn't a numerical value or if

cvs diff -r1.7 -r1.8 src/common/lib/libprop/prop_object.3 (expand / switch to unified diff)

--- src/common/lib/libprop/prop_object.3 2008/04/30 13:10:46 1.7
+++ src/common/lib/libprop/prop_object.3 2011/01/20 10:44:42 1.8
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: prop_object.3,v 1.7 2008/04/30 13:10:46 martin Exp $ 1.\" $NetBSD: prop_object.3,v 1.8 2011/01/20 10:44:42 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe. 7.\" by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -62,27 +62,28 @@ @@ -62,27 +62,28 @@
62.Ft void 62.Ft void
63.Fn prop_object_iterator_release "prop_object_iterator_t iter" 63.Fn prop_object_iterator_release "prop_object_iterator_t iter"
64.Sh DESCRIPTION 64.Sh DESCRIPTION
65The 65The
66.Nm prop_object 66.Nm prop_object
67family of functions operate on all property container object types. 67family of functions operate on all property container object types.
68.Bl -tag -width "" 68.Bl -tag -width ""
69.It Fn prop_object_retain "prop_object_t obj" 69.It Fn prop_object_retain "prop_object_t obj"
70Increment the reference count on an object. 70Increment the reference count on an object.
71.It Fn prop_object_release "prop_object_t obj" 71.It Fn prop_object_release "prop_object_t obj"
72Decrement the reference count on an object. 72Decrement the reference count on an object.
73If the last reference is dropped, the object is freed. 73If the last reference is dropped, the object is freed.
74.It Fn prop_object_type "prop_object_t obj" 74.It Fn prop_object_type "prop_object_t obj"
75Determine the type of the object. Objects are one of the following types: 75Determine the type of the object.
 76Objects are one of the following types:
76.Pp 77.Pp
77.Bl -tag -width "PROP_TYPE_DICT_KEYSYM" -compact 78.Bl -tag -width "PROP_TYPE_DICT_KEYSYM" -compact
78.It Dv PROP_TYPE_BOOL 79.It Dv PROP_TYPE_BOOL
79Boolean value 80Boolean value
80.Pq prop_bool_t 81.Pq prop_bool_t
81.It Dv PROP_TYPE_NUMBER 82.It Dv PROP_TYPE_NUMBER
82Number 83Number
83.Pq prop_number_t 84.Pq prop_number_t
84.It Dv PROP_TYPE_STRING 85.It Dv PROP_TYPE_STRING
85String 86String
86.Pq prop_string_t 87.Pq prop_string_t
87.It Dv PROP_TYPE_DATA 88.It Dv PROP_TYPE_DATA
88Opaque data 89Opaque data

cvs diff -r1.5 -r1.6 src/common/lib/libprop/prop_send_ioctl.3 (expand / switch to unified diff)

--- src/common/lib/libprop/prop_send_ioctl.3 2008/04/30 13:10:46 1.5
+++ src/common/lib/libprop/prop_send_ioctl.3 2011/01/20 10:44:42 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: prop_send_ioctl.3,v 1.5 2008/04/30 13:10:46 martin Exp $ 1.\" $NetBSD: prop_send_ioctl.3,v 1.6 2011/01/20 10:44:42 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2006 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe. 7.\" by Jason R. Thorpe.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -53,27 +53,28 @@ @@ -53,27 +53,28 @@
53 "unsigned long cmd" "prop_dictionary_t *dictp" 53 "unsigned long cmd" "prop_dictionary_t *dictp"
54.Sh DESCRIPTION 54.Sh DESCRIPTION
55The 55The
56.Nm prop_array_send_ioctl , 56.Nm prop_array_send_ioctl ,
57.Nm prop_array_recv_ioctl , 57.Nm prop_array_recv_ioctl ,
58.Nm prop_dictionary_send_ioctl , 58.Nm prop_dictionary_send_ioctl ,
59.Nm prop_dictionary_recv_ioctl , 59.Nm prop_dictionary_recv_ioctl ,
60and 60and
61.Nm prop_dictionary_sendrecv_ioctl 61.Nm prop_dictionary_sendrecv_ioctl
62functions implement the user space side of a protocol for sending property 62functions implement the user space side of a protocol for sending property
63lists to and from the kernel using 63lists to and from the kernel using
64.Xr ioctl 2 . 64.Xr ioctl 2 .
65.Sh RETURN VALUES 65.Sh RETURN VALUES
66If successful, functions return zero. Otherwise, an error number is returned to indicate the error. 66If successful, functions return zero.
 67Otherwise, an error number is returned to indicate the error.
67.Sh ERRORS 68.Sh ERRORS
68.Fn prop_array_send_ioctl 69.Fn prop_array_send_ioctl
69and 70and
70.Fn prop_dictionary_send_ioctl 71.Fn prop_dictionary_send_ioctl
71will fail if: 72will fail if:
72.Bl -tag -width Er 73.Bl -tag -width Er
73.It Bq Er ENOMEM 74.It Bq Er ENOMEM
74Cannot allocate memory 75Cannot allocate memory
75.It Bq Er ENOTSUP 76.It Bq Er ENOTSUP
76Not supported 77Not supported
77.El 78.El
78.Pp 79.Pp
79.Fn prop_array_recv_ioctl 80.Fn prop_array_recv_ioctl