New sentence, new line. Use Dq.diff -r1.9 -r1.10 src/common/lib/libprop/prop_number.3
(wiz)
--- 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 | |||
140 | is returned. | 140 | is returned. | |
141 | .It Fn prop_number_size "prop_number_t number" | 141 | .It Fn prop_number_size "prop_number_t number" | |
142 | Returns 8, 16, 32, or 64, representing the number of bits required to | 142 | Returns 8, 16, 32, or 64, representing the number of bits required to | |
143 | hold the value of the object. | 143 | hold the value of the object. | |
144 | If the supplied object isn't a numeric value, | 144 | If the supplied object isn't a numeric value, | |
145 | .Dv NULL | 145 | .Dv NULL | |
146 | is returned. | 146 | is returned. | |
147 | .It Fn prop_number_unsigned "prop_number_t number" | 147 | .It Fn prop_number_unsigned "prop_number_t number" | |
148 | Returns | 148 | Returns | |
149 | .Dv true | 149 | .Dv true | |
150 | if the numeric value object has an unsigned value. | 150 | if 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" | |
152 | Returns the signed integer value of the numeric value object. | 152 | Returns the signed integer value of the numeric value object. | |
153 | If the supplied object isn't a numeric value, zero is returned. Thus, | 153 | If the supplied object isn't a numeric value, zero is returned. | |
154 | it is not possible to distinguish between ``not a prop_number_t'' | 154 | Thus, | |
155 | and ``prop_number_t has a value of 0''. | 155 | it is not possible to distinguish between | |
156 | .Dq not a prop_number_t | |||
157 | and | |||
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" | |
157 | Returns the unsigned integer value of the numeric value object. | 160 | Returns the unsigned integer value of the numeric value object. | |
158 | If the supplied object isn't a numeric value, zero is returned. Thus, | 161 | If the supplied object isn't a numeric value, zero is returned. | |
159 | it is not possible to distinguish between ``not a prop_number_t'' | 162 | Thus, | |
160 | and ``prop_number_t has a value of 0''. | 163 | it is not possible to distinguish between | |
164 | .Dq not a prop_number_t | |||
165 | and | |||
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" | |
162 | Returns | 168 | Returns | |
163 | .Dv true | 169 | .Dv true | |
164 | if the two numeric value objects are equivalent. | 170 | if the two numeric value objects are equivalent. | |
165 | If at least one of the supplied objects isn't a numeric value, | 171 | If at least one of the supplied objects isn't a numeric value, | |
166 | .Dv false | 172 | .Dv false | |
167 | is returned. | 173 | is 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" | |
169 | Returns | 175 | Returns | |
170 | .Dv true | 176 | .Dv true | |
171 | if the object's value is equivalent to the signed value | 177 | if the object's value is equivalent to the signed value | |
172 | .Fa val . | 178 | .Fa val . | |
173 | If the supplied object isn't a numerical value or if | 179 | If the supplied object isn't a numerical value or if |
--- 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 | |
65 | The | 65 | The | |
66 | .Nm prop_object | 66 | .Nm prop_object | |
67 | family of functions operate on all property container object types. | 67 | family 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" | |
70 | Increment the reference count on an object. | 70 | Increment 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" | |
72 | Decrement the reference count on an object. | 72 | Decrement the reference count on an object. | |
73 | If the last reference is dropped, the object is freed. | 73 | If 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" | |
75 | Determine the type of the object. Objects are one of the following types: | 75 | Determine the type of the object. | |
76 | Objects 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 | |
79 | Boolean value | 80 | Boolean value | |
80 | .Pq prop_bool_t | 81 | .Pq prop_bool_t | |
81 | .It Dv PROP_TYPE_NUMBER | 82 | .It Dv PROP_TYPE_NUMBER | |
82 | Number | 83 | Number | |
83 | .Pq prop_number_t | 84 | .Pq prop_number_t | |
84 | .It Dv PROP_TYPE_STRING | 85 | .It Dv PROP_TYPE_STRING | |
85 | String | 86 | String | |
86 | .Pq prop_string_t | 87 | .Pq prop_string_t | |
87 | .It Dv PROP_TYPE_DATA | 88 | .It Dv PROP_TYPE_DATA | |
88 | Opaque data | 89 | Opaque data |
--- 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 | |
55 | The | 55 | The | |
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 , | |
60 | and | 60 | and | |
61 | .Nm prop_dictionary_sendrecv_ioctl | 61 | .Nm prop_dictionary_sendrecv_ioctl | |
62 | functions implement the user space side of a protocol for sending property | 62 | functions implement the user space side of a protocol for sending property | |
63 | lists to and from the kernel using | 63 | lists to and from the kernel using | |
64 | .Xr ioctl 2 . | 64 | .Xr ioctl 2 . | |
65 | .Sh RETURN VALUES | 65 | .Sh RETURN VALUES | |
66 | If successful, functions return zero. Otherwise, an error number is returned to indicate the error. | 66 | If successful, functions return zero. | |
67 | Otherwise, 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 | |
69 | and | 70 | and | |
70 | .Fn prop_dictionary_send_ioctl | 71 | .Fn prop_dictionary_send_ioctl | |
71 | will fail if: | 72 | will fail if: | |
72 | .Bl -tag -width Er | 73 | .Bl -tag -width Er | |
73 | .It Bq Er ENOMEM | 74 | .It Bq Er ENOMEM | |
74 | Cannot allocate memory | 75 | Cannot allocate memory | |
75 | .It Bq Er ENOTSUP | 76 | .It Bq Er ENOTSUP | |
76 | Not supported | 77 | Not supported | |
77 | .El | 78 | .El | |
78 | .Pp | 79 | .Pp | |
79 | .Fn prop_array_recv_ioctl | 80 | .Fn prop_array_recv_ioctl |