jcs's openbsd hax
openbsd

Use .Rv where appropriate, and move it to RETURN VALUES; remove .Tn, and a few minor macro adjustments. Patch from Kaspars at Bankovskis dot net.

schwarze ee10762e a497dac9

+47 -84
+3 -6
lib/libc/compat-43/killpg.3
··· 25 25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 26 .\" SUCH DAMAGE. 27 27 .\" 28 - .\" $OpenBSD: killpg.3,v 1.12 2013/06/05 03:39:22 tedu Exp $ 28 + .\" $OpenBSD: killpg.3,v 1.13 2015/01/29 01:46:30 schwarze Exp $ 29 29 .\" 30 - .Dd $Mdocdate: June 5 2013 $ 30 + .Dd $Mdocdate: January 29 2015 $ 31 31 .Dt KILLPG 3 32 32 .Os 33 33 .Sh NAME ··· 58 58 As a single special case the continue signal SIGCONT may be sent 59 59 to any process with the same session ID as the caller. 60 60 .Sh RETURN VALUES 61 - Upon successful completion, a value of 0 is returned. 62 - Otherwise, a value of \-1 is returned and the global variable 63 - .Va errno 64 - is set to indicate the error. 61 + .Rv -std 65 62 .Sh ERRORS 66 63 .Fn killpg 67 64 will fail and no signal will be sent if:
+3 -6
lib/libc/gen/raise.3
··· 1 - .\" $OpenBSD: raise.3,v 1.10 2013/06/05 03:39:22 tedu Exp $ 1 + .\" $OpenBSD: raise.3,v 1.11 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" 3 3 .\" Copyright (c) 1990, 1991, 1993 4 4 .\" The Regents of the University of California. All rights reserved. ··· 31 31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 32 .\" SUCH DAMAGE. 33 33 .\" 34 - .Dd $Mdocdate: June 5 2013 $ 34 + .Dd $Mdocdate: January 29 2015 $ 35 35 .Dt RAISE 3 36 36 .Os 37 37 .Sh NAME ··· 48 48 .Fa sig 49 49 to the current thread. 50 50 .Sh RETURN VALUES 51 - Upon successful completion, a value of 0 is returned. 52 - Otherwise, a value of \-1 is returned and the global variable 53 - .Va errno 54 - is set to indicate the error. 51 + .Rv -std 55 52 .Sh ERRORS 56 53 .Fn raise 57 54 will fail and no signal will be sent if:
+7 -14
lib/libc/gen/statvfs.3
··· 1 - .\" $OpenBSD: statvfs.3,v 1.7 2015/01/19 15:54:11 millert Exp $ 1 + .\" $OpenBSD: statvfs.3,v 1.8 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" $NetBSD: statfs.2,v 1.10 1995/06/29 11:40:48 cgd Exp $ 3 3 .\" 4 4 .\" Copyright (c) 1989, 1991, 1993 ··· 30 30 .\" 31 31 .\" @(#)statfs.2 8.3 (Berkeley) 2/11/94 32 32 .\" 33 - .Dd $Mdocdate: January 19 2015 $ 33 + .Dd $Mdocdate: January 29 2015 $ 34 34 .Dt STATVFS 3 35 35 .Os 36 36 .Sh NAME ··· 72 72 .Ed 73 73 .Pp 74 74 The fields of type 75 - .Va fsblkcnt_t 75 + .Vt fsblkcnt_t 76 76 are reported in units of 77 - .Va f_frsize . 77 + .Fa f_frsize . 78 78 .Pp 79 79 .Fn fstatvfs 80 80 returns the same information about an open file referenced by descriptor 81 81 .Fa fd . 82 82 .Sh RETURN VALUES 83 - Upon successful completion, a value of 0 is returned. 84 - Otherwise, \-1 is returned and the global variable 85 - .Va errno 86 - is set to indicate the error. 83 + .Rv -std 87 84 .Sh ERRORS 88 85 .Fn statvfs 89 86 fails if one or more of the following are true: ··· 115 112 .Fa path 116 113 points to an invalid address. 117 114 .It Bq Er EIO 118 - An 119 - .Tn I/O 120 - error occurred while reading from or writing to the file system. 115 + An I/O error occurred while reading from or writing to the file system. 121 116 .El 122 117 .Pp 123 118 .Fn fstatvfs ··· 130 125 .Fa buf 131 126 points to an invalid address. 132 127 .It Bq Er EIO 133 - An 134 - .Tn I/O 135 - error occurred while reading from or writing to the file system. 128 + An I/O error occurred while reading from or writing to the file system. 136 129 .El 137 130 .Sh SEE ALSO 138 131 .Xr df 1 ,
+3 -3
lib/libc/gen/time.3
··· 1 - .\" $OpenBSD: time.3,v 1.15 2013/07/17 05:42:11 schwarze Exp $ 1 + .\" $OpenBSD: time.3,v 1.16 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" 3 3 .\" Copyright (c) 1989, 1991, 1993 4 4 .\" The Regents of the University of California. All rights reserved. ··· 31 31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 32 .\" SUCH DAMAGE. 33 33 .\" 34 - .Dd $Mdocdate: July 17 2013 $ 34 + .Dd $Mdocdate: January 29 2015 $ 35 35 .Dt TIME 3 36 36 .Os 37 37 .Sh NAME ··· 53 53 If 54 54 .Fa tloc 55 55 is a null pointer, no value is stored. 56 - .Pp 56 + .Sh RETURN VALUES 57 57 Upon successful completion, 58 58 .Fn time 59 59 returns the value of time.
+4 -9
lib/libc/gen/utime.3
··· 1 - .\" $OpenBSD: utime.3,v 1.21 2015/01/19 15:54:11 millert Exp $ 1 + .\" $OpenBSD: utime.3,v 1.22 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" 3 3 .\" Copyright (c) 1980, 1991, 1993 4 4 .\" The Regents of the University of California. All rights reserved. ··· 27 27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28 28 .\" SUCH DAMAGE. 29 29 .\" 30 - .Dd $Mdocdate: January 19 2015 $ 30 + .Dd $Mdocdate: January 29 2015 $ 31 31 .Dt UTIME 3 32 32 .Os 33 33 .Sh NAME ··· 83 83 In either case, the inode change-time of the file is set to the current 84 84 time. 85 85 .Sh RETURN VALUES 86 - Upon successful completion, a value of 0 is returned. 87 - Otherwise, a value of \-1 is returned and 88 - .Va errno 89 - is set to indicate the error. 86 + .Rv -std 90 87 .Sh ERRORS 91 88 .Fn utime 92 89 will fail if: ··· 109 106 .It Bq Er EINVAL 110 107 The pathname contains a character with the high-order bit set. 111 108 .It Bq Er EIO 112 - An 113 - .Tn I/O 114 - error occurred while reading or writing the affected inode. 109 + An I/O error occurred while reading or writing the affected inode. 115 110 .It Bq Er ELOOP 116 111 Too many symbolic links were encountered in translating the pathname. 117 112 .It Bq Er ENAMETOOLONG
+6 -9
lib/libc/net/getifaddrs.3
··· 1 - .\" $OpenBSD: getifaddrs.3,v 1.19 2014/04/07 17:57:56 schwarze Exp $ 1 + .\" $OpenBSD: getifaddrs.3,v 1.20 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" BSDI getifaddrs.3,v 2.5 2000/02/23 14:51:59 dab Exp 3 3 .\" 4 4 .\" Copyright (c) 1995, 1999 ··· 21 21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22 22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23 23 .\" SUCH DAMAGE. 24 - .Dd $Mdocdate: April 7 2014 $ 24 + .Dd $Mdocdate: January 29 2015 $ 25 25 .Dt GETIFADDRS 3 26 26 .Os 27 27 .Sh NAME ··· 43 43 on the local machine in the memory referenced by 44 44 .Fa ifap . 45 45 The list consists of 46 - .Nm ifaddrs 46 + .Vt ifaddrs 47 47 structures, as defined in the include file 48 48 .In ifaddrs.h . 49 49 The 50 - .Nm ifaddrs 50 + .Vt ifaddrs 51 51 structure contains at least the following entries: 52 52 .Bd -literal 53 53 struct ifaddrs *ifa_next; /* Pointer to next struct */ ··· 102 102 For 103 103 .Dv AF_LINK 104 104 addresses it contains a pointer to the 105 - .Li struct if_data 105 + .Vt struct if_data 106 106 (as defined in include file 107 107 .In net/if.h ) 108 108 which contains various interface attributes and statistics. ··· 118 118 .Fn freeifaddrs 119 119 when no longer needed. 120 120 .Sh RETURN VALUES 121 - Upon successful completion, a value of 0 is returned. 122 - Otherwise, a value of \-1 is returned and 123 - .Va errno 124 - is set to indicate the error. 121 + .Rv -std 125 122 .Sh ERRORS 126 123 The 127 124 .Fn getifaddrs
+3 -8
lib/libc/stdio/remove.3
··· 1 - .\" $OpenBSD: remove.3,v 1.12 2013/06/05 03:39:23 tedu Exp $ 1 + .\" $OpenBSD: remove.3,v 1.13 2015/01/29 01:46:30 schwarze Exp $ 2 2 .\" 3 3 .\" Copyright (c) 1990, 1991, 1993 4 4 .\" The Regents of the University of California. All rights reserved. ··· 33 33 .\" 34 34 .\" @(#)remove.3 8.1 (Berkeley) 6/4/93 35 35 .\" 36 - .Dd $Mdocdate: June 5 2013 $ 36 + .Dd $Mdocdate: January 29 2015 $ 37 37 .Dt REMOVE 3 38 38 .Os 39 39 .Sh NAME ··· 58 58 Otherwise, it is the equivalent of 59 59 .Fn unlink "path" . 60 60 .Sh RETURN VALUES 61 - Upon successful completion, 62 - .Fn remove 63 - returns 0. 64 - Otherwise, \-1 is returned and the global variable 65 - .Va errno 66 - is set to indicate the error. 61 + .Rv -std 67 62 .Sh ERRORS 68 63 The 69 64 .Fn remove
+3 -10
lib/libc/stdlib/qsort.3
··· 29 29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30 30 .\" SUCH DAMAGE. 31 31 .\" 32 - .\" $OpenBSD: qsort.3,v 1.17 2013/07/17 05:42:11 schwarze Exp $ 32 + .\" $OpenBSD: qsort.3,v 1.18 2015/01/29 01:46:31 schwarze Exp $ 33 33 .\" 34 - .Dd $Mdocdate: July 17 2013 $ 34 + .Dd $Mdocdate: January 29 2015 $ 35 35 .Dt QSORT 3 36 36 .Os 37 37 .Sh NAME ··· 147 147 .Fn qsort 148 148 function returns no value. 149 149 .Pp 150 - Upon successful completion, 151 - .Fn heapsort 152 - and 153 - .Fn mergesort 154 - return 0. 155 - Otherwise, they return \-1 and the global variable 156 - .Va errno 157 - is set to indicate the error. 150 + .Rv -std heapsort mergesort 158 151 .Sh ERRORS 159 152 The 160 153 .Fn heapsort
+4 -8
lib/libc/stdlib/radixsort.3
··· 25 25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 26 .\" SUCH DAMAGE. 27 27 .\" 28 - .\" $OpenBSD: radixsort.3,v 1.12 2013/06/05 03:39:23 tedu Exp $ 28 + .\" $OpenBSD: radixsort.3,v 1.13 2015/01/29 01:46:31 schwarze Exp $ 29 29 .\" 30 - .Dd $Mdocdate: June 5 2013 $ 30 + .Dd $Mdocdate: January 29 2015 $ 31 31 .Dt RADIXSORT 3 32 32 .Os 33 33 .Sh NAME ··· 78 78 is 79 79 .Dv NULL , 80 80 the contents of the array are sorted in ascending order according to the 81 - .Tn ASCII 82 - order of the byte strings they reference and 81 + ASCII order of the byte strings they reference and 83 82 .Fa endbyte 84 83 has a sorting weight of 0. 85 84 .Pp ··· 101 100 particular, see D.E. Knuth's Algorithm R and section 5.2.5, exercise 10. 102 101 They take linear time relative to the number of bytes in the strings. 103 102 .Sh RETURN VALUES 104 - Upon successful completion 0 is returned. 105 - Otherwise, \-1 is returned and the global variable 106 - .Va errno 107 - is set to indicate the error. 103 + .Rv -std 108 104 .Sh ERRORS 109 105 .Bl -tag -width Er 110 106 .It Bq Er EINVAL
+11 -11
lib/libc/time/strftime.3
··· 30 30 .\" SUCH DAMAGE. 31 31 .\" 32 32 .\" from: @(#)strftime.3 5.12 (Berkeley) 6/29/91 33 - .\" $OpenBSD: strftime.3,v 1.33 2014/09/08 01:27:54 schwarze Exp $ 33 + .\" $OpenBSD: strftime.3,v 1.34 2015/01/29 01:46:31 schwarze Exp $ 34 34 .\" 35 - .Dd $Mdocdate: September 8 2014 $ 35 + .Dd $Mdocdate: January 29 2015 $ 36 36 .Dt STRFTIME 3 37 37 .Os 38 38 .Sh NAME ··· 64 64 No more than 65 65 .Fa maxsize 66 66 characters will be placed into the array. 67 - If the total number of resulting characters, including the terminating 68 - NUL character, is not more than 69 - .Fa maxsize , 70 - .Fn strftime 71 - returns the number of characters placed in the array, not counting the 72 - terminating NUL. 73 - Otherwise, zero is returned. 74 67 .Pp 75 68 Each conversion specification is replaced by the characters as 76 69 follows which are then copied into the buffer. ··· 127 120 is replaced by a newline. 128 121 .It Cm %p 129 122 is replaced by the locale's equivalent of either 130 - .Dq Tn AM 123 + .Dq AM 131 124 or 132 - .Dq Tn PM . 125 + .Dq PM . 133 126 .It Cm \&%R 134 127 is replaced by the time in the format 135 128 .Dq Li %H:%M . ··· 196 189 .Xr date 1 197 190 format. 198 191 .El 192 + .Sh RETURN VALUES 193 + If the total number of resulting characters, including the terminating 194 + NUL character, is not more than 195 + .Fa maxsize , 196 + .Fn strftime 197 + returns the number of characters placed in the array, not counting the 198 + terminating NUL. Otherwise, zero is returned. 199 199 .Sh SEE ALSO 200 200 .Xr date 1 , 201 201 .Xr printf 1 ,