From 1ab3783e1a2e5231321a0fc5399736ddc70407f0 Mon Sep 17 00:00:00 2001 From: uqs Date: Thu, 13 May 2010 12:07:55 +0000 Subject: mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the bottom of the manpages and order them consistently. GNU groff doesn't care about the ordering, and doesn't even mention CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put them. Found by: mdocml lint run Reviewed by: ru --- usr.sbin/adduser/adduser.conf.5 | 6 +-- usr.sbin/bluetooth/bthidd/bthidd.8 | 34 ++++++++--------- usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 | 16 ++++---- usr.sbin/cpucontrol/cpucontrol.8 | 4 +- usr.sbin/crunch/crunchgen/crunchgen.1 | 32 ++++++++-------- usr.sbin/mount_portalfs/mount_portalfs.8 | 4 +- usr.sbin/moused/moused.8 | 56 ++++++++++++++-------------- usr.sbin/mtree/mtree.5 | 22 +++++------ usr.sbin/rtprio/rtprio.1 | 6 +-- 9 files changed, 90 insertions(+), 90 deletions(-) (limited to 'usr.sbin') diff --git a/usr.sbin/adduser/adduser.conf.5 b/usr.sbin/adduser/adduser.conf.5 index a78aeea..d5fcf77 100644 --- a/usr.sbin/adduser/adduser.conf.5 +++ b/usr.sbin/adduser/adduser.conf.5 @@ -208,6 +208,9 @@ The .Nm manual page first appeared in .Fx 5.3 . +.Sh AUTHORS +This manual page was written by +.An Tom Rhodes Aq trhodes@FreeBSD.org . .Sh BUGS The internal variables documented here may change without notice. Do not rely on them. @@ -216,6 +219,3 @@ To modify this file invoke with the .Fl C option instead. -.Sh AUTHORS -This manual page was written by -.An Tom Rhodes Aq trhodes@FreeBSD.org . diff --git a/usr.sbin/bluetooth/bthidd/bthidd.8 b/usr.sbin/bluetooth/bthidd/bthidd.8 index 37aaa3d..8dd052e 100644 --- a/usr.sbin/bluetooth/bthidd/bthidd.8 +++ b/usr.sbin/bluetooth/bthidd/bthidd.8 @@ -83,23 +83,6 @@ disconnected Bluetooth HID devices and will attempt to establish an outgoing connection. The default rescan interval is 10 seconds. .El -.Sh CAVEATS -Any Bluetooth HID device that has -.Dv HUP_KEYBOARD -or -.Dv HUP_CONSUMER -entries in its descriptor is considered as -.Dq keyboard . -For each -.Dq keyboard -Bluetooth HID device, -the -.Nm -daemon will use a separate instance of the virtual keyboard interface -.Xr vkbd 4 . -Therefore the -.Xr kbdmux 4 -driver must be used to properly multiplex input from multiple keyboards. .Sh KNOWN LIMITATIONS The .Nm @@ -125,3 +108,20 @@ configuration file is needed as well. .Xr bthidcontrol 8 .Sh AUTHORS .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com +.Sh CAVEATS +Any Bluetooth HID device that has +.Dv HUP_KEYBOARD +or +.Dv HUP_CONSUMER +entries in its descriptor is considered as +.Dq keyboard . +For each +.Dq keyboard +Bluetooth HID device, +the +.Nm +daemon will use a separate instance of the virtual keyboard interface +.Xr vkbd 4 . +Therefore the +.Xr kbdmux 4 +driver must be used to properly multiplex input from multiple keyboards. diff --git a/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 b/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 index e74e113..0588d0c 100644 --- a/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 +++ b/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 @@ -335,14 +335,6 @@ in mode with the .Dq Li rfcomm-client label. -.Sh CAVEATS -The -.Nm -utility in server mode will try to register the Bluetooth LAN Access Over PPP -service with the local SPD daemon. -If the local SDP daemon is not running, -.Nm -will exit with an error. .Sh SEE ALSO .Xr rfcomm_sppd 1 , .Xr bluetooth 3 , @@ -352,3 +344,11 @@ will exit with an error. .Xr sdpd 8 .Sh AUTHORS .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com +.Sh CAVEATS +The +.Nm +utility in server mode will try to register the Bluetooth LAN Access Over PPP +service with the local SPD daemon. +If the local SDP daemon is not running, +.Nm +will exit with an error. diff --git a/usr.sbin/cpucontrol/cpucontrol.8 b/usr.sbin/cpucontrol/cpucontrol.8 index 165e67b..62221c3 100644 --- a/usr.sbin/cpucontrol/cpucontrol.8 +++ b/usr.sbin/cpucontrol/cpucontrol.8 @@ -164,10 +164,10 @@ The .Nm utility first appeared in .Fx 7.2 . -.Sh BUGS -Yes, probably, report if any. .Sh AUTHORS The .Nm utility and this manual page was written by .An Stanislav Sedov Aq stas@FreeBSD.org . +.Sh BUGS +Yes, probably, report if any. diff --git a/usr.sbin/crunch/crunchgen/crunchgen.1 b/usr.sbin/crunch/crunchgen/crunchgen.1 index b7313b9..5dfd0a9 100644 --- a/usr.sbin/crunch/crunchgen/crunchgen.1 +++ b/usr.sbin/crunch/crunchgen/crunchgen.1 @@ -441,6 +441,22 @@ would also need to be copied to the install floppy. .Xr crunchide 1 , .Xr make 1 , .Xr rtld 1 +.Sh AUTHORS +.An -nosplit +The +.Nm +utility was written by +.An James da Silva Aq jds@cs.umd.edu . +.Pp +Copyright (c) 1994 University of Maryland. +All Rights Reserved. +.Pp +The +.Ic libs_so +keyword was added in 2005 by +.An Adrian Steinmann Aq ast@marabu.ch +and +.An Ceri Davies Aq ceri@FreeBSD.org . .Sh CAVEATS While .Nm @@ -459,19 +475,3 @@ The .Dq Li make objs must then be used to get those object files built, or some other arrangements made. -.Sh AUTHORS -.An -nosplit -The -.Nm -utility was written by -.An James da Silva Aq jds@cs.umd.edu . -.Pp -Copyright (c) 1994 University of Maryland. -All Rights Reserved. -.Pp -The -.Ic libs_so -keyword was added in 2005 by -.An Adrian Steinmann Aq ast@marabu.ch -and -.An Ceri Davies Aq ceri@FreeBSD.org . diff --git a/usr.sbin/mount_portalfs/mount_portalfs.8 b/usr.sbin/mount_portalfs/mount_portalfs.8 index ffbcb08..b6ca9cc 100644 --- a/usr.sbin/mount_portalfs/mount_portalfs.8 +++ b/usr.sbin/mount_portalfs/mount_portalfs.8 @@ -207,10 +207,10 @@ ln -s '/p/pipe/usr/local/bin/passwd2xml /etc/passwd' \\ .%O "Berkeley, CA" .%I "Peter Honeyman" .Re -.Sh CAVEATS -This file system may not be NFS-exported. .Sh HISTORY The .Nm utility first appeared in .Bx 4.4 . +.Sh CAVEATS +This file system may not be NFS-exported. diff --git a/usr.sbin/moused/moused.8 b/usr.sbin/moused/moused.8 index 333b247..8a21455 100644 --- a/usr.sbin/moused/moused.8 +++ b/usr.sbin/moused/moused.8 @@ -787,34 +787,6 @@ file, and bind .Pp to a key in your window manager, you can suspend mouse events on your laptop if you keep brushing over the mouse pad while typing. -.Sh CAVEATS -Many pad devices behave as if the first (left) button were pressed if -the user -.Dq taps -the surface of the pad. -In contrast, some ALPS GlidePoint and Interlink VersaPad models -treat the tapping action -as fourth button events. -Use the option -.Dq Fl m Li 1=4 -for these models -to obtain the same effect as the other pad devices. -.Pp -Cut and paste functions in the virtual console assume that there -are three buttons on the mouse. -The logical button 1 (logical left) selects a region of text in the -console and copies it to the cut buffer. -The logical button 3 (logical right) extends the selected region. -The logical button 2 (logical middle) pastes the selected text -at the text cursor position. -If the mouse has only two buttons, the middle, `paste' button -is not available. -To obtain the paste function, use the -.Fl 3 -option to emulate the middle button, or use the -.Fl m -option to assign the physical right button to the logical middle button: -.Dq Fl m Li 2=3 . .Sh SEE ALSO .Xr kill 1 , .Xr vidcontrol 1 , @@ -852,3 +824,31 @@ This manual page was written by .An Mike Pritchard Aq mpp@FreeBSD.org . The command and manual page have since been updated by .An Kazutaka Yokota Aq yokota@FreeBSD.org . +.Sh CAVEATS +Many pad devices behave as if the first (left) button were pressed if +the user +.Dq taps +the surface of the pad. +In contrast, some ALPS GlidePoint and Interlink VersaPad models +treat the tapping action +as fourth button events. +Use the option +.Dq Fl m Li 1=4 +for these models +to obtain the same effect as the other pad devices. +.Pp +Cut and paste functions in the virtual console assume that there +are three buttons on the mouse. +The logical button 1 (logical left) selects a region of text in the +console and copies it to the cut buffer. +The logical button 3 (logical right) extends the selected region. +The logical button 2 (logical middle) pastes the selected text +at the text cursor position. +If the mouse has only two buttons, the middle, `paste' button +is not available. +To obtain the paste function, use the +.Fl 3 +option to emulate the middle button, or use the +.Fl m +option to assign the physical right button to the logical middle button: +.Dq Fl m Li 2=3 . diff --git a/usr.sbin/mtree/mtree.5 b/usr.sbin/mtree/mtree.5 index 8f17d90..8962e5f 100644 --- a/usr.sbin/mtree/mtree.5 +++ b/usr.sbin/mtree/mtree.5 @@ -228,17 +228,6 @@ socket .Xr cksum 1 , .Xr find 1 , .Xr mtree 8 -.Sh BUGS -The -.Fx -implementation of mtree does not currently support -the -.Nm -2.0 -format. -The requirement for a -.Dq #mtree -signature line is new and not yet widely implemented. .Sh HISTORY The .Nm @@ -270,3 +259,14 @@ The .Dq full entry format was added by .Nx . +.Sh BUGS +The +.Fx +implementation of mtree does not currently support +the +.Nm +2.0 +format. +The requirement for a +.Dq #mtree +signature line is new and not yet widely implemented. diff --git a/usr.sbin/rtprio/rtprio.1 b/usr.sbin/rtprio/rtprio.1 index 3141fba..567a1c4 100644 --- a/usr.sbin/rtprio/rtprio.1 +++ b/usr.sbin/rtprio/rtprio.1 @@ -161,9 +161,6 @@ The utility appeared in .Fx 2.0 , but is similar to the HP-UX version. -.Sh CAVEATS -You can lock yourself out of the system by placing a cpu-heavy -process in a realtime priority. .Sh AUTHORS .An -nosplit .An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk @@ -173,6 +170,9 @@ implementation in .Fx was substantially rewritten by .An David Greenman . +.Sh CAVEATS +You can lock yourself out of the system by placing a cpu-heavy +process in a realtime priority. .Sh BUGS There is no way to set/view the realtime priority of process 0 (swapper) (see -- cgit v1.1