Date: Sun, 25 Mar 2012 16:00:56 +0000 (UTC) From: Joel Dahl <joel@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r233466 - in head: lib/libc/locale lib/libc/sys libexec/bootpd share/man/man3 share/man/man4 Message-ID: <201203251600.q2PG0u4R088855@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: joel (doc committer) Date: Sun Mar 25 16:00:56 2012 New Revision: 233466 URL: http://svn.freebsd.org/changeset/base/233466 Log: Make sure sections are sorted into conventional order. Modified: head/lib/libc/locale/duplocale.3 head/lib/libc/locale/xlocale.3 head/lib/libc/sys/cap_new.2 head/libexec/bootpd/bootpd.8 head/share/man/man3/pthread_cond_destroy.3 head/share/man/man4/umcs.4 head/share/man/man4/xnb.4 Modified: head/lib/libc/locale/duplocale.3 ============================================================================== --- head/lib/libc/locale/duplocale.3 Sun Mar 25 14:20:43 2012 (r233465) +++ head/lib/libc/locale/duplocale.3 Sun Mar 25 16:00:56 2012 (r233466) @@ -59,15 +59,6 @@ locale. .Pt The locale returned by this call must be freed with .Xr freelocale 3 . -.Sh BUGS -Ideally, -.Xr uselocale 3 -should make a copy of the -.Fa locale_t -implicitly to ensure thread safety, -and a copy of the global locale should be installed lazily on each thread. -The FreeBSD implementation does not do this, -for compatibility with Darwin. .Sh SEE ALSO .Xr freelocale 3 , .Xr localeconv 3 , @@ -78,3 +69,12 @@ for compatibility with Darwin. .Sh STANDARDS This function, conforms to .St -p1003.1-2008 +.Sh BUGS +Ideally, +.Xr uselocale 3 +should make a copy of the +.Fa locale_t +implicitly to ensure thread safety, +and a copy of the global locale should be installed lazily on each thread. +The FreeBSD implementation does not do this, +for compatibility with Darwin. Modified: head/lib/libc/locale/xlocale.3 ============================================================================== --- head/lib/libc/locale/xlocale.3 Sun Mar 25 14:20:43 2012 (r233465) +++ head/lib/libc/locale/xlocale.3 Sun Mar 25 16:00:56 2012 (r233466) @@ -65,21 +65,6 @@ LC_GLOBAL_LOCALE refers to the global lo The global locale is the locale set with the .Xr setlocale 3 function. -.Sh CAVEATS -The -.Xr setlocale 3 -function, and others in the family, refer to the global locale. -Other functions that depend on the locale, however, -will take the thread-local locale if one has been set. -This means that the idiom of setting the locale using -.Xr setlocale 3 , -calling a locale-dependent function, -and then restoring the locale will not -have the expected behavior if the current thread has had a locale set using -.Xr uselocale 3 . -You should avoid this idiom and prefer to use the -.Fa _l -suffixed versions instead. .Sh SEE ALSO .Xr duplocale 3 , .Xr freelocale 3 , @@ -278,3 +263,18 @@ The xlocale APIs first appeared in Darwi This implementation was written by David Chisnall, under sponsorship from the FreeBSD Foundation and first appeared in .Fx 9.1 . +.Sh CAVEATS +The +.Xr setlocale 3 +function, and others in the family, refer to the global locale. +Other functions that depend on the locale, however, +will take the thread-local locale if one has been set. +This means that the idiom of setting the locale using +.Xr setlocale 3 , +calling a locale-dependent function, +and then restoring the locale will not +have the expected behavior if the current thread has had a locale set using +.Xr uselocale 3 . +You should avoid this idiom and prefer to use the +.Fa _l +suffixed versions instead. Modified: head/lib/libc/sys/cap_new.2 ============================================================================== --- head/lib/libc/sys/cap_new.2 Sun Mar 25 14:20:43 2012 (r233465) +++ head/lib/libc/sys/cap_new.2 Sun Mar 25 16:00:56 2012 (r233466) @@ -462,14 +462,14 @@ argument is not a capability. Support for capabilities and capabilities mode was developed as part of the .Tn TrustedBSD Project. +.Sh AUTHORS +These functions and the capability facility were created by +.An "Robert N. M. Watson" +at the University of Cambridge Computer Laboratory with support from a grant +from Google, Inc. .Sh BUGS This man page should list the set of permitted system calls more specifically for each capability right. .Pp Capability rights sometimes have unclear indirect impacts, which should be documented, or at least hinted at. -.Sh AUTHORS -These functions and the capability facility were created by -.An "Robert N. M. Watson" -at the University of Cambridge Computer Laboratory with support from a grant -from Google, Inc. Modified: head/libexec/bootpd/bootpd.8 ============================================================================== --- head/libexec/bootpd/bootpd.8 Sun Mar 25 14:20:43 2012 (r233465) +++ head/libexec/bootpd/bootpd.8 Sun Mar 25 16:00:56 2012 (r233466) @@ -263,9 +263,21 @@ Internet service numbers. Current directory typically used by the TFTP server and .Nm . .El -.Sh BUGS -Individual host entries must not exceed 1024 characters. -.Sh CREDITS +.Sh "SEE ALSO" +.Xr bootptab 5 , +.Xr inetd 8 , +.Xr tftpd 8 +.Pp +DARPA Internet Request For Comments: +.Bl -tag -width RFC1533 -compact +.It RFC951 +Bootstrap Protocol +.It RFC1532 +Clarifications and Extensions for the Bootstrap Protocol +.It RFC1533 +DHCP Options and BOOTP Vendor Extensions +.El +.Sh AUTHORS This distribution is currently maintained by .An Walter L. Wimer Aq walt+@cmu.edu . .Pp @@ -294,17 +306,5 @@ Enhancements and bug-fixes have been con .An Jim McKim Aq mckim@lerc.nasa.gov .An Gordon W. Ross Aq gwr@mc.com .An Jason Zions Aq jazz@hal.com . -.Sh "SEE ALSO" -.Xr bootptab 5 , -.Xr inetd 8 , -.Xr tftpd 8 -.Pp -DARPA Internet Request For Comments: -.Bl -tag -width RFC1533 -compact -.It RFC951 -Bootstrap Protocol -.It RFC1532 -Clarifications and Extensions for the Bootstrap Protocol -.It RFC1533 -DHCP Options and BOOTP Vendor Extensions -.El +.Sh BUGS +Individual host entries must not exceed 1024 characters. Modified: head/share/man/man3/pthread_cond_destroy.3 ============================================================================== --- head/share/man/man3/pthread_cond_destroy.3 Sun Mar 25 14:20:43 2012 (r233465) +++ head/share/man/man3/pthread_cond_destroy.3 Sun Mar 25 16:00:56 2012 (r233466) @@ -44,6 +44,9 @@ The .Fn pthread_cond_destroy function frees the resources allocated by the condition variable .Fa cond . +.Sh IMPLEMENTATION NOTES +A condition variable can be destroyed immediately after all the threads that +are blocked on it are awakened. .Sh RETURN VALUES If successful, the .Fn pthread_cond_destroy @@ -63,9 +66,6 @@ The variable .Fa cond is locked by another thread. .El -.Sh IMPLEMENTATION NOTES -A condition variable can be destroyed immediately after all the threads that -are blocked on it are awakened. .Sh SEE ALSO .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_init 3 , Modified: head/share/man/man4/umcs.4 ============================================================================== --- head/share/man/man4/umcs.4 Sun Mar 25 14:20:43 2012 (r233465) +++ head/share/man/man4/umcs.4 Sun Mar 25 16:00:56 2012 (r233466) @@ -84,9 +84,6 @@ ST Lab U-400 four-port serial USB adapte .Xr tty 4 , .Xr ucom 4 , .Xr usb 4 -.Sh BUGS -This driver doesn't support access to any fine tunes of -chip, like RS522/RS485 mode, non-standard baudrates, etc. .Sh HISTORY The .Nm @@ -99,3 +96,6 @@ The driver was written by .An Lev Serebryakov .Aq lev@FreeBSD.org . +.Sh BUGS +This driver doesn't support access to any fine tunes of +chip, like RS522/RS485 mode, non-standard baudrates, etc. Modified: head/share/man/man4/xnb.4 ============================================================================== --- head/share/man/man4/xnb.4 Sun Mar 25 14:20:43 2012 (r233465) +++ head/share/man/man4/xnb.4 Sun Mar 25 16:00:56 2012 (r233466) @@ -84,6 +84,26 @@ Runs a builtin suite of unit tests and d Does not affect the operation of the driver in any way. Note that the test suite simulates error conditions; this will result in error messages being printed to the system system log. +.Sh SEE ALSO +.Xr arp 4 , +.Xr netintro 4 , +.Xr ng_ether 4 , +.Xr xen 4 , +.Xr ifconfig 8 +.Sh HISTORY +The +.Nm +device driver first appeared in +.Fx 10.0 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Alan Somers +.Aq alans@spectralogic.com +and +.An John Suykerbuyk +.Aq johns@spectralogic.com .Sh CAVEATS Packets sent through Xennet pass over shared memory, so the protocol includes no form of link-layer checksum or CRC. @@ -110,26 +130,6 @@ is bridged to a physcal interface, then disabled on the netfront. The Xennet protocol does not have any mechanism for the netback to request the netfront to do this; the operator must do it manually. -.Sh SEE ALSO -.Xr arp 4 , -.Xr netintro 4 , -.Xr ng_ether 4 , -.Xr xen 4 , -.Xr ifconfig 8 -.Sh HISTORY -The -.Nm -device driver first appeared in -.Fx 10.0 . -.Sh AUTHORS -The -.Nm -driver was written by -.An Alan Somers -.Aq alans@spectralogic.com -and -.An John Suykerbuyk -.Aq johns@spectralogic.com .Sh BUGS The .Nm
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201203251600.q2PG0u4R088855>