Date: Sun, 23 Nov 2014 21:00:00 +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: r274925 - in head: lib/libc/sys lib/libdpv sbin/ipfw share/man/man4 share/man/man4/man4.arm share/man/man9 sys/boot/common sys/boot/i386/gptzfsboot usr.bin/dpv Message-ID: <201411232100.sANL00cG078781@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: joel (doc committer) Date: Sun Nov 23 21:00:00 2014 New Revision: 274925 URL: https://svnweb.freebsd.org/changeset/base/274925 Log: Misc mdoc fixes: - Remove superfluous paragraph macros. - Remove/fix empty or incorrect macros. - Sort sections into conventional order. - Terminate quoted strings properly. - Remove EOL whitespace. Modified: head/lib/libc/sys/poll.2 head/lib/libdpv/dpv.3 head/sbin/ipfw/ipfw.8 head/share/man/man4/gre.4 head/share/man/man4/man4.arm/cgem.4 head/share/man/man4/me.4 head/share/man/man4/netmap.4 head/share/man/man9/get_cyclecount.9 head/share/man/man9/malloc.9 head/share/man/man9/sleepqueue.9 head/sys/boot/common/zfsloader.8 head/sys/boot/i386/gptzfsboot/gptzfsboot.8 head/usr.bin/dpv/dpv.1 Modified: head/lib/libc/sys/poll.2 ============================================================================== --- head/lib/libc/sys/poll.2 Sun Nov 23 19:13:17 2014 (r274924) +++ head/lib/libc/sys/poll.2 Sun Nov 23 21:00:00 2014 (r274925) @@ -180,7 +180,6 @@ specifies a signal mask which is set whi When .Fn ppoll returns, the original signal mask is restored. -.Pp .Bd -literal struct timespec { time_t tv_sec; /* seconds */ Modified: head/lib/libdpv/dpv.3 ============================================================================== --- head/lib/libdpv/dpv.3 Sun Nov 23 19:13:17 2014 (r274924) +++ head/lib/libdpv/dpv.3 Sun Nov 23 21:00:00 2014 (r274925) @@ -502,7 +502,7 @@ This does not effect .Xr Xdialog 1 , which renders the color escape sequences as plain text. See -.Do Li +.Do embedded "\\Z" sequences .Dc in Modified: head/sbin/ipfw/ipfw.8 ============================================================================== --- head/sbin/ipfw/ipfw.8 Sun Nov 23 19:13:17 2014 (r274924) +++ head/sbin/ipfw/ipfw.8 Sun Nov 23 21:00:00 2014 (r274925) @@ -1642,7 +1642,6 @@ be specified as: .Pp Note that the ampersand character has a special meaning in many shells and should generally be escaped. -.Pp .El Note that the order of MAC addresses (destination first, source second) is @@ -1991,7 +1990,7 @@ It may be possible to check what entry w .Ar table-key using .Cm lookup -.Ae table-key +.Ar table-key command. This functionality is optional and may be unsupported in some algorithms. .Pp Modified: head/share/man/man4/gre.4 ============================================================================== --- head/share/man/man4/gre.4 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man4/gre.4 Sun Nov 23 21:00:00 2014 (r274925) @@ -91,7 +91,6 @@ Enables checksum calculation for outgoin Enables use of sequence number field in the GRE header for outgoing packets. .El .Sh EXAMPLES -.Pp .Bd -literal 192.168.1.* --- Router A -------tunnel-------- Router B --- 192.168.2.* \\ / @@ -151,7 +150,6 @@ A description of GRE encapsulation can b .An Andrey V. Elsukov Aq Mt ae@FreeBSD.org .An Heiko W.Rupp Aq Mt hwr@pilhuhn.de .Sh BUGS -.Pp The current implementation uses the key only for outgoing packets. Incoming packets with a different key or without a key will be treated as if they would belong to this interface. Modified: head/share/man/man4/man4.arm/cgem.4 ============================================================================== --- head/share/man/man4/man4.arm/cgem.4 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man4/man4.arm/cgem.4 Sun Nov 23 21:00:00 2014 (r274925) @@ -248,6 +248,23 @@ checksum offloading is enabled. Counter of frames discarded due to an incorrect UDP checksum when checksum offloading is enabled. .El +.Sh SEE ALSO +.Xr miibus 4 , +.Xr ifconfig 8 +.Rs +.%T "Zynq-7000 SoC Technical Reference Manual (Xilinx doc UG585)" +.%U http://www.xilinx.com/support/documentation/user_guides/\:ug585-Zynq-7000-TRM.pdf +.Re +.Sh HISTORY +The +.Nm +device driver first appeared in +.Fx 10.0 . +.Sh AUTHORS +The +.Nm +driver and this manual page was written by +.An Thomas Skibo Aq Mt thomasskibo@yahoo.com . .Sh BUGS The GEM can perform TCP/UDP/IP checksum offloading. However, when transmit checksum offloading is enabled, the GEM generates and @@ -277,21 +294,3 @@ If the bug does not exist in other versi work-around can be disabled by setting the dev.cgem.%d.rxhangwar .Xr sysctl 8 variable to 0. -.Pp -.Sh SEE ALSO -.Xr miibus 4 , -.Xr ifconfig 8 -.Rs -.%T "Zynq-7000 SoC Technical Reference Manual (Xilinx doc UG585)" -.%U http://www.xilinx.com/support/documentation/user_guides/\:ug585-Zynq-7000-TRM.pdf -.Re -.Sh HISTORY -The -.Nm -device driver first appeared in -.Fx 10.0 . -.Sh AUTHORS -The -.Nm -driver and this manual page was written by -.An Thomas Skibo Aq Mt thomasskibo@yahoo.com . Modified: head/share/man/man4/me.4 ============================================================================== --- head/share/man/man4/me.4 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man4/me.4 Sun Nov 23 21:00:00 2014 (r274925) @@ -67,7 +67,6 @@ IP header is modified and the modificati so modified header and the original payload. The protocol number 55 is used for outer header. .Sh NOTES -.Pp For correct operation, the .Nm device needs a route to the decapsulating host that does not run over the tunnel, Modified: head/share/man/man4/netmap.4 ============================================================================== --- head/share/man/man4/netmap.4 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man4/netmap.4 Sun Nov 23 21:00:00 2014 (r274925) @@ -614,7 +614,7 @@ In the example below, "netmap:foo" is an (default) all hardware ring pairs .It NR_REG_SW "netmap:foo^" the ``host rings'', connecting to the host stack. -.It NR_REG_NIC_SW "netmap:foo+ +.It NR_REG_NIC_SW "netmap:foo+" all hardware rings and the host rings .It NR_REG_ONE_NIC "netmap:foo-i" only the i-th hardware ring pair, where the number is in Modified: head/share/man/man9/get_cyclecount.9 ============================================================================== --- head/share/man/man9/get_cyclecount.9 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man9/get_cyclecount.9 Sun Nov 23 21:00:00 2014 (r274925) @@ -77,7 +77,6 @@ and processors use the .Li TSC register. -.Pp .Sh SEE ALSO .Xr binuptime 9 .Sh HISTORY Modified: head/share/man/man9/malloc.9 ============================================================================== --- head/share/man/man9/malloc.9 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man9/malloc.9 Sun Nov 23 21:00:00 2014 (r274925) @@ -208,12 +208,6 @@ one must include .In sys/types.h ) and .In sys/kernel.h . -.Sh IMPLEMENTATION NOTES -The memory allocator allocates memory in chunks that have size a power -of two for requests up to the size of a page of memory. -For larger requests, one or more pages is allocated. -While it should not be relied upon, this information may be useful for -optimizing the efficiency of memory use. .Sh CONTEXT .Fn malloc , .Fn realloc @@ -244,6 +238,12 @@ when holding a .Xr vnode 9 interlock, will cause a LOR (Lock Order Reversal) due to the intertwining of VM Objects and Vnodes. +.Sh IMPLEMENTATION NOTES +The memory allocator allocates memory in chunks that have size a power +of two for requests up to the size of a page of memory. +For larger requests, one or more pages is allocated. +While it should not be relied upon, this information may be useful for +optimizing the efficiency of memory use. .Sh RETURN VALUES The .Fn malloc , Modified: head/share/man/man9/sleepqueue.9 ============================================================================== --- head/share/man/man9/sleepqueue.9 Sun Nov 23 19:13:17 2014 (r274924) +++ head/share/man/man9/sleepqueue.9 Sun Nov 23 21:00:00 2014 (r274925) @@ -246,7 +246,6 @@ allows to pass additional .Fn callout_reset_sbt flags. .Pp -.Pp Once the thread is ready to suspend, one of the wait functions is called to put the current thread to sleep until it is awakened and to context switch to another thread. Modified: head/sys/boot/common/zfsloader.8 ============================================================================== --- head/sys/boot/common/zfsloader.8 Sun Nov 23 19:13:17 2014 (r274924) +++ head/sys/boot/common/zfsloader.8 Sun Nov 23 21:00:00 2014 (r274925) @@ -62,7 +62,6 @@ refers to a ZFS filesystem, then will instruct kernel to use that filesystem as the root filesystem. .Sh ZFS COMMAND EXTENSIONS .Bl -tag -width Ds -compact -.Pp .It Ic lsdev Op Fl v Lists ZFS pools in addition to disks and partitions. Adding @@ -87,11 +86,9 @@ itself. .El .Sh EXAMPLES Set the default device used for loading a kernel from a ZFS filesystem: -.Pp .Bd -literal -offset indent set currdev=zfs:tank/ROOT/knowngood: .Ed -.Pp .Sh SEE ALSO .Xr gptzfsboot 8 , .Xr loader 8 , Modified: head/sys/boot/i386/gptzfsboot/gptzfsboot.8 ============================================================================== --- head/sys/boot/i386/gptzfsboot/gptzfsboot.8 Sun Nov 23 19:13:17 2014 (r274924) +++ head/sys/boot/i386/gptzfsboot/gptzfsboot.8 Sun Nov 23 21:00:00 2014 (r274925) @@ -176,6 +176,9 @@ gpart bootcode -p /boot/gptzfsboot -i 1 .Sh HISTORY .Nm appeared in FreeBSD 7.3. +.Sh AUTHORS +This manual page was written by +.An Andriy Gapon Aq avg@FreeBSD.org . .Sh BUGS .Nm looks for ZFS meta-data only in MBR partitions @@ -188,6 +191,3 @@ found at the fixed offsets relative to a .Nm will recognize the partition as a part of a ZFS pool, but this is not guaranteed to happen. -.Sh AUTHORS -This manual page was written by -.An Andriy Gapon Aq avg@FreeBSD.org . Modified: head/usr.bin/dpv/dpv.1 ============================================================================== --- head/usr.bin/dpv/dpv.1 Sun Nov 23 19:13:17 2014 (r274924) +++ head/usr.bin/dpv/dpv.1 Sun Nov 23 21:00:00 2014 (r274925) @@ -104,7 +104,7 @@ Do not use the default interface of .Xr dialog 3 , but instead spawn an instance of .Xr dialog 1 . -The path to +The path to .Xr dialog 1 is taken from the .Ev DIALOG @@ -308,7 +308,6 @@ is required. .It Pa $HOME/.dialogrc .El .Sh EXAMPLES -.Pp Simple example to show how fast .Xr yes 1 produces lines @@ -358,7 +357,18 @@ Zeroing a disk: .Bd -literal -offset indent dpv -o /dev/md42 < /dev/zero .Ed -.Pp +.Sh SEE ALSO +.Xr dialog 1 , +.Xr dialog 3 , +.Xr sh 1 , +.Xr Xdialog 1 +.Sh HISTORY +A +.Nm +utility first appeared in +.Fx 11.0 . +.Sh AUTHORS +.An Devin Teske Aq dteske@FreeBSD.org .Sh BUGS .Xr Xdialog 1 , when given both @@ -410,21 +420,9 @@ This does not effect .Xr Xdialog 1 , which renders the color escape sequences as plain text. See -.Do Li +.Do embedded "\\Z" sequences .Dc in .Xr dialog 1 for additional information. -.Sh SEE ALSO -.Xr dialog 1 , -.Xr dialog 3 , -.Xr sh 1 , -.Xr Xdialog 1 -.Sh HISTORY -A -.Nm -utility first appeared in -.Fx 11.0 . -.Sh AUTHORS -.An Devin Teske Aq dteske@FreeBSD.org
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201411232100.sANL00cG078781>