From owner-freebsd-doc@FreeBSD.ORG Sun May 13 02:40:05 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4C590106566B for ; Sun, 13 May 2012 02:40:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1793C8FC0C for ; Sun, 13 May 2012 02:40:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4D2e4ME092177 for ; Sun, 13 May 2012 02:40:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4D2e4mD092176; Sun, 13 May 2012 02:40:04 GMT (envelope-from gnats) Resent-Date: Sun, 13 May 2012 02:40:04 GMT Resent-Message-Id: <201205130240.q4D2e4mD092176@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Peter Jeremy Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id CEE07106566B for ; Sun, 13 May 2012 02:39:08 +0000 (UTC) (envelope-from peter@rulingia.com) Received: from mail34.syd.optusnet.com.au (mail34.syd.optusnet.com.au [211.29.133.218]) by mx1.freebsd.org (Postfix) with ESMTP id 2BFA38FC0A for ; Sun, 13 May 2012 02:39:07 +0000 (UTC) Received: from server.rulingia.com (c220-239-254-65.belrs5.nsw.optusnet.com.au [220.239.254.65]) by mail34.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id q4D2d4jQ017055 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sun, 13 May 2012 12:39:05 +1000 Received: from server.rulingia.com (localhost.rulingia.com [127.0.0.1]) by server.rulingia.com (8.14.5/8.14.5) with ESMTP id q4D2d2iP077889; Sun, 13 May 2012 12:39:02 +1000 (EST) (envelope-from peter@server.rulingia.com) Received: (from peter@localhost) by server.rulingia.com (8.14.5/8.14.5/Submit) id q4D2d2W0077886; Sun, 13 May 2012 12:39:02 +1000 (EST) (envelope-from peter) Message-Id: <201205130239.q4D2d2W0077886@server.rulingia.com> Date: Sun, 13 May 2012 12:39:02 +1000 (EST) From: Peter Jeremy To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/167832: [patch] swapon(2) (and elsewhere) refer to non-existent block devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Peter Jeremy List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 May 2012 02:40:05 -0000 >Number: 167832 >Category: docs >Synopsis: [patch] swapon(2) (and elsewhere) refer to non-existent block devices >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun May 13 02:40:04 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Peter Jeremy >Release: FreeBSD 8.2-STABLE amd64 >Organization: n/a >Environment: System: FreeBSD server.rulingia.com 8.2-STABLE FreeBSD 8.2-STABLE #15: Thu Feb 2 11:02:29 EST 2012 root@server.vk2pj.dyndns.org:/var/obj/usr/src/sys/server amd64 Same issues still exist in head. >Description: swapon(2) states "The swapon() system call makes the block device special available to the system" but block devices haven't existed in FreeBSD for something like a decade. There's a similar error in the description of the ENOTBLK error. Looking further, I've found lots of similar references to block devices. >How-To-Repeat: man 2 swapon intro mount >Fix: In all 3 man pages, what is actually wanted is a disk device - either real or virtual via md(4). The following patches use "disk" in place of "block" for all relevant non-contrib references. Note that I am unclear of the correct fix to: tools/debugscripts/gdbinit.kernel share/man/man4/xen.4 share/man/man4/virtio_blk.4 share/man/man9/vnode.9 Index: sys/sys/errno.h =================================================================== --- sys/sys/errno.h (revision 235336) +++ sys/sys/errno.h (working copy) @@ -62,7 +62,7 @@ #define EACCES 13 /* Permission denied */ #define EFAULT 14 /* Bad address */ #ifndef _POSIX_SOURCE -#define ENOTBLK 15 /* Block device required */ +#define ENOTBLK 15 /* Disk device required */ #endif #define EBUSY 16 /* Device busy */ #define EEXIST 17 /* File exists */ Index: sys/security/audit/audit_bsm_errno.c =================================================================== --- sys/security/audit/audit_bsm_errno.c (revision 235336) +++ sys/security/audit/audit_bsm_errno.c (working copy) @@ -97,7 +97,7 @@ { BSM_ERRNO_ENOMEM, ENOMEM, ES("Cannot allocate memory") }, { BSM_ERRNO_EACCES, EACCES, ES("Permission denied") }, { BSM_ERRNO_EFAULT, EFAULT, ES("Bad address") }, - { BSM_ERRNO_ENOTBLK, ENOTBLK, ES("Block device required") }, + { BSM_ERRNO_ENOTBLK, ENOTBLK, ES("Disk device required") }, { BSM_ERRNO_EBUSY, EBUSY, ES("Device busy") }, { BSM_ERRNO_EEXIST, EEXIST, ES("File exists") }, { BSM_ERRNO_EXDEV, EXDEV, ES("Cross-device link") }, Index: lib/libgeom/geom_util.c =================================================================== --- lib/libgeom/geom_util.c (revision 235336) +++ lib/libgeom/geom_util.c (working copy) @@ -45,7 +45,7 @@ static char *g_device_path_open(const char *, int *, int); /* - * Open the given provider and at least check if this is a block device. + * Open the given provider and at least check if this is a disk device. */ int g_open(const char *name, int dowrite) Index: lib/libufs/block.c =================================================================== --- lib/libufs/block.c (revision 235336) +++ lib/libufs/block.c (working copy) @@ -71,15 +71,15 @@ } cnt = pread(disk->d_fd, p2, size, (off_t)(blockno * disk->d_bsize)); if (cnt == -1) { - ERROR(disk, "read error from block device"); + ERROR(disk, "read error from disk device"); goto fail; } if (cnt == 0) { - ERROR(disk, "end of file from block device"); + ERROR(disk, "end of file from disk device"); goto fail; } if ((size_t)cnt != size) { - ERROR(disk, "short read or read error from block device"); + ERROR(disk, "short read or read error from disk device"); goto fail; } if (p2 != data) { @@ -128,11 +128,11 @@ if (p2 != NULL) free(p2); if (cnt == -1) { - ERROR(disk, "write error to block device"); + ERROR(disk, "write error to disk device"); return (-1); } if ((size_t)cnt != size) { - ERROR(disk, "short write to block device"); + ERROR(disk, "short write to disk device"); return (-1); } Index: lib/libc/sys/mount.2 =================================================================== --- lib/libc/sys/mount.2 (revision 235336) +++ lib/libc/sys/mount.2 (working copy) @@ -279,7 +279,7 @@ The .Fa fspec argument -is not a block device. +is not a disk device. .It Bq Er ENXIO The major device number of .Fa fspec Index: lib/libc/sys/swapon.2 =================================================================== --- lib/libc/sys/swapon.2 (revision 235336) +++ lib/libc/sys/swapon.2 (working copy) @@ -46,7 +46,7 @@ The .Fn swapon system call -makes the block device +makes the disk device .Fa special available to the system for allocation for paging and swapping. @@ -106,7 +106,7 @@ The .Fa special argument -is not a block device. +is not a disk device. .It Bq Er EBUSY The device specified by .Fa special Index: lib/libc/sys/intro.2 =================================================================== --- lib/libc/sys/intro.2 (revision 235336) +++ lib/libc/sys/intro.2 (working copy) @@ -156,8 +156,12 @@ .It Er 14 EFAULT Em "Bad address" . The system detected an invalid address in attempting to use an argument of a call. -.It Er 15 ENOTBLK Em "Block device required" . -A block device operation was attempted on a non-block device or file. +.It Er 15 ENOTBLK Em "Disk device required" . +A disk device operation was attempted on a non-disk device or file. +Disk devices include both physical disks and virtual disks created +using the +.Xr md 4 +device. .It Er 16 EBUSY Em "Device busy" . An attempt to use a system resource which was in use at the time in a manner which would have conflicted with the request. Index: lib/libc/gen/errlst.c =================================================================== --- lib/libc/gen/errlst.c (revision 235336) +++ lib/libc/gen/errlst.c (working copy) @@ -51,7 +51,7 @@ "Cannot allocate memory", /* 12 - ENOMEM */ "Permission denied", /* 13 - EACCES */ "Bad address", /* 14 - EFAULT */ - "Block device required", /* 15 - ENOTBLK */ + "Disk device required", /* 15 - ENOTBLK */ "Device busy", /* 16 - EBUSY */ "File exists", /* 17 - EEXIST */ "Cross-device link", /* 18 - EXDEV */ Index: lib/libc/nls/C.msg =================================================================== --- lib/libc/nls/C.msg (revision 235336) +++ lib/libc/nls/C.msg (working copy) @@ -34,7 +34,7 @@ $ EFAULT 14 Bad address $ ENOTBLK -15 Block device required +15 Disk device required $ EBUSY 16 Device busy $ EEXIST Index: share/examples/mdoc/example.9 =================================================================== --- share/examples/mdoc/example.9 (revision 235336) +++ share/examples/mdoc/example.9 (working copy) @@ -146,7 +146,7 @@ .It Bq Er EFAULT Bad address. .It Bq Er ENOTBLK -Block device required. +Disk device required. .It Bq Er EBUSY Device busy. .It Bq Er EEXIST Index: share/examples/mdoc/example.3 =================================================================== --- share/examples/mdoc/example.3 (revision 235336) +++ share/examples/mdoc/example.3 (working copy) @@ -133,7 +133,7 @@ .It Bq Er EFAULT Bad address. .It Bq Er ENOTBLK -Block device required. +Disk device required. .It Bq Er EBUSY Device busy. .It Bq Er EEXIST Index: share/man/man4/mmcsd.4 =================================================================== --- share/man/man4/mmcsd.4 (revision 235336) +++ share/man/man4/mmcsd.4 (working copy) @@ -35,7 +35,7 @@ .Sh DESCRIPTION The .Nm -driver implements direct access block device for MMC and SD memory cards. +driver implements direct access disk device for MMC and SD memory cards. .Sh SEE ALSO .Xr mmc 4 , .Xr at91_mci 4 , Index: share/man/man4/arcmsr.4 =================================================================== --- share/man/man4/arcmsr.4 (revision 235336) +++ share/man/man4/arcmsr.4 (working copy) @@ -137,7 +137,7 @@ .Sh FILES .Bl -tag -width ".Pa /dev/arcmsr?" -compact .It Pa /dev/da? -Array block device +Array disk device .It Pa /dev/arcmsr? Management interface .El Index: sys/security/audit/audit_bsm_errno.c =================================================================== --- sys/security/audit/audit_bsm_errno.c (revision 235336) +++ sys/security/audit/audit_bsm_errno.c (working copy) @@ -97,7 +97,7 @@ { BSM_ERRNO_ENOMEM, ENOMEM, ES("Cannot allocate memory") }, { BSM_ERRNO_EACCES, EACCES, ES("Permission denied") }, { BSM_ERRNO_EFAULT, EFAULT, ES("Bad address") }, - { BSM_ERRNO_ENOTBLK, ENOTBLK, ES("Block device required") }, + { BSM_ERRNO_ENOTBLK, ENOTBLK, ES("Disk device required") }, { BSM_ERRNO_EBUSY, EBUSY, ES("Device busy") }, { BSM_ERRNO_EEXIST, EEXIST, ES("File exists") }, { BSM_ERRNO_EXDEV, EXDEV, ES("Cross-device link") }, Index: sys/xen/interface/io/blkif.h =================================================================== --- sys/xen/interface/io/blkif.h (revision 235336) +++ sys/xen/interface/io/blkif.h (working copy) @@ -178,7 +178,7 @@ * Default Value: 0 * Notes: 4, 5 * - * The offset, in bytes from the beginning of the virtual block device, + * The offset, in bytes from the beginning of the virtual disk device, * to the first, addressable, discard extent on the underlying device. * * discard-granularity Index: sys/ufs/ufs/ufsmount.h =================================================================== --- sys/ufs/ufs/ufsmount.h (revision 235336) +++ sys/ufs/ufs/ufsmount.h (working copy) @@ -69,7 +69,7 @@ struct cdev *um_dev; /* device mounted */ struct g_consumer *um_cp; struct bufobj *um_bo; /* Buffer cache object */ - struct vnode *um_devvp; /* block device mounted vnode */ + struct vnode *um_devvp; /* disk device mounted vnode */ u_long um_fstype; /* type of filesystem */ struct fs *um_fs; /* pointer to superblock */ struct ufs_extattr_per_mount um_extattr; /* extended attrs */ Index: sys/ufs/ffs/ffs_vnops.c =================================================================== --- sys/ufs/ffs/ffs_vnops.c (revision 235336) +++ sys/ufs/ffs/ffs_vnops.c (working copy) @@ -308,7 +308,7 @@ /* Drain IO to see if we're done. */ bufobj_wwait(bo, 0, 0); /* - * Block devices associated with filesystems may have new I/O + * Disk devices associated with filesystems may have new I/O * requests posted for them even if the vnode is locked, so no * amount of trying will get them clean. We make several passes * as a best effort. Index: sys/ufs/ffs/ffs_softdep.c =================================================================== --- sys/ufs/ffs/ffs_softdep.c (revision 235336) +++ sys/ufs/ffs/ffs_softdep.c (working copy) @@ -1821,7 +1821,7 @@ struct ufsmount *ump; /* - * Alternately flush the block device associated with the mount + * Alternately flush the disk device associated with the mount * point and process any dependencies that the flushing * creates. We continue until no more worklist dependencies * are found. @@ -11848,7 +11848,7 @@ } /* - * Flush all the dirty bitmaps associated with the block device + * Flush all the dirty bitmaps associated with the disk device * before flushing the rest of the dirty blocks so as to reduce * the number of dependencies that will have to be rolled back. * Index: sys/fs/ext2fs/ext2_mount.h =================================================================== --- sys/fs/ext2fs/ext2_mount.h (revision 235336) +++ sys/fs/ext2fs/ext2_mount.h (working copy) @@ -45,7 +45,7 @@ struct ext2mount { struct mount *um_mountp; /* filesystem vfs structure */ struct cdev *um_dev; /* device mounted */ - struct vnode *um_devvp; /* block device mounted vnode */ + struct vnode *um_devvp; /* disk device mounted vnode */ struct m_ext2fs *um_e2fs; /* EXT2FS */ #define em_e2fsb um_e2fs->e2fs Index: sys/fs/ntfs/ntfs_vfsops.c =================================================================== --- sys/fs/ntfs/ntfs_vfsops.c (revision 235336) +++ sys/fs/ntfs/ntfs_vfsops.c (working copy) @@ -183,7 +183,7 @@ /* * Not an update, or updating the name: look up the name - * and verify that it refers to a sensible block device. + * and verify that it refers to a sensible disk device. */ NDINIT(&ndp, LOOKUP, FOLLOW | LOCKLEAF, UIO_SYSSPACE, from, td); err = namei(&ndp); Index: sys/fs/ntfs/ntfs.h =================================================================== --- sys/fs/ntfs/ntfs.h (revision 235336) +++ sys/fs/ntfs/ntfs.h (working copy) @@ -244,7 +244,7 @@ struct bootfile ntm_bootfile; struct g_consumer *ntm_cp; struct bufobj *ntm_bo; - struct vnode *ntm_devvp; /* block device mounted vnode */ + struct vnode *ntm_devvp; /* disk device mounted vnode */ struct vnode *ntm_sysvn[NTFS_SYSNODESNUM]; u_int32_t ntm_bpmftrec; uid_t ntm_uid; Index: sys/fs/cd9660/cd9660_vfsops.c =================================================================== --- sys/fs/cd9660/cd9660_vfsops.c (revision 235336) +++ sys/fs/cd9660/cd9660_vfsops.c (working copy) @@ -156,7 +156,7 @@ } /* * Not an update, or updating the name: look up the name - * and verify that it refers to a sensible block device. + * and verify that it refers to a sensible disk device. */ NDINIT(&ndp, LOOKUP, FOLLOW | LOCKLEAF, UIO_SYSSPACE, fspec, td); if ((error = namei(&ndp))) Index: sys/fs/hpfs/hpfs_vfsops.c =================================================================== --- sys/fs/hpfs/hpfs_vfsops.c (revision 235336) +++ sys/fs/hpfs/hpfs_vfsops.c (working copy) @@ -156,7 +156,7 @@ /* * Not an update, or updating the name: look up the name - * and verify that it refers to a sensible block device. + * and verify that it refers to a sensible disk device. */ NDINIT(&ndp, LOOKUP, FOLLOW | LOCKLEAF, UIO_SYSSPACE, from, td); err = namei(&ndp); Index: sys/kern/vfs_subr.c =================================================================== --- sys/kern/vfs_subr.c (revision 235336) +++ sys/kern/vfs_subr.c (working copy) @@ -198,7 +198,7 @@ * not waste disk bandwidth being created and removed. To realize this, * we append vnodes to a "workitem" queue. When running with a soft * updates implementation, most pending metadata dependencies should - * not wait for more than a few seconds. Thus, mounted on block devices + * not wait for more than a few seconds. Thus, mounted on disk devices * are delayed only about a half the time that file data is delayed. * Similarly, directory updates are more critical, so are only delayed * about a third the time that file data is delayed. Thus, there are Index: sys/powerpc/powerpc/dump_machdep.c =================================================================== --- sys/powerpc/powerpc/dump_machdep.c (revision 235336) +++ sys/powerpc/powerpc/dump_machdep.c (working copy) @@ -241,7 +241,7 @@ dumpsize += fileofs; hdrgap = fileofs - DEV_ALIGN(hdrsz); - /* For block devices, determine the dump offset on the device. */ + /* For disk devices, determine the dump offset on the device. */ if (di->mediasize > 0) { if (di->mediasize < SIZEOF_METADATA + dumpsize + sizeof(kdh) * 2) { Index: sys/mips/include/param.h =================================================================== --- sys/mips/include/param.h (revision 235336) +++ sys/mips/include/param.h (working copy) @@ -170,7 +170,7 @@ #define dtoc(x) ((x) >> (PAGE_SHIFT - DEV_BSHIFT)) /* - * Map a ``block device block'' to a file system block. + * Map a ``disk device block'' to a file system block. * This should be device dependent, and should use the bsize * field from the disk label. * For now though just use DEV_BSIZE. Index: sys/conf/NOTES =================================================================== --- sys/conf/NOTES (revision 235336) +++ sys/conf/NOTES (working copy) @@ -112,9 +112,9 @@ options DFLDSIZ=(1024UL*1024*1024) # -# BLKDEV_IOSIZE sets the default block size used in user block +# BLKDEV_IOSIZE sets the default block size used in user disk # device I/O. Note that this value will be overridden by the label -# when specifying a block device from a label with a non-0 +# when specifying a disk device from a label with a non-0 # partition blocksize. The default is PAGE_SIZE. # options BLKDEV_IOSIZE=8192 @@ -122,7 +122,7 @@ # # MAXPHYS and DFLTPHYS # -# These are the maximal and safe 'raw' I/O block device access sizes. +# These are the maximal and safe 'raw' I/O disk device access sizes. # Reads and writes will be split into MAXPHYS chunks for known good # devices and DFLTPHYS for the rest. Some applications have better # performance with larger raw I/O access sizes. Note that certain VM Index: sys/pc98/cbus/fdc.c =================================================================== --- sys/pc98/cbus/fdc.c (revision 235336) +++ sys/pc98/cbus/fdc.c (working copy) @@ -1291,7 +1291,7 @@ } /* - * Block device driver interface functions (interspersed with even more + * Disk device driver interface functions (interspersed with even more * auxiliary functions). */ static int Index: sys/sys/param.h =================================================================== --- sys/sys/param.h (revision 235336) +++ sys/sys/param.h (working copy) @@ -139,7 +139,7 @@ #define DEV_BSIZE (1<Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun May 13 22:22:22 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DDA4C106566B; Sun, 13 May 2012 22:22:22 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B12748FC0A; Sun, 13 May 2012 22:22:22 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4DMMMBW027415; Sun, 13 May 2012 22:22:22 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4DMMMwo027411; Sun, 13 May 2012 22:22:22 GMT (envelope-from eadler) Date: Sun, 13 May 2012 22:22:22 GMT Message-Id: <201205132222.q4DMMMwo027411@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/167832: [patch] swapon(2) (and elsewhere) refer to non-existent block devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 May 2012 22:22:23 -0000 Synopsis: [patch] swapon(2) (and elsewhere) refer to non-existent block devices Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Sun May 13 22:22:22 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=167832 From owner-freebsd-doc@FreeBSD.ORG Sun May 13 22:22:26 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 566441065674; Sun, 13 May 2012 22:22:26 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2AE598FC14; Sun, 13 May 2012 22:22:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4DMMPHr027481; Sun, 13 May 2012 22:22:25 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4DMMPoY027477; Sun, 13 May 2012 22:22:25 GMT (envelope-from eadler) Date: Sun, 13 May 2012 22:22:25 GMT Message-Id: <201205132222.q4DMMPoY027477@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/163742: [patch] document failok mount(8) option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 May 2012 22:22:26 -0000 Synopsis: [patch] document failok mount(8) option Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Sun May 13 22:22:24 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=163742 From owner-freebsd-doc@FreeBSD.ORG Mon May 14 08:40:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 61DC71065672 for ; Mon, 14 May 2012 08:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 334CC8FC15 for ; Mon, 14 May 2012 08:40:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4E8e2Bm012773 for ; Mon, 14 May 2012 08:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4E8e2CJ012772; Mon, 14 May 2012 08:40:02 GMT (envelope-from gnats) Resent-Date: Mon, 14 May 2012 08:40:02 GMT Resent-Message-Id: <201205140840.q4E8e2CJ012772@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Alberto Villa Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 9CE68106566B for ; Mon, 14 May 2012 08:33:53 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 8640D8FC08 for ; Mon, 14 May 2012 08:33:53 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q4E8Xrs6099815 for ; Mon, 14 May 2012 08:33:53 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q4E8XrGQ099781; Mon, 14 May 2012 08:33:53 GMT (envelope-from nobody) Message-Id: <201205140833.q4E8XrGQ099781@red.freebsd.org> Date: Mon, 14 May 2012 08:33:53 GMT From: Alberto Villa To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/167864: [patch] Update KDE documentation in Handbook and Porter's Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 08:40:02 -0000 >Number: 167864 >Category: docs >Synopsis: [patch] Update KDE documentation in Handbook and Porter's Handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon May 14 08:40:01 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Alberto Villa >Release: >Organization: >Environment: >Description: KDE documentation is quite outdated both in the Handbook and in the Porter's Handbook. The attached patch updates it and cleans it up, and fixes a serious documentation bug within the KDM section. >How-To-Repeat: >Fix: Patch attached with submission follows: Index: handbook/x11/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v retrieving revision 1.212 diff -u -r1.212 chapter.sgml --- handbook/x11/chapter.sgml 16 Feb 2012 05:06:57 -0000 1.212 +++ handbook/x11/chapter.sgml 14 May 2012 08:30:41 -0000 @@ -1323,9 +1323,9 @@ Several replacements for the default XDM program exist. One of them, - kdm (bundled with + KDM (bundled with KDE) is described later in this - chapter. The kdm display manager offers many visual + chapter. The KDM display manager offers many visual improvements and cosmetic frills, as well as the functionality to allow users to choose their window manager of choice at login time. @@ -1460,7 +1460,7 @@ Yet another option is to configure the display manager to allow choosing the window manager at login time; the section on KDE details - explains how to do this for kdm, the + explains how to do this for KDM, the display manager of KDE. @@ -1504,7 +1504,7 @@ Internationalization: KDE - is available in more than 40 languages + is available in more than 55 languages @@ -1525,13 +1525,15 @@ can be found on the KDE website. For FreeBSD specific information and resources on KDE, consult - the KDE on FreeBSD - team's website. + the KDE/FreeBSD + initiative's website. - There are two versions of KDE available on FreeBSD. Version 3 - has been around for a long time, and is very mature. Version 4, - the next generation, is also available in the Ports Collection. - They can even be installed side by side. + There are two versions of KDE available + on FreeBSD. Version 3 has been around for a long time, and is still + available in the Ports Collection though it's now unmaintained and + partially broken. Version 4 is punctually updated and is the default + choice for KDE users. They can even be + installed side by side. @@ -1541,12 +1543,12 @@ other desktop environment, the software can be easily installed from a package or the Ports Collection: - To install the KDE3 package + To install the KDE 3 package from the network, simply type: &prompt.root; pkg_add -r kde - To install the KDE4 package + To install the KDE 4 package from the network, simply type: &prompt.root; pkg_add -r kde4 @@ -1554,13 +1556,13 @@ &man.pkg.add.1; will automatically fetch the latest version of the application. - To build KDE3 from source, + To build KDE 3 from source, use the ports tree: &prompt.root; cd /usr/ports/x11/kde3 &prompt.root; make install clean - To build KDE4 from source, + To build KDE 4 from source, use the ports tree: &prompt.root; cd /usr/ports/x11/kde4 @@ -1571,12 +1573,12 @@ instead of the default window manager. This is accomplished by editing the .xinitrc file: - For KDE3: - + For KDE 3: + &prompt.user; echo "exec startkde" > ~/.xinitrc - For KDE4: - + For KDE 4: + &prompt.user; echo "exec /usr/local/kde4/bin/startkde" > ~/.xinitrc Now, whenever the X Window System is invoked with @@ -1587,7 +1589,7 @@ XDM is being used, the configuration is slightly different. Edit the .xsession file instead. Instructions - for kdm are described later in + for KDM are described later in this chapter. @@ -1618,28 +1620,28 @@ XDM can be used, as described earlier. However, KDE includes an - alternative, kdm, which is designed + alternative, KDM, which is designed to look more attractive and include more login-time options. In particular, users can easily choose (via a menu) which desktop environment (KDE, GNOME, or something else) to run after logging on. - To enable kdm, different files + To enable KDM, different files need to be edited depending on the version of KDE. - For KDE3, the ttyv8 + For KDE 3, the ttyv8 entry in /etc/ttys has to be adapted as follows: ttyv8 "/usr/local/bin/kdm -nodaemon" xterm on secure - For KDE4, you have to add the - following lines to /etc/rc.conf: + For KDE 4, you have to mount + &man.procfs.5; and add the following line to + /etc/rc.conf: - local_startup="${local_startup} /usr/local/kde4/etc/rc.d" -kdm4_enable="YES" + kdm4_enable="YES" Index: porters-handbook/book.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1186 diff -u -r1.1186 book.sgml --- porters-handbook/book.sgml 2 May 2012 10:21:37 -0000 1.1186 +++ porters-handbook/book.sgml 14 May 2012 08:30:44 -0000 @@ -1742,8 +1742,7 @@ kde* Ports from the K Desktop Environment - (KDE) Project. + url="http://www.kde.org">KDE Project. @@ -6004,7 +6003,8 @@ QTNONSTANDARD Suppress modification of CONFIGURE_ENV, - CONFIGURE_ARGS, and + CONFIGURE_ARGS, + CPPFLAGS and MAKE_ENV. @@ -6019,30 +6019,26 @@ QT_COMPONENTS - Specify tool and library dependencies for Qt4. + Specify tool and library dependencies for Qt 4. See below for details. UIC Set to the path of uic - (read-only variable). Default set according to - USE_QT_VER value. + (read-only variable). QMAKE Set to the path of qmake - (read-only variable). Default set according to - USE_QT_VER value. + (read-only variable). QMAKESPEC Set to the path of configuration file for - qmake (read-only variable). - Default set according to - USE_QT_VER value. + qmake (read-only variable). @@ -6056,8 +6052,9 @@ --with-qt-libraries=${QT_PREFIX}/lib \ --with-extra-libs=${LOCALBASE}/lib \ --with-extra-includes=${LOCALBASE}/include -CONFIGURE_ENV+= MOC="${MOC}" CPPFLAGS="${CPPFLAGS} ${QTCPPFLAGS}" LIBS="${QTCFGLIBS}" \ - QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}" +CONFIGURE_ENV+= MOC="${MOC}" LIBS="${QTCFGLIBS}" \ + QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}" +CPPFLAGS+= ${QTCPPFLAGS} If USE_QT_VER is set to 4, the following settings are also @@ -6070,8 +6067,8 @@ Component Selection (Qt 4.x Only) - When USE_QT_VER is set to 4, - individual Qt4 tool and library dependencies can be + When USE_QT_VER is set to 4, + individual Qt 4 tool and library dependencies can be specified in the QT_COMPONENTS variable. Every component can be suffixed by either _build or _run, the @@ -6088,7 +6085,7 @@ /usr/ports/Mk/bsd.qt.mk): - Available Qt4 Library Components + Available Qt 4 Library Components @@ -6122,7 +6119,7 @@ qt3support - Qt3 compatibility library + Qt 3 compatibility library @@ -6154,7 +6151,7 @@ executable after a successful compilation.
- Available Qt4 Tool Components + Available Qt 4 Tool Components @@ -6178,7 +6175,7 @@ rcc - resource compiler (need if the application + resource compiler (needed if the application comes with *.rc or *.qrc files) @@ -6195,7 +6192,7 @@
- Available Qt4 Plugin Components + Available Qt 4 Plugin Components @@ -6223,17 +6220,18 @@
- Selecting Qt4 Components + Selecting Qt 4 Components - In this example, the ported application uses the Qt4 - graphical user interface library, the Qt4 core library, - all of the Qt4 code generation tools and Qt4's Makefile - generator. Since the gui library implies a dependency on - the core library, corelib does not need to be specified. - The Qt4 code generation tools moc, uic and rcc, as well as - the Makefile generator qmake are only needed at buildtime, - thus they are specified with the _build - suffix: + In this example, the ported application uses the Qt 4 + graphical user interface library, the Qt 4 core library, + all of the Qt 4 code generation tools and Qt 4's Makefile + generator. Since the gui library implies + a dependency on the core library, corelib + does not need to be specified. The Qt 4 code generation tools + moc, uic and + rcc, as well as the Makefile generator + qmake are only needed at buildtime, thus they + are specified with the _build suffix: USE_QT_VER= 4 QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build @@ -6252,7 +6250,7 @@ do-configure: @cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \ - ${QMAKE} -unix PREFIX=${PREFIX} texmaker.pro + ${QMAKE} PREFIX=${PREFIX} texmaker.pro Note the similarity to the qmake line from the provided BUILD.sh script. @@ -6271,14 +6269,14 @@ Missing additional - includepaths. Many applications come with + include paths. Many applications come with system tray icon support, but neglect to look for includes and/or libraries in the X11 directories. You can tell qmake to add directories to - the include and library searchpaths via the command + the include and library search paths via the command line, for example: - ${QMAKE} -unix PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ + ${QMAKE} PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \ LIBS+=-L${LOCALBASE}/lib sillyapp.pro @@ -6287,12 +6285,12 @@ Sometimes data such as icons or .desktop files are by default installed into directories which aren't scanned by XDG-compatible applications. editors/texmaker is an + role="package">editors/texmaker is an example for this - look at patch-texmaker.pro in the files directory of that port for a - template on how to remedy this directly in the Qmake - project file. + template on how to remedy this directly in the + qmake project file. @@ -6336,13 +6334,18 @@ If your application depends on KDE 4.x, set USE_KDE4 to the list of required - components. The most commonly used components are listed - below (up-to-date components are listed in - _USE_KDE4_ALL in + components. _build and _run + suffixes can be used to force components dependency type + (e.g., baseapps_run). If no suffix is set, + a default dependency type will be used. If you want to force + both types, add the component twice with both suffixes + (e.g., automoc4_build automoc4_run). + The most commonly used components are listed below (up-to-date + components are documented at the top of /usr/ports/Mk/bsd.kde4.mk): - Available KDE4 Components + Available KDE 4 Components @@ -6354,36 +6357,18 @@ - akonadi - Personal information management (PIM) storage - service - - - - automoc4 - Makes port use automoc4 build tool - - - - kdebase - Basic KDE applications (Konqueror, Dolphin, - Konsole) - - - - kdeexp - Experimental KDE libraries (with non-stable - API) + baseapps + Basic applications for KDE Desktop kdehier - Provides common KDE directories + Hierarchy of common KDE directories kdelibs - The base set of KDE libraries + KDE Developer Platform @@ -6395,60 +6380,58 @@ pimlibs - PIM libraries + KDE-Pim libraries workspace - Applications and libraries which form desktop - (Plasma, KWin) + KDE user environments + + + + akonadi + Storage server for KDE-Pim + + + + automoc4 + Automatic moc for Qt 4 packages
KDE 4.x ports are installed into - ${KDE4_PREFIX}, which is + KDE4_PREFIX, which is /usr/local/kde4 currently, to avoid conflicts with KDE 3.x ports. This is achieved by specifying the kdeprefix component, which overrides the default PREFIX. The ports however respect any PREFIX set via MAKEFLAGS environment variable and/or - make arguments. - - KDE 4.x ports may conflict with KDE 3.x ports, so when - the kdeprefix component is enabled, they - are installed in ${KDE4_PREFIX}. - The default value of KDE4_PREFIX is - currently /usr/local/kde4. Installing - the KDE 4.x ports into a custom PREFIX is - also possible. When PREFIX is set via - the MAKEFLAGS environment variable or via - make options it overrides the - value configured by kdeprefix. + make arguments. <makevar>USE_KDE4</makevar> Example - This is a simple example for KDE 4 port. - USE_CMAKE instructs port to utilize + This is a simple example for a KDE 4 port. + USE_CMAKE instructs the port to utilize CMake — configuration tool widely spread among KDE 4 projects. USE_KDE4 brings dependency on KDE libraries and makes port using - automoc4 at build stage. + automoc4 at build stage. Required KDE components and other dependencies can be determined through configure log. USE_KDE4 does not imply USE_QT_VER. If a port requires some - Qt4 components, USE_QT_VER should be + Qt 4 components, USE_QT_VER should be set and then needed components can be specified. USE_CMAKE= yes -USE_KDE4= automoc4 kdelibs kdeprefix +USE_KDE4= kdelibs kdeprefix automoc4 USE_QT_VER= 4 -QT_COMPONENTS= qmake_build moc_build rcc_build uic_build +QT_COMPONENTS= moc_build qmake_build rcc_build uic_build >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon May 14 11:06:11 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 01831106567B for ; Mon, 14 May 2012 11:06:11 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id DE5808FC0C for ; Mon, 14 May 2012 11:06:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4EB6A4j052446 for ; Mon, 14 May 2012 11:06:10 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4EB69kQ052444 for freebsd-doc@FreeBSD.org; Mon, 14 May 2012 11:06:09 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 14 May 2012 11:06:09 GMT Message-Id: <201205141106.q4EB69kQ052444@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 11:06:11 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/167864 doc [patch] Update KDE documentation in Handbook and Porte o docs/167742 doc Update documentation for group 5, and newgrp 1 o docs/167741 doc group(5): Group Passwords do not work and are not docu o docs/166553 doc find(1): find -delete documentation is misleading o docs/166358 doc No networking in Jail build via: handbook/jail-tuning o docs/165657 doc Web site Features page aging o docs/165551 doc ipfw(8): no info in "ipfw pipe show" about ipv6 o docs/165410 doc [handbook] installer documentation is not up to date o docs/165249 doc Multibyte characters in manpages still not displaying o docs/164803 doc Unclear manual page for mount_unionfs(8) o docs/164800 doc Handbook's installation topic doesn't mention ZFS o docs/164772 doc incorrect ipfw sched parameters in manual o docs/164682 doc Handbook contains wrong information about Flash player o docs/164620 doc Raid 1 issues o docs/164099 doc gparm(8): man page for gparm set is incorrect and inco o docs/164034 doc acl(9) documentation lacking o docs/163879 doc [handbook] handbook does not say about how to force to o docs/163830 doc device smbios: missing documentation, no manpage o docs/163576 doc zfs(8) sync property not noted in the manpage o docs/163149 doc [patch] Red Hat Linux/i386 9 HTML format sudo man page o docs/162775 doc zpool(1): Document some undocumented zpool import opti o docs/162433 doc [handbook] QEMU instructions for FreeBSD guests o docs/162419 doc [request] please document (new) zfs and zpool cmdline o docs/162404 doc [handbook] IPv6 link-local address compared with IPv4 o docs/162380 doc Documentation lacking for getfacl/setfacl o docs/161804 doc New documentation: French translation for building-pro o docs/161754 doc p4tcc(4), est(4) and qpi(4) are not documented o docs/161496 doc zfs(1): Please document that sysctl vfs.usermount must o docs/160460 doc [handbook] Network setup guide suggestion o docs/160447 doc [handbook] Developer's Handbook contains some outdated o docs/160446 doc [handbook] Handbook sound setup seems outdated o docs/160445 doc [handbook] Handbook does not mention ACL o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/159298 doc [handbook] document Konqueror with Webkit support to i o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/157908 doc [handbook] Description of post-install should include o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy p docs/156955 doc bug in share/man/man2/setsockopt.2 o docs/156920 doc isspecial(3) is not helpful o docs/156853 doc [patch] Update docs: jail(8) security issues with worl o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/153958 doc ksu man-page documented, but not installed a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/149574 doc [patch] update mi_switch(9) man page o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145644 doc Add artical about creating manpage from scratch o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args p docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine o docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57298 doc [patch] add using compact flash cards info to handbook s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 189 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon May 14 17:28:26 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9019C1065670 for ; Mon, 14 May 2012 17:28:26 +0000 (UTC) (envelope-from ebrandi@fugspbr.org) Received: from mail-pb0-f54.google.com (mail-pb0-f54.google.com [209.85.160.54]) by mx1.freebsd.org (Postfix) with ESMTP id 60B368FC15 for ; Mon, 14 May 2012 17:28:26 +0000 (UTC) Received: by pbbro2 with SMTP id ro2so7225019pbb.13 for ; Mon, 14 May 2012 10:28:26 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type:content-transfer-encoding:x-gm-message-state; bh=NOd8p+amQhF7wT7FLEzFW9MvYb8yB7h34xKWmBoZ1xE=; b=Ls4kMeDwTf4qkDf+ft6hANh0b1I6PTj778M8Qavx/cAmofpL1UUeAp7jqWkBhkHd6B D4wKG9bKxl3CgSfRKDG/SE5vUxjo4G9Mklu4gn+mQVyvnR6wSlA/r0FT8tRoiEX8pkra SOmqcdiKnBA3WlGV3LD3HfpBy0elNKp9jGJt0fTZmTXBucDNopENzlt4sHk78uSL3VXD wM7rI/wKaCU1uj1yB6hV354csP/+hgqZQ211W8Rx6hPhQhj1JQxJe+3NkWKDVyFi86dx wPjFKnRmuRrpwDgvVHb9ckc7EF8S+vY7LAzSYV5SxB8+vnDXHyovCewnR8+K3BpF1xgC AO7A== MIME-Version: 1.0 Received: by 10.68.220.97 with SMTP id pv1mr24500925pbc.158.1337016505813; Mon, 14 May 2012 10:28:25 -0700 (PDT) Received: by 10.143.92.1 with HTTP; Mon, 14 May 2012 10:28:25 -0700 (PDT) In-Reply-To: References: <20120425131740.GA2206@glenbarber.us> Date: Mon, 14 May 2012 14:28:25 -0300 Message-ID: From: Edson Brandi To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable X-Gm-Message-State: ALoCoQlmuzw6A17jGKebVMDcAwHM1+ohwsb/+O9fUNJkTpXE4e+gZVyNJKUPq5IslyVsaGdRwNSP Subject: Re: Need advice to help me fix build process of translated documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 17:28:26 -0000 Hello Guys, Just a small update about build problems that i reported some weeks ago >>> #### Issue 3 #### >>> - For some strange reason sgml markup =85 aren't getting >>> translated into "=85" , i'm not able to find what i need do to fix this= . Any advice >>> about what i`m doing wrong? >>> Example of this behavior: =A0http://server04.ebrandi.eti.br/pt_BR/books= /fdp-primer/writing-style.html , >>> name o Jordan K. Hubbard was supposed to be between quotes, sgml file a= re marked correctly. A friend was able to fix this problem with replacement, it was related with tidy version installed by docproj meta port. When we install docproj meta port it install tidy-devel (tidy-lib-090315.c_1) , our problem has been solved when we removed tidy-devel package and installed old version of tidy (tidy4-20000804_3). >>> #### Issue 3 #### >>> - I'm also having troubles with sgml markup =85 , >>> this was supposed to be translated into a red box where paragraphs star= t with >>> "Aten=E7=E3o:" , for some reason my html files are missing a ":" (colon= ). >>> Example of this behavior: http://server04.ebrandi.eti.br/pt_BR/books/fd= p-primer/preface-notes.html This problem has been fixed adding few lines to our freebsd.dsl file: https://github.com/doc-br/doc-br/commit/8e19dcbd7279fa3f110cd12a135674d422e= 402e5 I think that translation of FDP Primer to pt_BR will be finished in more some days Edson From owner-freebsd-doc@FreeBSD.ORG Mon May 14 18:20:13 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8017F1065672 for ; Mon, 14 May 2012 18:20:13 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 41C788FC14 for ; Mon, 14 May 2012 18:20:13 +0000 (UTC) Received: (qmail 29497 invoked by uid 0); 14 May 2012 14:20:11 -0400 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 14 May 2012 14:20:11 -0400 Date: Mon, 14 May 2012 14:20:09 -0400 From: Glen Barber To: Edson Brandi Message-ID: <20120514182009.GA1501@glenbarber.us> References: <20120425131740.GA2206@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@freebsd.org Subject: Re: Need advice to help me fix build process of translated documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 18:20:13 -0000 Hello, On Mon, May 14, 2012 at 02:28:25PM -0300, Edson Brandi wrote: > Hello Guys, >=20 > Just a small update about build problems that i reported some weeks ago >=20 > >>> #### Issue 3 #### > >>> - For some strange reason sgml markup =E2=80=A6 aren't= getting > >>> translated into "=E2=80=A6" , i'm not able to find what i need do to = fix this. Any advice > >>> about what i`m doing wrong? > >>> Example of this behavior: =C2=A0http://server04.ebrandi.eti.br/pt_BR/= books/fdp-primer/writing-style.html , > >>> name o Jordan K. Hubbard was supposed to be between quotes, sgml file= are marked correctly. >=20 > A friend was able to fix this problem with > replacement, it was related with tidy version installed by docproj > meta port. >=20 > When we install docproj meta port it install tidy-devel > (tidy-lib-090315.c_1) , our problem has been solved when we removed > tidy-devel package and installed old version of tidy > (tidy4-20000804_3). >=20 Ah, good to know. I did notice this in my local build for en_US a few days ago, but made no progress tracking it down. Glad you did. :) > >>> #### Issue 3 #### > >>> - I'm also having troubles with sgml markup =E2=80=A6 , > >>> this was supposed to be translated into a red box where paragraphs st= art with > >>> "Aten=C3=A7=C3=A3o:" , for some reason my html files are missing a ":= " (colon). > >>> Example of this behavior: http://server04.ebrandi.eti.br/pt_BR/books/= fdp-primer/preface-notes.html >=20 > This problem has been fixed adding few lines to our freebsd.dsl file: >=20 > https://github.com/doc-br/doc-br/commit/8e19dcbd7279fa3f110cd12a135674d42= 2e402e5 >=20 > I think that translation of FDP Primer to pt_BR will be finished in > more some days >=20 Great! Glen From owner-freebsd-doc@FreeBSD.ORG Mon May 14 19:40:04 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 46C63106566C for ; Mon, 14 May 2012 19:40:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 13A2F8FC15 for ; Mon, 14 May 2012 19:40:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4EJe3Ax039638 for ; Mon, 14 May 2012 19:40:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4EJe3DZ039637; Mon, 14 May 2012 19:40:03 GMT (envelope-from gnats) Resent-Date: Mon, 14 May 2012 19:40:03 GMT Resent-Message-Id: <201205141940.q4EJe3DZ039637@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, kogane@jp.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6FCE1106564A for ; Mon, 14 May 2012 19:30:00 +0000 (UTC) (envelope-from n-kogane@syd.odn.ne.jp) Received: from cmta102.odn.ne.jp (mta102.odn.ne.jp [143.90.14.138]) by mx1.freebsd.org (Postfix) with ESMTP id EC74B8FC0A for ; Mon, 14 May 2012 19:29:59 +0000 (UTC) Received: from vmta102.odn.ne.jp by cmta102.odn.ne.jp with ESMTP id <20120514192953548.UKBF.16604.cmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Tue, 15 May 2012 04:29:53 +0900 Received: from emta102.odn.ne.jp by vmta102.odn.ne.jp with ESMTP id <20120514192953501.UPJI.22564.vmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Tue, 15 May 2012 04:29:53 +0900 Received: from kcesx30.koganemaru.co.jp ([218.218.68.33] [218.218.68.33]) by emta102.odn.ne.jp with ESMTP id <20120514192953338.LPES.6396.emta102.odn.ne.jp@mta102.odn.ne.jp> for ; Tue, 15 May 2012 04:29:53 +0900 Received: by kcesx30.koganemaru.co.jp (Postfix, from userid 100) id 1F80728424; Tue, 15 May 2012 04:28:21 +0900 (JST) Message-Id: <20120514192821.1F80728424@kcesx30.koganemaru.co.jp> Date: Tue, 15 May 2012 04:28:21 +0900 (JST) From: Nobuyuki Koganemaru To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/167890: groff mandoc style, usage mistakes or typos. (man7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: kogane@jp.freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 19:40:04 -0000 >Number: 167890 >Category: docs >Synopsis: groff mandoc style, usage mistakes or typos. (man7) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon May 14 19:40:02 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Nobuyuki Koganemaru >Release: FreeBSD 10.0-CURRENT >Organization: KOGANEMARU Computer Engineering Service Corporation. >Environment: System: FreeBSD kcesx31.koganemaru.co.jp 8.2-RELEASE-p6 FreeBSD 8.2-RELEASE-p6 #0: Tue Apr 24 03:49:22 JST 2012 root@kcesx31.koganemaru.co.jp:/usr/obj/usr/src.82/sys/GENERIC i386 >Description: man7 >How-To-Repeat: none. >Fix: corrected files: c99.7: $FreeBSD: src/share/man/man7/c99.7,v 1.3 2011/05/30 10:28:55 bcr Exp $ release.7: $FreeBSD: src/share/man/man7/release.7,v 1.69 2012/03/29 05:02:12 eadler Exp $ patch files: diff -u src/share/man/man7/c99.7.orig src/share/man/man7/c99.7 --- src/share/man/man7/c99.7.orig 2012-05-15 03:41:29.000000000 +0900 +++ src/share/man/man7/c99.7 2012-05-15 03:41:38.000000000 +0900 @@ -103,7 +103,7 @@ ISO/IEC 9899 AM1 in 1995. This contained, for example, the wide-character support in wchar.h and wctype.h. -Two corregenda were also published: Technical Corrigendum 1 as +Two corrigenda were also published: Technical Corrigendum 1 as ISO/IEC 9899 TCOR1 in 1995 and Technical Corrigendum 2 as ISO/IEC 9899 TCOR1 in 1996. The continuous development and growth made it necessary to work out a new diff -u src/share/man/man7/release.7.orig src/share/man/man7/release.7 --- src/share/man/man7/release.7.orig 2012-05-15 03:41:45.000000000 +0900 +++ src/share/man/man7/release.7 2012-05-15 03:41:58.000000000 +0900 @@ -221,7 +221,7 @@ the Handbook) is built during the .Cm base.txz target invoked by -.Cm packagesystem. +.Cm packagesystem . .El .Sh ENVIRONMENT Optional variables: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon May 14 19:42:42 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 5A770106566B; Mon, 14 May 2012 19:42:42 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2E7FD8FC0A; Mon, 14 May 2012 19:42:42 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4EJggSH047738; Mon, 14 May 2012 19:42:42 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4EJgg6E047734; Mon, 14 May 2012 19:42:42 GMT (envelope-from gjb) Date: Mon, 14 May 2012 19:42:42 GMT Message-Id: <201205141942.q4EJgg6E047734@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/167890: groff mandoc style, usage mistakes or typos. (man7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 May 2012 19:42:42 -0000 Synopsis: groff mandoc style, usage mistakes or typos. (man7) Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Mon May 14 19:42:35 UTC 2012 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=167890 From owner-freebsd-doc@FreeBSD.ORG Tue May 15 13:44:41 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DFAA2106564A; Tue, 15 May 2012 13:44:41 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B38D98FC08; Tue, 15 May 2012 13:44:41 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FDifYh077392; Tue, 15 May 2012 13:44:41 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FDifGa077388; Tue, 15 May 2012 13:44:41 GMT (envelope-from gjb) Date: Tue, 15 May 2012 13:44:41 GMT Message-Id: <201205151344.q4FDifGa077388@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/167864: [patch] Update KDE documentation in Handbook and Porter's Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 13:44:42 -0000 Synopsis: [patch] Update KDE documentation in Handbook and Porter's Handbook Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Tue May 15 13:44:30 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=167864 From owner-freebsd-doc@FreeBSD.ORG Tue May 15 16:30:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A32691065674 for ; Tue, 15 May 2012 16:30:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6E77C8FC0C for ; Tue, 15 May 2012 16:30:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FGU2uM038628 for ; Tue, 15 May 2012 16:30:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FGU2ib038625; Tue, 15 May 2012 16:30:02 GMT (envelope-from gnats) Resent-Date: Tue, 15 May 2012 16:30:02 GMT Resent-Message-Id: <201205151630.q4FGU2ib038625@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Guido Falsi Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 71503106566B for ; Tue, 15 May 2012 16:21:33 +0000 (UTC) (envelope-from mad@madpilot.net) Received: from megatron.madpilot.net (megatron.madpilot.net [88.149.173.206]) by mx1.freebsd.org (Postfix) with ESMTP id 0E4298FC0A for ; Tue, 15 May 2012 16:21:33 +0000 (UTC) Received: from megatron.madpilot.net (localhost [127.0.0.1]) by megatron.madpilot.net (Postfix) with ESMTP id 3VsPD62GQXz2Yc for ; Tue, 15 May 2012 18:21:26 +0200 (CEST) Received: from megatron.madpilot.net ([127.0.0.1]) by megatron.madpilot.net (megatron.madpilot.net [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id ucuimw1KFlHr for ; Tue, 15 May 2012 18:21:20 +0200 (CEST) Received: by megatron.madpilot.net (Postfix, from userid 1000) id 3VsPD05sWNz2Yb; Tue, 15 May 2012 18:21:20 +0200 (CEST) Message-Id: <3VsPD05sWNz2Yb@megatron.madpilot.net> Date: Tue, 15 May 2012 18:21:20 +0200 (CEST) From: Guido Falsi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/167932: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Guido Falsi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 16:30:02 -0000 >Number: 167932 >Category: docs >Synopsis: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue May 15 16:30:02 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Guido Falsi >Release: FreeBSD 9.0-STABLE amd64 >Organization: >Environment: System: FreeBSD megatron.madpilot.net 9.0-STABLE FreeBSD 9.0-STABLE #5: Sun Apr 22 14:22:36 CEST 2012 root@megatron.madpilot.net:/usr/obj/usr/src/sys/MEGATRON amd64 >Description: While experimenting with the .cshrc examples I discovered that the sample for automatically setting SSH_AUTH_SOCK does not work as is. It's easily tricked by other processes and cut seems to split on every single space character, not grouping them. I was using this revision of the file: # $FreeBSD: stable/9/share/examples/csh/dot.cshrc 234978 2012-05-03 19:55:36Z eadler $ I tested a few possible solutions. I'm quite aware that none of these is rock solid, but they do perform better than the sample code in the file. I'm sure someone will come up with an even better implementation. It is my personal opinion that sample code should be as correctly working as possible. The simpliest and most legible (used in the attached patch): setenv SSH_AUTH_SOCK `sockstat | grep "${USER}" | grep ssh-agent | awk '{ print $6 }'` a slightly less legible one, but avoiding the double grep: setenv SSH_AUTH_SOCK `sockstat | egrep "${USER}.*ssh-agent" | awk '{ print $6 }'` and a simplier(but with horrible legibility) one relying only on sed: setenv SSH_AUTH_SOCK `sockstat | sed -n "/${USER}.*ssh-agent/s/[^\/]*\(.*\)/\1/p"` I know this is a minor glitch, but I thought it was worth reporting anyway. >How-To-Repeat: Enable the sample code to populate SSH_AUTH_SOCK. launch an ssh-agent on teh target machine. Login via ssh. Run "env" and notice that the SSH_AUTH_SOCK variable will be empty even if there is an ssh-agent running. >Fix: --- dot.cshrc.orig 2012-05-15 18:03:10.053581560 +0200 +++ dot.cshrc 2012-05-15 18:11:25.903582833 +0200 @@ -5,7 +5,7 @@ # Sets SSH_AUTH_SOCK to the user's ssh-agent socket path if running if (${?SSH_AUTH_SOCK} != "1") then - setenv SSH_AUTH_SOCK `sockstat | grep "${USER}" | cut -d ' ' -f 6` + setenv SSH_AUTH_SOCK `sockstat | grep "${USER}" | grep ssh-agent | awk '{ print $6 }'` endif # Change only root's prompt >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 15 18:50:33 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 09B72106566C; Tue, 15 May 2012 18:50:33 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id B9C3D8FC15; Tue, 15 May 2012 18:50:32 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q4FIoQXe047434; Tue, 15 May 2012 12:50:26 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q4FIoQ71047431; Tue, 15 May 2012 12:50:26 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 15 May 2012 12:50:26 -0600 (MDT) From: Warren Block To: Guido Falsi In-Reply-To: <3VsPD05sWNz2Yb@megatron.madpilot.net> Message-ID: References: <3VsPD05sWNz2Yb@megatron.madpilot.net> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Tue, 15 May 2012 12:50:26 -0600 (MDT) Cc: freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/167932: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 18:50:33 -0000 On Tue, 15 May 2012, Guido Falsi wrote: > It is my personal opinion that sample code should be as correctly > working as possible. > > The simpliest and most legible (used in the attached patch): > > setenv SSH_AUTH_SOCK `sockstat | grep "${USER}" | grep ssh-agent | awk '{ print $6 }'` awk can do a little more to eliminate the second grep: setenv SSH_AUTH_SOCK `sockstat | grep "^${USER} " | awk '/ssh-agent/ { print $6 }'` The anchor before and space after the username in the grep are to make it an exact match and not a subset ("jsm" versus "jsmith"). Although I don't know what sockstat does with a username longer than eight characters. > I know this is a minor glitch, but I thought it was worth reporting > anyway. It is. Accuracy and precision are the goal. From owner-freebsd-doc@FreeBSD.ORG Tue May 15 19:00:17 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 73FF71065670 for ; Tue, 15 May 2012 19:00:17 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 44C488FC14 for ; Tue, 15 May 2012 19:00:17 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FJ0H8R081062 for ; Tue, 15 May 2012 19:00:17 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FJ0HxL081061; Tue, 15 May 2012 19:00:17 GMT (envelope-from gnats) Date: Tue, 15 May 2012 19:00:17 GMT Message-Id: <201205151900.q4FJ0HxL081061@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Warren Block Cc: Subject: Re: docs/167932: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Warren Block List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 19:00:17 -0000 The following reply was made to PR docs/167932; it has been noted by GNATS. From: Warren Block To: Guido Falsi Cc: FreeBSD-gnats-submit@freebsd.org, freebsd-doc@freebsd.org Subject: Re: docs/167932: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect Date: Tue, 15 May 2012 12:50:26 -0600 (MDT) On Tue, 15 May 2012, Guido Falsi wrote: > It is my personal opinion that sample code should be as correctly > working as possible. > > The simpliest and most legible (used in the attached patch): > > setenv SSH_AUTH_SOCK `sockstat | grep "${USER}" | grep ssh-agent | awk '{ print $6 }'` awk can do a little more to eliminate the second grep: setenv SSH_AUTH_SOCK `sockstat | grep "^${USER} " | awk '/ssh-agent/ { print $6 }'` The anchor before and space after the username in the grep are to make it an exact match and not a subset ("jsm" versus "jsmith"). Although I don't know what sockstat does with a username longer than eight characters. > I know this is a minor glitch, but I thought it was worth reporting > anyway. It is. Accuracy and precision are the goal. From owner-freebsd-doc@FreeBSD.ORG Tue May 15 19:20:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D9168106566C for ; Tue, 15 May 2012 19:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A6C028FC1A for ; Tue, 15 May 2012 19:20:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FJK2j1000413 for ; Tue, 15 May 2012 19:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FJK2UE000412; Tue, 15 May 2012 19:20:02 GMT (envelope-from gnats) Resent-Date: Tue, 15 May 2012 19:20:02 GMT Resent-Message-Id: <201205151920.q4FJK2UE000412@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Dmitry Marakasov Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7F863106566C for ; Tue, 15 May 2012 19:16:56 +0000 (UTC) (envelope-from amdmi3@amdmi3.ru) Received: from smtp.timeweb.ru (unknown [IPv6:2a03:6f00:1::5c35:743c]) by mx1.freebsd.org (Postfix) with ESMTP id 0D99C8FC08 for ; Tue, 15 May 2012 19:16:56 +0000 (UTC) Received: from [213.148.20.85] (helo=hive.panopticon) by smtp.timeweb.ru with esmtpsa (TLSv1:CAMELLIA256-SHA:256) (Exim 4.76) (envelope-from ) id 1SUNEs-0006AR-GP for FreeBSD-gnats-submit@freebsd.org; Tue, 15 May 2012 23:16:54 +0400 Received: from hades.panopticon (hades.panopticon [192.168.0.32]) by hive.panopticon (Postfix) with ESMTP id 4F3CFB84E for ; Tue, 15 May 2012 23:16:54 +0400 (MSK) Received: by hades.panopticon (Postfix, from userid 1000) id 494B054F; Tue, 15 May 2012 23:16:54 +0400 (MSK) Message-Id: <20120515191654.494B054F@hades.panopticon> Date: Tue, 15 May 2012 23:16:54 +0400 (MSK) From: Dmitry Marakasov To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/167936: [patch] fix example zone declaration in Domain Name System chapter of RU handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Dmitry Marakasov List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 19:20:03 -0000 >Number: 167936 >Category: docs >Synopsis: [patch] fix example zone declaration in Domain Name System chapter of RU handbook >Confidential: no >Severity: serious >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue May 15 19:20:02 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Dmitry Marakasov >Release: FreeBSD 9.0-RELEASE amd64 >Organization: >Environment: System: FreeBSD hades.panopticon 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Jan 10 01:33:18 MSK 2012 root@hades.panopticon:/usr/obj/usr/src/sys/HADES amd64 >Description: SOA has 5 fields. Fix it to match english article. >How-To-Repeat: >Fix: --- dns.patch begins here --- Index: ru_RU.KOI8-R/books/handbook/network-servers/chapter.sgml =================================================================== RCS file: /home/amdmi3/projects/freebsd/FreeBSD.cvs/doc/ru_RU.KOI8-R/books/handbook/network-servers/chapter.sgml,v retrieving revision 1.22 diff -u -r1.22 chapter.sgml --- ru_RU.KOI8-R/books/handbook/network-servers/chapter.sgml 5 Dec 2011 14:33:50 -0000 1.22 +++ ru_RU.KOI8-R/books/handbook/network-servers/chapter.sgml 15 May 2012 19:14:40 -0000 @@ -3722,7 +3722,6 @@ 10800 ; Refresh 3600 ; Retry 604800 ; Expire - 86400 ; Minimum TTL 300 ; Negative Response TTL ) --- dns.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 15 19:28:22 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 80C821065670; Tue, 15 May 2012 19:28:22 +0000 (UTC) (envelope-from maxim@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 542DD8FC17; Tue, 15 May 2012 19:28:22 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FJSMaR008893; Tue, 15 May 2012 19:28:22 GMT (envelope-from maxim@freefall.freebsd.org) Received: (from maxim@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FJSMlq008889; Tue, 15 May 2012 19:28:22 GMT (envelope-from maxim) Date: Tue, 15 May 2012 19:28:22 GMT Message-Id: <201205151928.q4FJSMlq008889@freefall.freebsd.org> To: amdmi3@FreeBSD.org, maxim@FreeBSD.org, freebsd-doc@FreeBSD.org From: maxim@FreeBSD.org Cc: Subject: Re: docs/167936: [patch] fix example zone declaration in Domain Name System chapter of RU handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 19:28:22 -0000 Synopsis: [patch] fix example zone declaration in Domain Name System chapter of RU handbook State-Changed-From-To: open->closed State-Changed-By: maxim State-Changed-When: Tue May 15 19:28:04 UTC 2012 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=167936 From owner-freebsd-doc@FreeBSD.ORG Tue May 15 19:30:12 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BF6721065670 for ; Tue, 15 May 2012 19:30:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0C7828FC0C for ; Tue, 15 May 2012 19:30:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FJU866009179 for ; Tue, 15 May 2012 19:30:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FJU8Yt009176; Tue, 15 May 2012 19:30:08 GMT (envelope-from gnats) Date: Tue, 15 May 2012 19:30:08 GMT Message-Id: <201205151930.q4FJU8Yt009176@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: dfilter@FreeBSD.ORG (dfilter service) Cc: Subject: Re: docs/167936: commit references a PR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: dfilter service List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 19:30:12 -0000 The following reply was made to PR docs/167936; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/167936: commit references a PR Date: Tue, 15 May 2012 19:27:55 +0000 (UTC) maxim 2012-05-15 19:27:46 UTC FreeBSD doc repository Modified files: ru_RU.KOI8-R/books/handbook/network-servers chapter.sgml Log: o SOA RR corrected, a superfluous field removed. PR: docs/167936 Submitted by: amdmi3 Revision Changes Path 1.23 +0 -1 doc/ru_RU.KOI8-R/books/handbook/network-servers/chapter.sgml _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" From owner-freebsd-doc@FreeBSD.ORG Tue May 15 19:35:45 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 19E0D106566C; Tue, 15 May 2012 19:35:45 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id E21848FC08; Tue, 15 May 2012 19:35:44 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4FJZiZe019344; Tue, 15 May 2012 19:35:44 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4FJZiMZ019340; Tue, 15 May 2012 19:35:44 GMT (envelope-from eadler) Date: Tue, 15 May 2012 19:35:44 GMT Message-Id: <201205151935.q4FJZiMZ019340@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/167932: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 May 2012 19:35:45 -0000 Synopsis: [PATCH] examples/csh/dot.cshrc SSH_AUTH_SOCK example incorrect Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Tue May 15 19:35:44 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=167932 From owner-freebsd-doc@FreeBSD.ORG Wed May 16 20:30:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 978171065675 for ; Wed, 16 May 2012 20:30:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4FCBD8FC17 for ; Wed, 16 May 2012 20:30:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4GKU2ov045456 for ; Wed, 16 May 2012 20:30:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4GKU2gk045455; Wed, 16 May 2012 20:30:02 GMT (envelope-from gnats) Resent-Date: Wed, 16 May 2012 20:30:02 GMT Resent-Message-Id: <201205162030.q4GKU2gk045455@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Bryan Drewery Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A95F31065672 for ; Wed, 16 May 2012 20:25:33 +0000 (UTC) (envelope-from bryan@shatow.net) Received: from secure.xzibition.com (secure.xzibition.com [173.160.118.92]) by mx1.freebsd.org (Postfix) with ESMTP id 57FDD8FC0C for ; Wed, 16 May 2012 20:25:33 +0000 (UTC) Received: (qmail 27446 invoked from network); 16 May 2012 15:25:25 -0500 Received: from unknown (HELO test8.xzibition.com) (10.10.0.34) by sweb.xzibition.com with SMTP; 16 May 2012 15:25:25 -0500 Received: by test8.xzibition.com (sSMTP sendmail emulation); Wed, 16 May 2012 15:25:00 -0500 Message-Id: <20120516202533.A95F31065672@hub.freebsd.org> Date: Wed, 16 May 2012 15:25:00 -0500 From: "Bryan Drewery" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: rank1seeker@gmail.com, eadler@FreeBSD.org Subject: docs/167980: [PATCH] [share/man] periodic.conf.5: Document daily_status_security_chkportsum_enable X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Bryan Drewery List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 May 2012 20:30:02 -0000 >Number: 167980 >Category: docs >Synopsis: [PATCH] [share/man] periodic.conf.5: Document daily_status_security_chkportsum_enable >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Wed May 16 20:30:01 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Bryan Drewery >Release: FreeBSD 8.3-RELEASE i386 >Organization: >Environment: >Description: daily_status_security_chkportsum_enable is not documented in periodic.conf.5. Reported by: rank1seeker@gmail.com on freebsd-hackers >How-To-Repeat: >Fix: --- patch-periodic.conf.5.txt begins here --- diff --git share/man/man5/periodic.conf.5 share/man/man5/periodic.conf.5 index 4ab009c..d33555c 100644 --- share/man/man5/periodic.conf.5 +++ share/man/man5/periodic.conf.5 @@ -504,6 +504,12 @@ Set to .Dq Li YES to compare the modes and modification times of setuid executables with the previous day's values. +.It Va daily_status_security_chkportsum_enable +.Pq Vt bool +Set to +.Dq Li YES +to verify checksums of all installed packages against the known checksums in +.Pa /var/db/pkg . .It Va daily_status_security_neggrpperm_enable .Pq Vt bool Set to --- patch-periodic.conf.5.txt ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed May 16 22:33:39 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 466BD1065673; Wed, 16 May 2012 22:33:39 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1A1B08FC14; Wed, 16 May 2012 22:33:39 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4GMXc0j069038; Wed, 16 May 2012 22:33:38 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4GMXcsc069034; Wed, 16 May 2012 22:33:38 GMT (envelope-from eadler) Date: Wed, 16 May 2012 22:33:38 GMT Message-Id: <201205162233.q4GMXcsc069034@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/167980: [PATCH] share/man: periodic.conf.5: Document daily_status_security_chkportsum_enable X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 May 2012 22:33:39 -0000 Synopsis: [PATCH] share/man: periodic.conf.5: Document daily_status_security_chkportsum_enable Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Wed May 16 22:33:38 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=167980 From owner-freebsd-doc@FreeBSD.ORG Thu May 17 15:40:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4121B1065674 for ; Thu, 17 May 2012 15:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0A3E28FC1C for ; Thu, 17 May 2012 15:40:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4HFe1Qh058830 for ; Thu, 17 May 2012 15:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4HFe1go058829; Thu, 17 May 2012 15:40:01 GMT (envelope-from gnats) Resent-Date: Thu, 17 May 2012 15:40:01 GMT Resent-Message-Id: <201205171540.q4HFe1go058829@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, kogane@jp.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CFEFF1065670 for ; Thu, 17 May 2012 15:33:23 +0000 (UTC) (envelope-from n-kogane@syd.odn.ne.jp) Received: from cmta102.odn.ne.jp (mta102.odn.ne.jp [143.90.14.138]) by mx1.freebsd.org (Postfix) with ESMTP id CD6288FC20 for ; Thu, 17 May 2012 15:33:22 +0000 (UTC) Received: from vmta102.odn.ne.jp by cmta102.odn.ne.jp with ESMTP id <20120517153316550.WYWC.5299.cmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Fri, 18 May 2012 00:33:16 +0900 Received: from emta102.odn.ne.jp by vmta102.odn.ne.jp with ESMTP id <20120517153316500.DKBC.22044.vmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Fri, 18 May 2012 00:33:16 +0900 Received: from kcesx30.koganemaru.co.jp ([218.218.68.33] [218.218.68.33]) by emta102.odn.ne.jp with ESMTP id <20120517153315669.CMZG.12533.emta102.odn.ne.jp@mta102.odn.ne.jp> for ; Fri, 18 May 2012 00:33:15 +0900 Received: by kcesx30.koganemaru.co.jp (Postfix, from userid 100) id A919C28424; Fri, 18 May 2012 00:31:42 +0900 (JST) Message-Id: <20120517153142.A919C28424@kcesx30.koganemaru.co.jp> Date: Fri, 18 May 2012 00:31:42 +0900 (JST) From: Nobuyuki Koganemaru To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/168016: groff mandoc style, usage mistakes or typos. (man8) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: kogane@jp.freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 May 2012 15:40:02 -0000 >Number: 168016 >Category: docs >Synopsis: groff mandoc style, usage mistakes or typos. (man8) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu May 17 15:40:01 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Nobuyuki Koganemaru >Release: FreeBSD 10.0-CURRENT >Organization: KOGANEMARU Computer Engineering Service Corporation. >Environment: System: FreeBSD kcesx31.koganemaru.co.jp 8.2-RELEASE-p6 FreeBSD 8.2-RELEASE-p6 #0: Tue Apr 24 03:49:22 JST 2012 root@kcesx31.koganemaru.co.jp:/usr/obj/usr/src.82/sys/GENERIC i386 >Description: man8 >How-To-Repeat: none. >Fix: corrected files: atacontrol.8: $FreeBSD: src/sbin/atacontrol/atacontrol.8,v 1.35 2011/10/09 21:42:02 rodrigc Exp $ beastie.4th.8: $FreeBSD: src/sys/boot/forth/beastie.4th.8,v 1.1 2011/05/28 08:50:38 julian Exp $ brand.4th.8: $FreeBSD: src/sys/boot/forth/brand.4th.8,v 1.1 2011/05/28 08:50:38 julian Exp $ burncd.8: $FreeBSD: src/usr.sbin/burncd/burncd.8,v 1.43 2011/12/30 00:59:08 uqs Exp $ camcontrol.8: $FreeBSD: src/sbin/camcontrol/camcontrol.8,v 1.59 2012/03/29 05:02:12 eadler Exp $ check-password.4th.8: $FreeBSD: src/sys/boot/forth/check-password.4th.8,v 1.2 2011/06/02 09:56:42 uqs Exp $ color.4th.8: $FreeBSD: src/sys/boot/forth/color.4th.8,v 1.1 2011/05/28 08:50:38 julian Exp $ cpucontrol.8: $FreeBSD: src/usr.sbin/cpucontrol/cpucontrol.8,v 1.7 2010/05/13 12:07:55 uqs Exp $ ctladm.8: $Id: //depot/users/kenm/FreeBSD-test2/usr.sbin/ctladm/ctladm.8#3 $ $FreeBSD: src/usr.sbin/ctladm/ctladm.8,v 1.4 2012/03/29 05:02:12 eadler Exp $ ctlstat.8: $Id: //depot/users/kenm/FreeBSD-test2/usr.bin/ctlstat/ctlstat.8#2 $ $FreeBSD: src/usr.bin/ctlstat/ctlstat.8,v 1.1 2012/01/12 00:34:33 ken Exp $ delay.4th.8: $FreeBSD: src/sys/boot/forth/delay.4th.8,v 1.1 2011/05/28 08:50:38 julian Exp $ etherswitchcfg.8: $FreeBSD: src/sbin/etherswitchcfg/etherswitchcfg.8,v 1.2 2012/05/12 19:59:37 joel Exp $ flowctl.8: $FreeBSD: src/usr.sbin/flowctl/flowctl.8,v 1.6 2011/07/05 14:55:17 glebius Exp $ freebsd-update.8: $FreeBSD: src/usr.sbin/freebsd-update/freebsd-update.8,v 1.12 2012/03/29 05:02:12 eadler Exp $ geli.8: $FreeBSD: src/sbin/geom/class/eli/geli.8,v 1.39 2012/05/09 17:26:52 eadler Exp $ gmultipath.8: $FreeBSD: src/sbin/geom/class/multipath/gmultipath.8,v 1.9 2012/04/18 09:42:14 mav Exp $ gpart.8: $FreeBSD: src/sbin/geom/class/part/gpart.8,v 1.44 2012/03/19 13:17:47 ae Exp $ graid.8: $FreeBSD: src/sbin/geom/class/raid/graid.8,v 1.9 2012/05/06 11:32:36 mav Exp $ gvinum.8: $FreeBSD: src/sbin/gvinum/gvinum.8,v 1.9 2012/03/29 05:02:12 eadler Exp $ gvirstor.8: $FreeBSD: src/sbin/geom/class/virstor/gvirstor.8,v 1.4 2011/01/24 14:24:10 ivoras Exp $ hastctl.8: $FreeBSD: src/sbin/hastctl/hastctl.8,v 1.7 2012/01/07 16:09:33 uqs Exp $ hastd.8: $FreeBSD: src/sbin/hastd/hastd.8,v 1.3 2011/03/22 10:39:34 pjd Exp $ hlfsd.8: $Id: hlfsd.8,v 1.11.2.1 2006/01/02 18:48:25 ezk Exp $ $FreeBSD: src/contrib/amd/hlfsd/hlfsd.8,v 1.17 2007/12/07 20:16:20 ru Exp $ i2c.8: $FreeBSD: src/usr.sbin/i2c/i2c.8,v 1.6 2012/03/29 05:02:12 eadler Exp $ ifconfig.8: $FreeBSD: src/sbin/ifconfig/ifconfig.8,v 1.194 2012/05/02 20:01:28 monthadar Exp $ ipf.8: $FreeBSD: src/contrib/ipfilter/man/ipf.8,v 1.9 2009/11/19 08:10:24 darrenr Exp $ ipfw.8: $FreeBSD: src/sbin/ipfw/ipfw.8,v 1.258 2012/05/12 17:14:55 joel Exp $ ipmon.8: $FreeBSD: src/contrib/ipfilter/man/ipmon.8,v 1.19 2010/05/12 00:56:53 brueffer Exp $ ippool.8: $FreeBSD: src/contrib/ipfilter/man/ippool.8,v 1.2 2005/04/25 18:20:14 darrenr Exp $ jail.8: $FreeBSD: src/usr.sbin/jail/jail.8,v 1.123 2012/05/12 19:59:37 joel Exp $ loader.8: $FreeBSD: src/sys/boot/common/loader.8,v 1.105 2012/03/29 05:02:12 eadler Exp $ menu.4th.8: $FreeBSD: src/sys/boot/forth/menu.4th.8,v 1.5 2012/02/25 15:21:43 gjb Exp $ mount.8: $FreeBSD: src/sbin/mount/mount.8,v 1.101 2011/06/06 13:24:54 gavin Exp $ natd.8: $FreeBSD: src/sbin/natd/natd.8,v 1.70 2011/07/01 19:22:27 sem Exp $ ndis_events.8: $FreeBSD: src/usr.sbin/wpa/ndis_events/ndis_events.8,v 1.7 2007/09/07 22:19:29 brueffer Exp $ nfsrevoke.8: $FreeBSD: src/usr.sbin/nfsrevoke/nfsrevoke.8,v 1.1 2009/05/26 15:19:04 rmacklem Exp $ ntp-keygen.8: $FreeBSD: src/usr.sbin/ntp/doc/ntp-keygen.8,v 1.4 2012/03/25 09:18:34 joel Exp $ ntpdc.8: $FreeBSD: src/usr.sbin/ntp/doc/ntpdc.8,v 1.15 2006/09/29 17:57:03 ru Exp $ ntpq.8: $FreeBSD: src/usr.sbin/ntp/doc/ntpq.8,v 1.20 2010/08/06 14:33:42 joel Exp $ pam_exec.8: $FreeBSD: src/lib/libpam/modules/pam_exec/pam_exec.8,v 1.7 2012/03/26 12:18:15 dumbbell Exp $ pc-sysinstall.8: $FreeBSD: src/usr.sbin/pc-sysinstall/pc-sysinstall/pc-sysinstall.8,v 1.5 2010/10/08 12:40:16 uqs Exp $ picobsd.8: $FreeBSD: src/share/man/man8/picobsd.8,v 1.35 2012/03/29 05:02:12 eadler Exp $ rc.8: $FreeBSD: src/share/man/man8/rc.8,v 1.37 2012/05/14 14:33:08 gjb Exp $ rctl.8: $FreeBSD: src/usr.bin/rctl/rctl.8,v 1.13 2012/04/22 07:55:56 delphij Exp $ rtadvctl.8: $FreeBSD: src/usr.sbin/rtadvctl/rtadvctl.8,v 1.2 2011/07/17 20:47:34 gjb Exp $ rtadvd.8: $KAME: rtadvd.8,v 1.24 2002/05/31 16:16:08 jinmei Exp $ $FreeBSD: src/usr.sbin/rtadvd/rtadvd.8,v 1.22 2012/03/29 05:02:12 eadler Exp $ smbmsg.8: $FreeBSD: src/usr.sbin/smbmsg/smbmsg.8,v 1.7 2010/05/27 13:56:19 uqs Exp $ sshd.8: $OpenBSD: sshd.8,v 1.263 2011/08/02 01:22:11 djm Exp $ $FreeBSD: src/crypto/openssh/sshd.8,v 1.43 2011/10/05 22:08:17 des Exp $ tftpd.8: $FreeBSD: src/libexec/tftpd/tftpd.8,v 1.33 2012/03/29 05:02:12 eadler Exp $ utx.8: $FreeBSD: src/usr.sbin/utx/utx.8,v 1.2 2012/03/25 09:18:34 joel Exp $ version.4th.8: $FreeBSD: src/sys/boot/forth/version.4th.8,v 1.1 2011/05/28 08:50:38 julian Exp $ zpool.8: $FreeBSD: src/cddl/contrib/opensolaris/cmd/zpool/zpool.8,v 1.16 2012/04/16 08:19:43 mm Exp $ patch files: diff -u src/sbin/atacontrol/atacontrol.8.orig src/sbin/atacontrol/atacontrol.8 --- src/sbin/atacontrol/atacontrol.8.orig 2012-05-17 01:53:25.000000000 +0900 +++ src/sbin/atacontrol/atacontrol.8 2012-05-17 03:16:27.000000000 +0900 @@ -367,8 +367,8 @@ or syslog logging on it as the disk will be worn out spinning down and up all the time. .Sh SEE ALSO -.Xr ata 4 -.Xr cam 4 +.Xr ata 4 , +.Xr cam 4 , .Xr camcontrol 8 .Sh HISTORY The diff -u src/sys/boot/forth/beastie.4th.8.orig src/sys/boot/forth/beastie.4th.8 --- src/sys/boot/forth/beastie.4th.8.orig 2012-05-17 03:16:38.000000000 +0900 +++ src/sys/boot/forth/beastie.4th.8 2012-05-17 03:16:56.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm beastie.4th -.Nd FreeBSD ASCII art boot module. +.Nd FreeBSD ASCII art boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/sys/boot/forth/brand.4th.8.orig src/sys/boot/forth/brand.4th.8 --- src/sys/boot/forth/brand.4th.8.orig 2012-05-17 03:17:07.000000000 +0900 +++ src/sys/boot/forth/brand.4th.8 2012-05-17 03:17:22.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm brand.4th -.Nd FreeBSD ASCII art boot module. +.Nd FreeBSD ASCII art boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/usr.sbin/burncd/burncd.8.orig src/usr.sbin/burncd/burncd.8 --- src/usr.sbin/burncd/burncd.8.orig 2012-05-17 03:17:32.000000000 +0900 +++ src/usr.sbin/burncd/burncd.8 2012-05-17 03:17:55.000000000 +0900 @@ -240,7 +240,7 @@ is compiled into the kernel, then .Xr cdrecord 1 , available in the -.Fx +.Fx . Ports Collection as part of the .Pa sysutils/cdrtools port, must be used instead. diff -u src/sbin/camcontrol/camcontrol.8.orig src/sbin/camcontrol/camcontrol.8 --- src/sbin/camcontrol/camcontrol.8.orig 2012-05-17 03:18:08.000000000 +0900 +++ src/sbin/camcontrol/camcontrol.8 2012-05-17 03:20:07.000000000 +0900 @@ -568,7 +568,7 @@ .Bl -tag -width 17n .It Fl a Ar cmd Op args This specifies the content of 12 ATA Command Block registers (command, -features, lba_low, lba_mid, lba_high, device, lba_low_exp, lba_mid_exp. +features, lba_low, lba_mid, lba_high, device, lba_low_exp, lba_mid_exp, lba_high_exp, features_exp, sector_count, sector_count_exp). .It Fl c Ar cmd Op args This specifies the SCSI CDB. @@ -1059,7 +1059,7 @@ .It Ic idle Put ATA device into IDLE state. Optional parameter .Pq Fl t -specifies automatic standby timer value in seconds. Value 0 disables timer. +specifies automatic idle timer value in seconds. Value 0 disables timer. .It Ic standby Put ATA device into STANDBY state. Optional parameter .Pq Fl t @@ -1106,7 +1106,7 @@ Run in simulation mode. Packet sizes that will be sent are shown, but no actual packet is sent to the device. -No confimation is asked in simulation mode. +No confirmation is asked in simulation mode. .It Fl v Besides showing sense information in case of a failure, the verbose option causes diff -u src/sys/boot/forth/check-password.4th.8.orig src/sys/boot/forth/check-password.4th.8 --- src/sys/boot/forth/check-password.4th.8.orig 2012-05-17 03:20:19.000000000 +0900 +++ src/sys/boot/forth/check-password.4th.8 2012-05-17 03:20:26.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm check-password.4th -.Nd FreeBSD password-checking boot module. +.Nd FreeBSD password-checking boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/sys/boot/forth/color.4th.8.orig src/sys/boot/forth/color.4th.8 --- src/sys/boot/forth/color.4th.8.orig 2012-05-17 03:20:42.000000000 +0900 +++ src/sys/boot/forth/color.4th.8 2012-05-17 03:20:55.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm color.4th -.Nd FreeBSD color-detection boot module. +.Nd FreeBSD color-detection boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/usr.sbin/cpucontrol/cpucontrol.8.orig src/usr.sbin/cpucontrol/cpucontrol.8 --- src/usr.sbin/cpucontrol/cpucontrol.8.orig 2012-05-17 03:21:08.000000000 +0900 +++ src/usr.sbin/cpucontrol/cpucontrol.8 2012-05-17 03:21:23.000000000 +0900 @@ -31,7 +31,7 @@ .Nm cpucontrol .Nd control utility for the .Xr cpuctl 4 -device. +device .Sh SYNOPSIS .Nm .Op Fl vh diff -u src/usr.sbin/ctladm/ctladm.8.orig src/usr.sbin/ctladm/ctladm.8 --- src/usr.sbin/ctladm/ctladm.8.orig 2012-05-17 03:21:36.000000000 +0900 +++ src/usr.sbin/ctladm/ctladm.8 2012-05-17 03:23:33.000000000 +0900 @@ -542,7 +542,7 @@ Because this command uses the ioctl port, it will only work when the FETDs (Front End Target Drivers) are enabled. This command is the equivalent of doing a REPORT LUNS on one LUN and then -and then an INQUIRY on each LUN in the system. +an INQUIRY on each LUN in the system. .It Ic delay Delay commands at the given location. There are two places where commands may be delayed currently: before data is transferred @@ -749,7 +749,7 @@ As a general rule, the WWNN should be the same across all ports on the system. .It Fl W Ar wwpn -Set the World Wide Node Name for the given port. +Set the World Wide Port Name for the given port. The .Fl n argument must be specified, since this is only possible to implement on a @@ -939,10 +939,10 @@ .Pa src/usr.sbin/ctladm/src/usr.sbin/ctladm/ctladm.8 as the backing store, and specify the .Tn SCSI -VPD page 0x80 and 0x83 serial number ( -.Fl S) -and device ID ( -.Fl d). +VPD page 0x80 and 0x83 serial number +.Fl ( S ) +and device ID +.Fl ( d ) . .Pp .Dl ctladm remove -b block -l 12 .Pp diff -u src/usr.bin/ctlstat/ctlstat.8.orig src/usr.bin/ctlstat/ctlstat.8 --- src/usr.bin/ctlstat/ctlstat.8.orig 2012-05-17 03:23:49.000000000 +0900 +++ src/usr.bin/ctlstat/ctlstat.8 2012-05-17 03:24:06.000000000 +0900 @@ -86,8 +86,8 @@ No statistics are computed in this mode, only raw numbers are displayed. .It Fl l Ar lun Request statistics for the specified LUN. -This option is incompatible with total ( -.Fl t ) +This option is incompatible with total +.Fl ( t ) mode. .It Fl n Ar numdevs Display statistics for this many devices. diff -u src/sys/boot/forth/delay.4th.8.orig src/sys/boot/forth/delay.4th.8 --- src/sys/boot/forth/delay.4th.8.orig 2012-05-17 03:24:16.000000000 +0900 +++ src/sys/boot/forth/delay.4th.8 2012-05-17 03:24:28.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm delay.4th -.Nd FreeBSD debugging boot module. +.Nd FreeBSD debugging boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/sbin/etherswitchcfg/etherswitchcfg.8.orig src/sbin/etherswitchcfg/etherswitchcfg.8 --- src/sbin/etherswitchcfg/etherswitchcfg.8.orig 2012-05-17 03:28:50.000000000 +0900 +++ src/sbin/etherswitchcfg/etherswitchcfg.8 2012-05-17 03:29:27.000000000 +0900 @@ -71,7 +71,8 @@ Specifies a list of media options for a port. See .Xr ifconfig 8 for details on -.Ar media and +.Ar media +and .Ar mediaopt . .El .Ss reg diff -u src/usr.sbin/flowctl/flowctl.8.orig src/usr.sbin/flowctl/flowctl.8 --- src/usr.sbin/flowctl/flowctl.8.orig 2012-05-17 03:34:08.000000000 +0900 +++ src/usr.sbin/flowctl/flowctl.8 2012-05-17 03:34:42.000000000 +0900 @@ -60,7 +60,7 @@ .Dq "show ip cache flow" command of a Cisco router. It dumps the contents of the flow cache in Cisco-like format. -Specifing either +Specifying either .Cm ipv4 or .Cm ipv6 diff -u src/usr.sbin/freebsd-update/freebsd-update.8.orig src/usr.sbin/freebsd-update/freebsd-update.8 --- src/usr.sbin/freebsd-update/freebsd-update.8.orig 2012-05-17 03:34:52.000000000 +0900 +++ src/usr.sbin/freebsd-update/freebsd-update.8 2012-05-17 03:35:27.000000000 +0900 @@ -62,7 +62,7 @@ .Fx 9.0-CURRENT. .Sh OPTIONS -The following options are supported +The following options are supported: .Bl -tag -width "-f conffile" .It Fl b Ar basedir Operate on a system mounted at diff -u src/sbin/geom/class/eli/geli.8.orig src/sbin/geom/class/eli/geli.8 --- src/sbin/geom/class/eli/geli.8.orig 2012-05-17 03:35:41.000000000 +0900 +++ src/sbin/geom/class/eli/geli.8 2012-05-17 03:35:51.000000000 +0900 @@ -333,7 +333,7 @@ Consult the .Sx HISTORY section to find which metadata version is supported by which FreeBSD version. -Note that using older metadata version may limit numer of features available. +Note that using older metadata version may limit number of features available. .El .It Cm attach Attach the given provider. diff -u src/sbin/geom/class/multipath/gmultipath.8.orig src/sbin/geom/class/multipath/gmultipath.8 --- src/sbin/geom/class/multipath/gmultipath.8.orig 2012-05-17 03:36:00.000000000 +0900 +++ src/sbin/geom/class/multipath/gmultipath.8 2012-05-17 03:37:14.000000000 +0900 @@ -135,7 +135,7 @@ method. Label the first given provider with on-disk metadata using the specified .Ar name . -The rest of given providers will be retasted to detect these metadata. +The rest of given providers will be retested to detect these metadata. It reliably protects against specifying unrelated providers. Providers with no matching metadata detected will not be added to the device. .Pp diff -u src/sbin/geom/class/part/gpart.8.orig src/sbin/geom/class/part/gpart.8 --- src/sbin/geom/class/part/gpart.8.orig 2012-05-17 03:37:29.000000000 +0900 +++ src/sbin/geom/class/part/gpart.8 2012-05-17 03:38:31.000000000 +0900 @@ -650,7 +650,7 @@ for GPT. .It Cm ms-ldm-metadata A partition that contains Logical Disk Manager (LDM) database. -The scheme-specifig type is +The scheme-specific type is .Qq Li "!5808c8aa-7e8f-42e0-85d2-e1e90434cfb3" for GPT. .El @@ -971,7 +971,7 @@ .Sx "PARTITION TYPES" section). If this variable set to 1 each component of the mirrored volume will be -present as independet partition. +present as independent partition. .Em NOTE : This may break a mirrored volume and lead to data damage. .El diff -u src/sbin/geom/class/raid/graid.8.orig src/sbin/geom/class/raid/graid.8 --- src/sbin/geom/class/raid/graid.8.orig 2012-05-17 03:38:39.000000000 +0900 +++ src/sbin/geom/class/raid/graid.8 2012-05-17 03:38:50.000000000 +0900 @@ -294,7 +294,7 @@ .Nm RAID GEOM class. .It Va kern.geom.raid.idle_threshold : No 1000000 -Time in microseconds to consider a volume idle for rebuild puroses. +Time in microseconds to consider a volume idle for rebuild purpose. .It Va kern.geom.raid.name_format : No 0 Providers name format: 0 -- raid/r{num}, 1 -- raid/{label}. .It Va kern.geom.raid.read_err_thresh : No 10 diff -u src/sbin/inum/gvinum.8,v.orig src/sbin/inum/gvinum.8,v --- src/sbin/inum/gvinum.8,v.orig 2012-05-17 03:38:58.000000000 +0900 +++ src/sbin/inum/gvinum.8,v 2012-05-17 03:42:17.000000000 +0900 @@ -149,7 +149,7 @@ .It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives Create a RAID-5 volume from the specified drives. If no name is specified,a unique name will be set by -.Ic gvinum. +.Ic gvinum . This organization requires at least three drives. .It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname Change the name of the specified object. @@ -202,8 +202,9 @@ if no parameters are specified. .It Ic stripe Oo Fl fv Oc Oo Fl n Ar name Oc Ar drives Create a striped volume from the specified drives. If no name is specified, -a unique name will be set by Ic gvinum. This organization requires at least two -drives. +a unique name will be set by +.Ic gvinum . +This organization requires at least two drives. .El .Sh DESCRIPTION The @@ -278,7 +279,8 @@ .El .Sh EXAMPLES To create a mirror on disks /dev/ad1 and /dev/ad2, create a filesystem, mount, -unmount and then stop Ic gvinum: +unmount and then stop +.Ic gvinum : .Pp .Dl "gvinum mirror /dev/ad1 /dev/ad2" .Dl "newfs /dev/gvinum/gvinumvolume0" diff -u src/sbin/geom/classirstor/gvirstor.8,v.orig src/sbin/geom/classirstor/gvirstor.8,v --- src/sbin/geom/classirstor/gvirstor.8,v.orig 2012-05-17 03:42:29.000000000 +0900 +++ src/sbin/geom/classirstor/gvirstor.8,v 2012-05-17 03:43:13.000000000 +0900 @@ -113,7 +113,7 @@ The specified virstor device must exist and be active .Pq i.e. module loaded, device present in Pa /dev . This action can be safely performed while the virstor device is in use -.Pq Qo hot Qc operation +.Pq Qo hot Qc operation . .It Cm remove Removes components from existing virtual device with the given .Ar name . @@ -268,7 +268,8 @@ components will always remain constant during their existence. For alternative ways to implement virtual or resizable file systems see .Xr zfs 1M , -.Xr gconcat 8 and +.Xr gconcat 8 +and .Xr growfs 8 . .Pp Note that diff -u src/sbin/hastctl/hastctl.8.orig src/sbin/hastctl/hastctl.8 --- src/sbin/hastctl/hastctl.8.orig 2012-05-17 04:21:06.000000000 +0900 +++ src/sbin/hastctl/hastctl.8 2012-05-17 04:21:26.000000000 +0900 @@ -211,7 +211,7 @@ .Xr ggatel 8 , .Xr hastd 8 , .Xr mount 8 , -.Xr newfs 8 . +.Xr newfs 8 .Sh AUTHORS The .Nm diff -u src/sbin/hastd/hastd.8.orig src/sbin/hastd/hastd.8 --- src/sbin/hastd/hastd.8.orig 2012-05-17 04:21:34.000000000 +0900 +++ src/sbin/hastd/hastd.8 2012-05-17 04:21:50.000000000 +0900 @@ -223,7 +223,7 @@ .Xr hastctl 8 , .Xr mount 8 , .Xr newfs 8 , -.Xr g_bio 9 . +.Xr g_bio 9 .Sh AUTHORS The .Nm diff -u src/contrib/amd/hlfsd/hlfsd.8.orig src/contrib/amd/hlfsd/hlfsd.8 --- src/contrib/amd/hlfsd/hlfsd.8.orig 2012-05-17 04:22:04.000000000 +0900 +++ src/contrib/amd/hlfsd/hlfsd.8 2012-05-17 04:23:08.000000000 +0900 @@ -267,7 +267,7 @@ or mis-delivery of mail. The option is ignored on systems that can turn off the attribute-cache. -.It Fl D Ar log-options +.It Fl D Ar debug-options Select from a variety of debugging options. Prefixing an option with the string diff -u src/usr.sbin/i2c/i2c.8.orig src/usr.sbin/i2c/i2c.8 --- src/usr.sbin/i2c/i2c.8.orig 2012-05-17 04:23:22.000000000 +0900 +++ src/usr.sbin/i2c/i2c.8 2012-05-17 04:23:41.000000000 +0900 @@ -88,7 +88,7 @@ .It Fl s scan the bus for devices. .It Fl v -be verbose +be verbose. .It Fl w Ar 0|8|16 device addressing width (in bits). .El diff -u src/sbin/ifconfig/ifconfig.8.orig src/sbin/ifconfig/ifconfig.8 --- src/sbin/ifconfig/ifconfig.8.orig 2012-05-17 04:24:00.000000000 +0900 +++ src/sbin/ifconfig/ifconfig.8 2012-05-17 04:25:53.000000000 +0900 @@ -708,13 +708,13 @@ .Cm sta , .Cm ahdemo (or -.Cm adhoc-demo ), +.Cm adhoc-demo ) , .Cm ibss , (or -.Cm adhoc ), +.Cm adhoc ) , .Cm ap , (or -.Cm hostap ), +.Cm hostap ) , .Cm wds , .Cm tdma , .Cm mesh , @@ -2020,7 +2020,7 @@ discover a path to us. .It Cm PROACTIVE Send broadcast path requests every two seconds and every node must reply with -with a path reply even if it already has a path to this root mesh station. +a path reply even if it already has a path to this root mesh station. .It Cm RANN Send broadcast root announcement (RANN) frames. Nodes on the mesh without a path to this root mesh station with try to @@ -2378,7 +2378,8 @@ .It Cm grekey Ar key Configure the GRE key to be used for outgoing packets. Note that -.Xr gre 4 will always accept GRE packets with invalid or absent keys. +.Xr gre 4 +will always accept GRE packets with invalid or absent keys. This command will result in a four byte MTU reduction on the interface. .El .Pp @@ -2590,7 +2591,7 @@ printed. For example, the values of 802.11 WEP keys and .Xr carp 4 -passphrases will be printed, if accessible to the current user. +passphrase will be printed, if accessible to the current user. This information is not printed by default, as it may be considered sensitive. .Pp diff -u src/contrib/ipfilter/man/ipf.8.orig src/contrib/ipfilter/man/ipf.8 --- src/contrib/ipfilter/man/ipf.8.orig 2012-05-17 04:26:11.000000000 +0900 +++ src/contrib/ipfilter/man/ipf.8 2012-05-17 04:27:51.000000000 +0900 @@ -42,11 +42,11 @@ .TP .B \-c This option causes \fBipf\fP to generate output files for a compiler that -supports \fBlanguage\fI. At present, the only target language supported is -\fBC\fB (-cc) for which two files - \fBip_rules.c\fP +supports \fBlanguage\fP. At present, the only target language supported is +\fBC\fP (-cc) for which two files - \fBip_rules.c\fP and \fBip_rules.h\fP are generated in the \fBCURRENT DIRECTORY\fP when \fBipf\fP is being run. These files can be used with the -\fBIPFILTER_COMPILED\fP kernel option to build filter rules staticlly into +\fBIPFILTER_COMPILED\fP kernel option to build filter rules statically into the kernel. .TP .B \-d diff -u src/sbin/ipfw/ipfw.8.orig src/sbin/ipfw/ipfw.8 --- src/sbin/ipfw/ipfw.8.orig 2012-05-17 04:28:12.000000000 +0900 +++ src/sbin/ipfw/ipfw.8 2012-05-17 04:35:09.000000000 +0900 @@ -7,7 +7,7 @@ .Sh NAME .Nm ipfw .Nd User interface for firewall, traffic shaper, packet scheduler, -in-kernel NAT. +in-kernel NAT .Sh SYNOPSIS .Ss FIREWALL CONFIGURATION .Nm @@ -387,7 +387,7 @@ for the place of invocation (e.g.\& trying to match a MAC header within .Cm ip_input or -.Cm ip6_input ), +.Cm ip6_input ) , the match pattern will not match, but a .Cm not operator in front of such patterns @@ -843,7 +843,7 @@ and .Cm return actions don't do any jumps and simply go to the next rule if memory -can't be allocated or stack overflowed/undeflowed. +can't be allocated or stack overflowed/underflowed. .Pp Internally stack for rule numbers is implemented using .Xr mbuf_tags 9 @@ -914,7 +914,7 @@ where .Ar code is a number from 0, 1, 3 or 4, or one of these aliases: -.Cm no-route, admin-prohib, address +.Cm no-route , admin-prohib , address or .Cm port . The search terminates. @@ -1525,7 +1525,7 @@ .Cm port numbers (i.e., one or more comma-separated single values or ranges). You can use symbolic names for known values such as -.Em vlan , ipv4, ipv6 . +.Em vlan , ipv4 , ipv6 . Values can be entered as decimal or hexadecimal (if prefixed by 0x), and they are always printed as hexadecimal (unless the .Cm -N @@ -1781,11 +1781,11 @@ The .Cm tablearg argument can be used with the following actions: -.Cm nat, pipe , queue, divert, tee, netgraph, ngtee, fwd, skipto, setfib, +.Cm nat, pipe , queue , divert , tee , netgraph , ngtee , fwd , skipto , setfib , action parameters: -.Cm tag, untag, +.Cm tag , untag , rule options: -.Cm limit, tagged. +.Cm limit , tagged . .Pp When used with .Cm fwd @@ -1883,7 +1883,7 @@ are used here only to denote the initial match addresses, but they are completely equivalent afterwards). Dynamic rules will be checked at the first -.Cm check-state, keep-state +.Cm check-state , keep-state or .Cm limit occurrence, and the action performed upon a match will be the same @@ -2713,7 +2713,7 @@ Global tracking is disabled .It Cm >1 Enables tracking, the maximum number of addresses tracked for each -association is limited to this value +association is limited to this value. .El .Pp This variable is fully dynamic, the new value will be adopted for all newly @@ -2789,7 +2789,8 @@ .It Va net.inet.ip.fw.default_rule : No 65535 The default rule number (read-only). By the design of -.Nm , the default rule is the last one, so its number +.Nm , +the default rule is the last one, so its number can also serve as the highest number allowed for a rule. .It Va net.inet.ip.fw.dyn_buckets : No 256 The number of buckets in the hash table for dynamic rules. diff -u src/contrib/ipfilter/man/ipmon.8.orig src/contrib/ipfilter/man/ipmon.8 --- src/contrib/ipfilter/man/ipmon.8.orig 2012-05-17 04:35:46.000000000 +0900 +++ src/contrib/ipfilter/man/ipmon.8 2012-05-17 04:39:16.000000000 +0900 @@ -49,7 +49,7 @@ 4. The group and rule number of the rule, e.g., \fB@0:17\fP. These can be viewed with \fBipfstat -n\fP. .LP -5. The action: \fBp\fP for passed, \fBb\fP for blocked, \fB\fP for a short +5. The action: \fBp\fP for passed, \fBb\fP for blocked, \fBS\fP for a short packet, \fBn\fP did not match any rules or \fBL\fP for a log rule. .LP 6. The addresses. @@ -131,7 +131,7 @@ .TP .B \-P Write the pid of the ipmon process to a file. By default this is -\fI//etc/opt/ipf/ipmon.pid\fP (Solaris), \fI/var/run/ipmon.pid\fP (44BSD +\fI/etc/opt/ipf/ipmon.pid\fP (Solaris), \fI/var/run/ipmon.pid\fP (44BSD or later) or \fI/etc/ipmon.pid\fP for all others. .TP .B \-s diff -u src/contrib/ipfilter/man/ippool.8.orig src/contrib/ipfilter/man/ippool.8 --- src/contrib/ipfilter/man/ippool.8.orig 2012-05-17 04:39:23.000000000 +0900 +++ src/contrib/ipfilter/man/ippool.8 2012-05-17 04:39:36.000000000 +0900 @@ -108,7 +108,7 @@ type pools. .TP .B -t -Sets the type of pool being defined. Myst be one of +Sets the type of pool being defined. Must be one of .B tree, .B hash, .B group-map. diff -u src/usr.sbin/jail/jail.8.orig src/usr.sbin/jail/jail.8 --- src/usr.sbin/jail/jail.8.orig 2012-05-17 04:39:48.000000000 +0900 +++ src/usr.sbin/jail/jail.8 2012-05-17 04:41:03.000000000 +0900 @@ -255,7 +255,7 @@ .Dq true and .Dq false . -Other partameters may have more than one value, specified as a +Other parameters may have more than one value, specified as a comma-separated list or with .Dq += in the configuration file (see @@ -269,7 +269,7 @@ can be seen with .Xr jls 8 , and can (usually) be changed with -.Dq Nm Fl m. +.Dq Nm Fl m . Then there are pseudo-parameters that are only used by .Nm itself. @@ -580,7 +580,7 @@ command lines that are run in either the system or prison environment. They may be given multiple values, which run would the specified commands in sequence. -All commands must succed (return a zero exit status), or the jail will +All commands must succeed (return a zero exit status), or the jail will not be created or removed. .Pp The pseudo-parameters are: @@ -657,7 +657,8 @@ after sending them a .Dv SIGTERM signal (which happens after the -.Va exec.stop commands have completed). +.Va exec.stop +commands have completed). After this many seconds have passed, the prison will be removed, which will kill any remaining processes. If this is set to zero, no diff -u src/sys/boot/common/loader.8.orig src/sys/boot/common/loader.8 --- src/sys/boot/common/loader.8.orig 2012-05-17 04:41:16.000000000 +0900 +++ src/sys/boot/common/loader.8 2012-05-17 04:41:27.000000000 +0900 @@ -423,7 +423,7 @@ Defines the base i/o port used to access console UART (i386 and amd64 only). If the variable is not set, its assumed value is 0x3F8, which -corresponds to PC port COM1, unless overriden by +corresponds to PC port COM1, unless overridden by .Va BOOT_COMCONSOLE_PORT variable during the compilation of .Nm . diff -u src/sys/boot/forth/menu.4th.8.orig src/sys/boot/forth/menu.4th.8 --- src/sys/boot/forth/menu.4th.8.orig 2012-05-17 04:41:50.000000000 +0900 +++ src/sys/boot/forth/menu.4th.8 2012-05-17 04:41:55.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm menu.4th -.Nd FreeBSD dynamic menu boot module. +.Nd FreeBSD dynamic menu boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/sbin/mount/mount.8.orig src/sbin/mount/mount.8 --- src/sbin/mount/mount.8.orig 2012-05-17 04:42:04.000000000 +0900 +++ src/sbin/mount/mount.8 2012-05-17 04:42:29.000000000 +0900 @@ -448,7 +448,7 @@ .Cm smbfs , .Cm udf , and -.Cm unionfs , +.Cm unionfs . .Nm will not call .Xr nmount 2 diff -u src/sbin/natd/natd.8.orig src/sbin/natd/natd.8 --- src/sbin/natd/natd.8.orig 2012-05-17 04:42:40.000000000 +0900 +++ src/sbin/natd/natd.8 2012-05-17 04:42:50.000000000 +0900 @@ -787,7 +787,7 @@ .Pp Here the packet from internal network to Internet goes out via .Ql sis0 -(rule number 2000) and gets catched by the +(rule number 2000) and gets caught by the .Ic globalport socket (3000). After that, either a match is found in a translation table diff -u src/usr.sbin/wpa/ndis_ents/ndis_events.8,v.orig src/usr.sbin/wpa/ndis_ents/ndis_events.8,v --- src/usr.sbin/wpa/ndis_ents/ndis_events.8,v.orig 2012-05-17 04:42:56.000000000 +0900 +++ src/usr.sbin/wpa/ndis_ents/ndis_events.8,v 2012-05-17 04:43:11.000000000 +0900 @@ -71,7 +71,7 @@ interface, it transmits it via UDP packet on the loopback interface, where .Xr wpa_supplicant 8 -is presumeably listening. +is presumably listening. The standard .Xr wpa_supplicant 8 distribution includes its own version of this utility for use with diff -u src/usr.sbin/nfsroke/nfsrevoke.8,v.orig src/usr.sbin/nfsroke/nfsrevoke.8,v --- src/usr.sbin/nfsroke/nfsrevoke.8,v.orig 2012-05-17 04:43:22.000000000 +0900 +++ src/usr.sbin/nfsroke/nfsrevoke.8,v 2012-05-17 04:43:37.000000000 +0900 @@ -37,7 +37,7 @@ .Ar ClientId .Sh DESCRIPTION .Nm -This command is used by a system administrator to revoke a client's access +command is used by a system administrator to revoke a client's access to the NFS Version 4 server. All Open/Lock state held by the client will be released. After revocation, the client will no longer be able to use state on the server diff -u src/usr.sbin/ntp/doc/ntp-keygen.8.orig src/usr.sbin/ntp/doc/ntp-keygen.8 --- src/usr.sbin/ntp/doc/ntp-keygen.8.orig 2012-05-17 04:43:52.000000000 +0900 +++ src/usr.sbin/ntp/doc/ntp-keygen.8 2012-05-17 04:51:18.000000000 +0900 @@ -201,7 +201,7 @@ Each cryptographic configuration involves selection of a signature scheme and identification scheme, called a cryptotype, as explained in the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . The default cryptotype uses RSA encryption, MD5 message digest @@ -290,7 +290,7 @@ Trusted hosts prove identity using values provided by the TA, while the remaining hosts prove identity using values provided by a trusted host and certificate trails that end on that host. -The name of a trusted host is also the name of its sugroup +The name of a trusted host is also the name of its su group and also the subject and issuer name on its trusted certificate. The TA is not necessarily a trusted host in this sense, but often is. .Pp @@ -411,7 +411,7 @@ to her clients. It doesn't matter which client key file goes to alice, since they all work the same way. -Alice copies the client key file to all of her cliens. +Alice copies the client key file to all of her clients. On client bob install a soft link from generic .Pa ntpkey_mvkey_ Ns Ar bob to the client key file. @@ -450,7 +450,7 @@ Generate parameters for the IFF identification scheme, obsoleting any that may exist. .It Fl i Ar name -Set the suject name to +Set the subject name to .Ar name . This is used as the subject field in certificates and in the file name for host and sign keys. @@ -594,7 +594,7 @@ and .Xr ntpdc 8 utilities. -.Sh Bugs +.Sh BUGS It can take quite a while to generate some cryptographic values, from one to several minutes with modern architectures such as UltraSPARC and up to tens of minutes to an hour diff -u src/usr.sbin/ntp/doc/ntpdc.8.orig src/usr.sbin/ntp/doc/ntpdc.8 --- src/usr.sbin/ntp/doc/ntpdc.8.orig 2012-05-17 23:38:04.000000000 +0900 +++ src/usr.sbin/ntp/doc/ntpdc.8 2012-05-17 23:42:59.000000000 +0900 @@ -608,7 +608,7 @@ .It Cm monitor Enables the monitoring facility. See the -.Xr src/usr.sbin/ntp/doc/ntpdc.8 . +.Xr src/usr.sbin/ntp/doc/ntpdc.8 program and the monlist command or further information. The default for this flag is enable. .It Cm ntp @@ -629,7 +629,7 @@ .It Cm stats Enables the statistics facility. See the -.Sx Monitoring Options +.Sx Monitoring Support section of .Xr ntp.conf 5 for further information. diff -u src/usr.sbin/ntp/doc/ntpq.8.orig src/usr.sbin/ntp/doc/ntpq.8 --- src/usr.sbin/ntp/doc/ntpq.8.orig 2012-05-17 23:43:12.000000000 +0900 +++ src/usr.sbin/ntp/doc/ntpq.8 2012-05-17 23:45:38.000000000 +0900 @@ -32,7 +32,7 @@ The .Nm can also obtain and print a list of peers in a common format -by sendingmultiple queries to the server. +by sending multiple queries to the server. .Pp If one or more request options is included on the command line when @@ -492,7 +492,7 @@ billboard, called the tally code, shows the fate of each association in the clock selection process. -Following is a list of these characters, the pigeon used +Following is a list of these characters, the pidgeon used in the .Ic rv command, and a short explanation of the condition revealed. @@ -749,7 +749,7 @@ .Sy TEST12 check the authentication state using Autokey public-key cryptography, as described in the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . If @@ -790,7 +790,7 @@ .Pq TEST5 Cryptographic authentication fails. See the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . .It 0x020 @@ -809,12 +809,12 @@ .It 0x100 .Pq TEST9 Either the peer delay or dispersion is greater than one second, which is -higly unlikely unless the peer is on Mars. +highly unlikely unless the peer is on Mars. .It 0x200 .Pq TEST10 The autokey protocol has detected an authentication failure. See the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . .It 0x400 @@ -822,7 +822,7 @@ The autokey protocol has not verified the server or peer is proventic and has valid public key credentials. See the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . .It 0x800 @@ -830,7 +830,7 @@ A protocol or configuration error has occurred in the public key algorithms or a possible intrusion event has been detected. See the -.Sx Authentication Options +.Sx Authentication Commands section of .Xr ntp.conf 5 . .El diff -u src/lib/libpam/modules/pam_exec/pam_exec.8.orig src/lib/libpam/modules/pam_exec/pam_exec.8 --- src/lib/libpam/modules/pam_exec/pam_exec.8.orig 2012-05-17 23:45:53.000000000 +0900 +++ src/lib/libpam/modules/pam_exec/pam_exec.8 2012-05-17 23:46:11.000000000 +0900 @@ -131,10 +131,10 @@ .Xr pam 8 , .Xr pam_sm_acct_mgmt 8 , .Xr pam_sm_authenticate 8 , -.Xr pam_sm_chauthtok 8, +.Xr pam_sm_chauthtok 8 , .Xr pam_sm_close_session 8 , .Xr pam_sm_open_session 8 , -.Xr pam_sm_setcred 8 . +.Xr pam_sm_setcred 8 .Sh AUTHORS The .Nm diff -u src/usr.sbin/pc-sysinstall/pc-sysinstall/pc-sysinstall.8.orig src/usr.sbin/pc-sysinstall/pc-sysinstall/pc-sysinstall.8 --- src/usr.sbin/pc-sysinstall/pc-sysinstall/pc-sysinstall.8.orig 2012-05-17 23:46:18.000000000 +0900 +++ src/usr.sbin/pc-sysinstall/pc-sysinstall/pc-sysinstall.8 2012-05-17 23:46:50.000000000 +0900 @@ -47,7 +47,7 @@ .Bl -tag -width indent .It Fl c Ar file Perform an installation as directed by -.Ar file. +.Ar file . .El .Sh COMMANDS The @@ -69,7 +69,7 @@ .It detect-laptop Tests to see if this system is a laptop or desktop. .It detect-emulation -Tests to see if this system is running in an emulator +Tests to see if this system is running in an emulator. .It detect-nics Returns a listing of the detected network cards on this system. .It list-components diff -u src/share/man/man8/picobsd.8.orig src/share/man/man8/picobsd.8 --- src/share/man/man8/picobsd.8.orig 2012-05-17 23:47:00.000000000 +0900 +++ src/share/man/man8/picobsd.8 2012-05-17 23:47:54.000000000 +0900 @@ -54,7 +54,7 @@ .Fl src , .Fl init , .Fl n and -.Fl v. +.Fl v . .Bl -tag -width indent .\" .It Fl -all_in_mfs @@ -94,7 +94,7 @@ images. .\" .It Fl -iso -Generate an ISO image, picobsd.iso, in addition to the disk image picobsd.bin +Generate an ISO image, picobsd.iso, in addition to the disk image picobsd.bin. .\" .It Fl -modules Also build kernel modules. diff -u src/share/man/man8/rc.8.orig src/share/man/man8/rc.8 --- src/share/man/man8/rc.8.orig 2012-05-17 23:48:13.000000000 +0900 +++ src/share/man/man8/rc.8 2012-05-17 23:48:29.000000000 +0900 @@ -253,7 +253,7 @@ but a script can stop the boot if necessary by invoking the .Fn stop_boot function (from -.Xr rc.subr 8 ). +.Xr rc.subr 8 ) . .El .Pp Each script should contain diff -u src/usr.bin/rctl/rctl.8.orig src/usr.bin/rctl/rctl.8 --- src/usr.bin/rctl/rctl.8.orig 2012-05-17 23:48:37.000000000 +0900 +++ src/usr.bin/rctl/rctl.8 2012-05-17 23:48:46.000000000 +0900 @@ -156,7 +156,7 @@ for a list of supported signals. .Pp Not all actions are supported for all resources. -Attempt to add rule with action not supported by a given resouce will result +Attempt to add rule with action not supported by a given resource will result in error. .Pp Note that limiting RSS may kill the machine due to thrashing. diff -u src/usr.sbin/rtactl/rtadvctl.8,v.orig src/usr.sbin/rtactl/rtadvctl.8,v --- src/usr.sbin/rtactl/rtadvctl.8,v.orig 2012-05-17 23:48:54.000000000 +0900 +++ src/usr.sbin/rtactl/rtadvctl.8,v 2012-05-17 23:49:08.000000000 +0900 @@ -31,7 +31,8 @@ .Sh NAME .Nm rtadvctl .Nd control program for -.Xr rtadvd 8 daemon +.Xr rtadvd 8 +daemon .Sh SYNOPSIS .Nm .Op Fl v diff -u src/usr.sbin/rtad/rtadvd.8,v.orig src/usr.sbin/rtad/rtadvd.8,v --- src/usr.sbin/rtad/rtadvd.8,v.orig 2012-05-17 23:49:18.000000000 +0900 +++ src/usr.sbin/rtad/rtadvd.8,v 2012-05-17 23:49:28.000000000 +0900 @@ -140,7 +140,7 @@ .It Fl p Specify an alternative file in which to store the process ID. The default is -.Pa /var/run/rtadvd.pid. +.Pa /var/run/rtadvd.pid . .It Fl R Accept router renumbering requests. If you enable it, certain IPsec setup is suggested for security reasons. diff -u src/usr.sbin/smbmsg/smbmsg.8.orig src/usr.sbin/smbmsg/smbmsg.8 --- src/usr.sbin/smbmsg/smbmsg.8.orig 2012-05-17 23:51:03.000000000 +0900 +++ src/usr.sbin/smbmsg/smbmsg.8 2012-05-17 23:51:14.000000000 +0900 @@ -70,7 +70,7 @@ The only valid additional option for this modus of operation (besides the .Fl p -option that choses the modus) is +option that chooses the modus) is .Fl f Ar dev . See below for a description. .Pp diff -u src/crypto/openssh/sshd.8.orig src/crypto/openssh/sshd.8 --- src/crypto/openssh/sshd.8.orig 2012-05-17 23:51:23.000000000 +0900 +++ src/crypto/openssh/sshd.8 2012-05-17 23:51:33.000000000 +0900 @@ -386,7 +386,8 @@ If the login is on a tty, records login time. .It Checks -.Pa /etc/nologin and +.Pa /etc/nologin +and .Pa /var/run/nologin ; if one exists, it prints the contents and quits (unless root). diff -u src/libexec/tftpd/tftpd.8.orig src/libexec/tftpd/tftpd.8 --- src/libexec/tftpd/tftpd.8.orig 2012-05-17 23:51:49.000000000 +0900 +++ src/libexec/tftpd/tftpd.8 2012-05-17 23:52:31.000000000 +0900 @@ -165,7 +165,7 @@ .Ar value . The debug level is a bitmask implemented in .Pa src/libexec/tftpd/tftp-utils.h . -Valid values are 0 (DEBUG_NONE), 1 (DEBUG_PACKETS), 2, (DEBUG_SIMPLE), +Valid values are 0 (DEBUG_NONE), 1 (DEBUG_PACKETS), 2 (DEBUG_SIMPLE), 4 (DEBUG_OPTIONS), and 8 (DEBUG_ACCESS). Multiple debug values can be combined in the bitmask by logically OR'ing the values. For example, specifying .Fl d @@ -218,7 +218,7 @@ Note that this only works in directories writable by the user specified with .Fl u -option +option. .It Fl W As .Fl w diff -u src/usr.sbin/utx/utx.8.orig src/usr.sbin/utx/utx.8 --- src/usr.sbin/utx/utx.8.orig 2012-05-17 23:52:40.000000000 +0900 +++ src/usr.sbin/utx/utx.8 2012-05-17 23:52:58.000000000 +0900 @@ -94,7 +94,7 @@ .Sh SEE ALSO .Xr getent 1 , .Xr w 1 , -.Xr pututxline 3 . +.Xr pututxline 3 .Sh HISTORY The .Nm diff -u src/sys/boot/forthersion.4th.8,v.orig src/sys/boot/forthersion.4th.8,v --- src/sys/boot/forthersion.4th.8,v.orig 2012-05-17 23:53:05.000000000 +0900 +++ src/sys/boot/forthersion.4th.8,v 2012-05-17 23:53:42.000000000 +0900 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm version.4th -.Nd FreeBSD version string boot module. +.Nd FreeBSD version string boot module .Sh DESCRIPTION The file that goes by the name of .Nm diff -u src/cddl/contrib/opensolaris/cmd/zpool/zpool.8.orig src/cddl/contrib/opensolaris/cmd/zpool/zpool.8 --- src/cddl/contrib/opensolaris/cmd/zpool/zpool.8.orig 2012-05-17 23:54:39.000000000 +0900 +++ src/cddl/contrib/opensolaris/cmd/zpool/zpool.8 2012-05-17 23:56:33.000000000 +0900 @@ -654,7 +654,7 @@ .It Sy dedupditto Ns = Ns Ar number Threshold for the number of block ditto copies. If the reference count for a deduplicated block increases above this number, a new ditto copy of this block -is automatically stored. Deafult setting is +is automatically stored. Default setting is .Cm 0 . .It Sy delegation Ns = Ns Cm on No | Cm off Controls whether a non-privileged user is granted access based on the dataset @@ -832,7 +832,7 @@ in use by another subsystem. There are some uses, such as being currently mounted, or specified as the dedicated dump device, that prevents a device from ever being used by -.Tn ZFS +.Tn ZFS . Other uses, such as having a preexisting .Sy UFS file system, can be overridden with the @@ -882,7 +882,8 @@ .Ar ... .Xc Sets the given file system properties in the root file system of the pool. See -.Xr zfs 8 Properties +.Xr zfs 8 +Properties for a list of valid properties that can be set. .It Fl R Ar root @@ -1110,7 +1111,7 @@ and the .Qq Sy altroot property to -.Qq Ar root +.Qq Ar root . .It Fl F Recovery mode for a non-importable pool. Attempt to return the pool to an importable state by discarding the last few transactions. Not all damaged pools >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu May 17 15:45:51 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AE584106566C; Thu, 17 May 2012 15:45:51 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 838A18FC1F; Thu, 17 May 2012 15:45:51 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4HFjpkE067157; Thu, 17 May 2012 15:45:51 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4HFjp1B067153; Thu, 17 May 2012 15:45:51 GMT (envelope-from gjb) Date: Thu, 17 May 2012 15:45:51 GMT Message-Id: <201205171545.q4HFjp1B067153@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/168016: groff mandoc style, usage mistakes or typos. (man8) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 May 2012 15:45:51 -0000 Synopsis: groff mandoc style, usage mistakes or typos. (man8) Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Thu May 17 15:45:43 UTC 2012 Responsible-Changed-Why: Over to me. http://www.freebsd.org/cgi/query-pr.cgi?pr=168016 From owner-freebsd-doc@FreeBSD.ORG Thu May 17 21:17:31 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 02527106564A for ; Thu, 17 May 2012 21:17:31 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id B55808FC15 for ; Thu, 17 May 2012 21:17:30 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q4HLHTXp061820 for ; Thu, 17 May 2012 15:17:29 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q4HLHTUY061817 for ; Thu, 17 May 2012 15:17:29 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Thu, 17 May 2012 15:17:29 -0600 (MDT) From: Warren Block To: doc@freebsd.org Message-ID: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Thu, 17 May 2012 15:17:30 -0600 (MDT) Cc: Subject: Handbook mirroring section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 May 2012 21:17:31 -0000 Summary: Handbook mirror example broken, new rewrite here, feedback desired before commit. http://www.wonkity.com/~wblock/mirror/book.html http://www.wonkity.com/~wblock/mirror/chapter.diff More detail: The existing mirroring section in the GEOM chapter of the Handbook uses a workaround to add another drive and make a mirror with one existing drive without moving data. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html That workaround creates mirrors that FreeBSD 9 and later versions of 8 see as having invalid, overlapping areas. The more strict tests prevent at least FreeBSD 9 from even booting from mirrors created that way: http://www.freebsd.org/releases/9.0R/relnotes-detailed.html#AEN1277 Ideally, the procedure would be able to create a single-drive mirror but use only a limited amount of disk space on the new drive, making that space the same size as the existing drive. (Here's a new 80G drive, but I only want to use 40G of space for the mirror.) Of course this can be done with partitions, but that is more complex and there may be thrashing issues with multiple partitions. It turns out to be fairly difficult to do this in a situation that will work reliably for the average user. I've rewritten the mirroring section to just use two new drives. A mirror *can* be created with two different-sized drives, provided they are both seen at the time of creation. The smaller size is used; exposing that size with a command-line option would be very useful. From owner-freebsd-doc@FreeBSD.ORG Thu May 17 21:47:49 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D0A0A106564A for ; Thu, 17 May 2012 21:47:49 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id 426668FC18 for ; Thu, 17 May 2012 21:47:49 +0000 (UTC) Received: (qmail 74036 invoked by uid 0); 17 May 2012 17:47:48 -0400 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 17 May 2012 17:47:48 -0400 Date: Thu, 17 May 2012 17:47:46 -0400 From: Glen Barber To: Warren Block Message-ID: <20120517214746.GB1414@glenbarber.us> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: doc@freebsd.org Subject: Re: Handbook mirroring section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 May 2012 21:47:49 -0000 On Thu, May 17, 2012 at 03:17:29PM -0600, Warren Block wrote: > Summary: Handbook mirror example broken, new rewrite here, feedback > desired before commit. > > http://www.wonkity.com/~wblock/mirror/book.html > http://www.wonkity.com/~wblock/mirror/chapter.diff > > I think it looks good. Glen From owner-freebsd-doc@FreeBSD.ORG Thu May 17 22:27:05 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 776CD106566B for ; Thu, 17 May 2012 22:27:05 +0000 (UTC) (envelope-from mexas@bristol.ac.uk) Received: from dirg.bris.ac.uk (dirg.bris.ac.uk [137.222.10.102]) by mx1.freebsd.org (Postfix) with ESMTP id 2DE608FC08 for ; Thu, 17 May 2012 22:27:05 +0000 (UTC) Received: from ncsd.bris.ac.uk ([137.222.10.59] helo=ncs.bris.ac.uk) by dirg.bris.ac.uk with esmtp (Exim 4.72) (envelope-from ) id 1SV99u-0002iq-HK; Thu, 17 May 2012 23:26:58 +0100 Received: from mech-cluster241.men.bris.ac.uk ([137.222.187.241]) by ncs.bris.ac.uk with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.72) (envelope-from ) id 1SV99u-0004iz-2d; Thu, 17 May 2012 23:26:58 +0100 Received: from mech-cluster241.men.bris.ac.uk (localhost [127.0.0.1]) by mech-cluster241.men.bris.ac.uk (8.14.5/8.14.5) with ESMTP id q4HMQvaN014422; Thu, 17 May 2012 23:26:57 +0100 (BST) (envelope-from mexas@bris.ac.uk) Received: (from mexas@localhost) by mech-cluster241.men.bris.ac.uk (8.14.5/8.14.5/Submit) id q4HMQvJZ014421; Thu, 17 May 2012 23:26:57 +0100 (BST) (envelope-from mexas@bris.ac.uk) X-Authentication-Warning: mech-cluster241.men.bris.ac.uk: mexas set sender to mexas@bris.ac.uk using -f Date: Thu, 17 May 2012 23:26:57 +0100 From: Anton Shterenlikht To: Warren Block Message-ID: <20120517222657.GA14370@mech-cluster241.men.bris.ac.uk> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.2.3i Cc: doc@freebsd.org Subject: Re: Handbook mirroring section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 May 2012 22:27:05 -0000 On Thu, May 17, 2012 at 03:17:29PM -0600, Warren Block wrote: > Summary: Handbook mirror example broken, new rewrite here, feedback > desired before commit. > > http://www.wonkity.com/~wblock/mirror/book.html > http://www.wonkity.com/~wblock/mirror/chapter.diff > > > More detail: > > The existing mirroring section in the GEOM chapter of the Handbook uses > a workaround to add another drive and make a mirror with one existing > drive without moving data. > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html > > That workaround creates mirrors that FreeBSD 9 and later versions of 8 > see as having invalid, overlapping areas. The more strict tests prevent > at least FreeBSD 9 from even booting from mirrors created that way: > > http://www.freebsd.org/releases/9.0R/relnotes-detailed.html#AEN1277 > > Ideally, the procedure would be able to create a single-drive mirror but > use only a limited amount of disk space on the new drive, making that > space the same size as the existing drive. (Here's a new 80G drive, but > I only want to use 40G of space for the mirror.) Of course this can be > done with partitions, but that is more complex and there may be > thrashing issues with multiple partitions. > > It turns out to be fairly difficult to do this in a situation that will > work reliably for the average user. > > I've rewritten the mirroring section to just use two new drives. > > A mirror *can* be created with two different-sized drives, provided they > are both seen at the time of creation. The smaller size is used; > exposing that size with a command-line option would be very useful. I haven't read your update thoroughly. This is just to mention that you might want to look at http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/136712 It might be completely out of date by now, in which case feel free to close this PR. -- Anton Shterenlikht Room 2.6, Queen's Building Mech Eng Dept Bristol University University Walk, Bristol BS8 1TR, UK Tel: +44 (0)117 331 5944 Fax: +44 (0)117 929 4423 From owner-freebsd-doc@FreeBSD.ORG Fri May 18 19:00:19 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 9559E1065674 for ; Fri, 18 May 2012 19:00:19 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 53A698FC17 for ; Fri, 18 May 2012 19:00:19 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4IJ0J61031477 for ; Fri, 18 May 2012 19:00:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4IJ0JsE031476; Fri, 18 May 2012 19:00:19 GMT (envelope-from gnats) Resent-Date: Fri, 18 May 2012 19:00:19 GMT Resent-Message-Id: <201205181900.q4IJ0JsE031476@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, kogane@jp.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C3F4F1065675 for ; Fri, 18 May 2012 18:57:47 +0000 (UTC) (envelope-from n-kogane@syd.odn.ne.jp) Received: from cmta102.odn.ne.jp (mta102.odn.ne.jp [143.90.14.138]) by mx1.freebsd.org (Postfix) with ESMTP id E548D8FC16 for ; Fri, 18 May 2012 18:57:46 +0000 (UTC) Received: from vmta102.odn.ne.jp by cmta102.odn.ne.jp with ESMTP id <20120518185739852.EYLY.19197.cmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Sat, 19 May 2012 03:57:39 +0900 Received: from emta102.odn.ne.jp by vmta102.odn.ne.jp with ESMTP id <20120518185739807.CLDS.22061.vmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Sat, 19 May 2012 03:57:39 +0900 Received: from kcesx30.koganemaru.co.jp ([218.218.68.33] [218.218.68.33]) by emta102.odn.ne.jp with ESMTP id <20120518185739264.BPRK.16274.emta102.odn.ne.jp@mta102.odn.ne.jp> for ; Sat, 19 May 2012 03:57:39 +0900 Received: by kcesx30.koganemaru.co.jp (Postfix, from userid 100) id ACE162842A; Sat, 19 May 2012 03:56:05 +0900 (JST) Message-Id: <20120518185605.ACE162842A@kcesx30.koganemaru.co.jp> Date: Sat, 19 May 2012 03:56:05 +0900 (JST) From: Nobuyuki Koganemaru To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/168117: groff mandoc style, usage mistakes or typos. (man9) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: kogane@jp.freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 18 May 2012 19:00:19 -0000 >Number: 168117 >Category: docs >Synopsis: groff mandoc style, usage mistakes or typos. (man9) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri May 18 19:00:18 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Nobuyuki Koganemaru >Release: FreeBSD 10.0-CURRENT >Organization: KOGANEMARU Computer Engineering Service Corporation. >Environment: System: FreeBSD kcesx31.koganemaru.co.jp 8.2-RELEASE-p6 FreeBSD 8.2-RELEASE-p6 #0: Tue Apr 24 03:49:22 JST 2012 root@kcesx31.koganemaru.co.jp:/usr/obj/usr/src.82/sys/GENERIC i386 >Description: man9 >How-To-Repeat: none. >Fix: corrected files: BUF_ISLOCKED.9: $FreeBSD: src/share/man/man9/BUF_ISLOCKED.9,v 1.2 2010/02/27 01:17:44 delphij Exp $ DB_COMMAND.9: $FreeBSD: src/share/man/man9/DB_COMMAND.9,v 1.5 2012/05/12 20:08:16 gjb Exp $ VOP_GETEXTATTR.9: $FreeBSD: src/share/man/man9/VOP_GETEXTATTR.9,v 1.24 2012/05/12 03:46:43 gjb Exp $ VOP_GETPAGES.9: $FreeBSD: src/share/man/man9/VOP_GETPAGES.9,v 1.14 2010/10/20 05:57:54 avg Exp $ VOP_GETVOBJECT.9: $FreeBSD: src/share/man/man9/VOP_GETVOBJECT.9,v 1.9 2010/04/14 19:08:06 uqs Exp $ VOP_SETEXTATTR.9: $FreeBSD: src/share/man/man9/VOP_SETEXTATTR.9,v 1.22 2012/05/12 03:46:43 gjb Exp $ acl.9: $FreeBSD: src/share/man/man9/acl.9,v 1.21 2010/04/14 19:08:06 uqs Exp $ bus_generic_print_child.9: $FreeBSD: src/share/man/man9/bus_generic_print_child.9,v 1.11 2005/06/28 20:15:18 hmp Exp $ bus_release_resource.9: $FreeBSD: src/share/man/man9/bus_release_resource.9,v 1.11 2005/06/28 20:15:18 hmp Exp $ bus_space.9: $NetBSD: bus_space.9,v 1.9 1999/03/06 22:09:29 mycroft Exp $ $FreeBSD: src/share/man/man9/bus_space.9,v 1.10 2012/05/12 20:06:17 gjb Exp $ byteorder.9: $FreeBSD: src/share/man/man9/byteorder.9,v 1.7 2012/02/28 15:07:05 kevlo Exp $ devclass_get_maxunit.9: $FreeBSD: src/share/man/man9/devclass_get_maxunit.9,v 1.12 2012/03/29 05:02:12 eadler Exp $ device_find_child.9: $FreeBSD: src/share/man/man9/device_find_child.9,v 1.10 2005/06/15 13:31:23 ru Exp $ firmware.9: $FreeBSD: src/share/man/man9/firmware.9,v 1.10 2012/03/29 05:02:12 eadler Exp $ hashinit.9: $FreeBSD: src/share/man/man9/hashinit.9,v 1.4 2007/01/27 23:06:00 ru Exp $ ieee80211_proto.9: $FreeBSD: src/share/man/man9/ieee80211_proto.9,v 1.6 2012/03/29 05:02:12 eadler Exp $ ieee80211_vap.9: $FreeBSD: src/share/man/man9/ieee80211_vap.9,v 1.4 2012/03/29 05:02:12 eadler Exp $ ifnet.9: $FreeBSD: src/share/man/man9/ifnet.9,v 1.82 2012/03/23 16:24:07 pluknet Exp $ kqueue.9: $FreeBSD: src/share/man/man9/kqueue.9,v 1.9 2012/03/26 09:34:17 melifaro Exp $ lock.9: $FreeBSD: src/share/man/man9/lock.9,v 1.38 2012/03/29 05:02:12 eadler Exp $ locking.9: $FreeBSD: src/share/man/man9/locking.9,v 1.28 2012/05/12 03:46:43 gjb Exp $ mbuf.9: $FreeBSD: src/share/man/man9/mbuf.9,v 1.70 2011/04/18 15:30:25 glebius Exp $ mod_cc.9: $FreeBSD: src/share/man/man9/mod_cc.9,v 1.1 2011/09/15 12:15:36 lstewart Exp $ netisr.9: $FreeBSD: src/share/man/man9/netisr.9,v 1.8 2012/02/12 18:29:56 ed Exp $ pci.9: $FreeBSD: src/share/man/man9/pci.9,v 1.20 2012/03/05 20:04:28 pluknet Exp $ spl.9: $FreeBSD: src/share/man/man9/spl.9,v 1.24 2012/05/12 20:53:00 gjb Exp $ sysctl.9: $FreeBSD: src/share/man/man9/sysctl.9,v 1.13 2012/02/29 22:41:40 thompsa Exp $ taskqueue.9: $FreeBSD: src/share/man/man9/taskqueue.9,v 1.37 2012/03/29 05:02:12 eadler Exp $ usbdi.9: $FreeBSD: src/share/man/man9/usbdi.9,v 1.10 2012/05/12 20:41:40 gjb Exp $ vm_page_aflag.9: $FreeBSD: src/share/man/man9/vm_page_aflag.9,v 1.1 2011/09/06 10:40:21 kib Exp $ patch files: diff -u src/share/man/man9/BUF_ISLOCKED.9.orig src/share/man/man9/BUF_ISLOCKED.9 --- src/share/man/man9/BUF_ISLOCKED.9.orig 2012-05-19 03:13:47.000000000 +0900 +++ src/share/man/man9/BUF_ISLOCKED.9 2012-05-19 03:14:21.000000000 +0900 @@ -52,7 +52,7 @@ .It Dv LK_EXCLUSIVE An exclusive lock is held by curthread. .It Dv LK_EXCLOTHER -An exclusive lock is held by someone other than curthread +An exclusive lock is held by someone other than curthread. .It Dv LK_SHARED A shared lock is held. .It Li 0 diff -u src/share/man/man9/DB_COMMAND.9.orig src/share/man/man9/DB_COMMAND.9 --- src/share/man/man9/DB_COMMAND.9.orig 2012-05-19 03:14:35.000000000 +0900 +++ src/share/man/man9/DB_COMMAND.9 2012-05-19 03:14:53.000000000 +0900 @@ -32,7 +32,7 @@ .Nm DB_COMMAND , .Nm DB_SHOW_COMMAND , .Nm DB_SHOW_ALL_COMMAND -.Nd Extends the ddb command set. +.Nd Extends the ddb command set .Sh SYNOPSIS .In ddb/ddb.h .Fo DB_COMMAND diff -u src/share/man/man9/VOP_GETEXTATTR.9.orig src/share/man/man9/VOP_GETEXTATTR.9 --- src/share/man/man9/VOP_GETEXTATTR.9.orig 2012-05-19 03:15:32.000000000 +0900 +++ src/share/man/man9/VOP_GETEXTATTR.9 2012-05-19 03:15:58.000000000 +0900 @@ -71,7 +71,7 @@ .Dv NULL when .Fa size -is not, and vise versa. +is not, and vice versa. .It Fa cred The user credentials to use in authorizing the request. .It Fa td @@ -113,7 +113,7 @@ .It Bq Er EINVAL The .Fa name , -.Fa namespace, +.Fa namespace , or .Fa uio argument is invalid. diff -u src/share/man/man9/VOP_GETPAGES.9.orig src/share/man/man9/VOP_GETPAGES.9 --- src/share/man/man9/VOP_GETPAGES.9.orig 2012-05-19 03:16:06.000000000 +0900 +++ src/share/man/man9/VOP_GETPAGES.9 2012-05-19 03:16:34.000000000 +0900 @@ -115,7 +115,7 @@ medium or protocol. .It Dv VM_PAGER_FAIL Treated identically to -.Dv VM_PAGER_ERROR +.Dv VM_PAGER_ERROR . .It Dv VM_PAGER_AGAIN The page was not handled by this request. .El diff -u src/share/man/man9/VOP_GETVOBJECT.9.orig src/share/man/man9/VOP_GETVOBJECT.9 --- src/share/man/man9/VOP_GETVOBJECT.9.orig 2012-05-19 03:17:08.000000000 +0900 +++ src/share/man/man9/VOP_GETVOBJECT.9 2012-05-19 03:17:24.000000000 +0900 @@ -53,7 +53,7 @@ The VM object being returned, or .Dv NULL if the caller wants to test for the existence -of the VM object). +of the VM object. .El .Pp .Xr VFS 9 diff -u src/share/man/man9/VOP_SETEXTATTR.9.orig src/share/man/man9/VOP_SETEXTATTR.9 --- src/share/man/man9/VOP_SETEXTATTR.9.orig 2012-05-19 03:17:35.000000000 +0900 +++ src/share/man/man9/VOP_SETEXTATTR.9 2012-05-19 03:17:55.000000000 +0900 @@ -96,7 +96,7 @@ The request was not valid in this file system for the specified vnode and attribute name. .It Bq Er ENOMEM -Insufficient memory available to fulfill request +Insufficient memory available to fulfill request. .It Bq Er EFAULT The uio structure refers to an invalid userspace address. .It Bq Er EINVAL diff -u src/share/man/man9/acl.9.orig src/share/man/man9/acl.9 --- src/share/man/man9/acl.9.orig 2012-05-19 03:18:09.000000000 +0900 +++ src/share/man/man9/acl.9 2012-05-19 03:19:13.000000000 +0900 @@ -210,7 +210,7 @@ .Xr vaccess_acl_nfs4 9 , .Xr vaccess_acl_posix1e 9 , .Xr VFS 9 , -.Xr vnaccess 9 , +.Xr vaccess 9 , .Xr VOP_ACLCHECK 9 , .Xr VOP_GETACL 9 , .Xr VOP_SETACL 9 diff -u src/share/man/man9/bus_generic_print_child.9.orig src/share/man/man9/bus_generic_print_child.9 --- src/share/man/man9/bus_generic_print_child.9.orig 2012-05-19 03:20:30.000000000 +0900 +++ src/share/man/man9/bus_generic_print_child.9 2012-05-19 03:20:42.000000000 +0900 @@ -51,7 +51,7 @@ bus_generic_print_child itself calls two functions .Fn bus_print_child_header and -.Fn bus_print_child_footer +.Fn bus_print_child_footer . The former prints "foo0: " and the latter "on bar0". These routines should be used if possible in your own code if .Fn bus_generic_print_child diff -u src/share/man/man9/bus_release_resource.9.orig src/share/man/man9/bus_release_resource.9 --- src/share/man/man9/bus_release_resource.9.orig 2012-05-19 03:20:51.000000000 +0900 +++ src/share/man/man9/bus_release_resource.9 2012-05-19 03:27:53.000000000 +0900 @@ -71,7 +71,7 @@ .It .Fa r is the pointer to -.Va struct res , +.Va struct resource , i.e., the resource itself, returned by .Xr bus_alloc_resource 9 . diff -u src/share/man/man9/bus_space.9.orig src/share/man/man9/bus_space.9 --- src/share/man/man9/bus_space.9.orig 2012-05-19 03:28:02.000000000 +0900 +++ src/share/man/man9/bus_space.9 2012-05-19 03:52:40.000000000 +0900 @@ -1380,7 +1380,8 @@ They may also be executed out of order with respect to other pending read and write operations unless order is enforced by use of the -.Fn bus_space_barrier function . +.Fn bus_space_barrier +function. There is no way to insert barriers between reads or writes of individual bus space locations executed by the .Fn bus_space_copy_region_N diff -u src/share/man/man9/byteorder.9.orig src/share/man/man9/byteorder.9 --- src/share/man/man9/byteorder.9.orig 2012-05-19 03:29:25.000000000 +0900 +++ src/share/man/man9/byteorder.9 2012-05-19 03:29:58.000000000 +0900 @@ -158,7 +158,7 @@ The .Fn hto* and -.Fn toh* +.Fn *toh functions first appeared in .Fx 5.0 , and were originally developed by the diff -u src/share/man/man9/dclass_get_maxunit.9,v.orig src/share/man/man9/dclass_get_maxunit.9,v --- src/share/man/man9/dclass_get_maxunit.9,v.orig 2012-05-19 03:30:12.000000000 +0900 +++ src/share/man/man9/dclass_get_maxunit.9,v 2012-05-19 03:30:21.000000000 +0900 @@ -49,7 +49,7 @@ function returns -1 if .Fa dc is -.Dv NULL; +.Dv NULL ; otherwise it returns the next unit number in .Fa dc's diff -u src/share/man/man9/dice_find_child.9,v.orig src/share/man/man9/dice_find_child.9,v --- src/share/man/man9/dice_find_child.9,v.orig 2012-05-19 03:30:29.000000000 +0900 +++ src/share/man/man9/dice_find_child.9,v 2012-05-19 03:30:57.000000000 +0900 @@ -41,7 +41,7 @@ .Fn device_find_child "device_t dev" "const char *classname" "int unit" .Sh DESCRIPTION This function looks for a specific child of -.Dv dev . +.Dv dev with the given .Fa classname and diff -u src/share/man/man9/firmware.9.orig src/share/man/man9/firmware.9 --- src/share/man/man9/firmware.9.orig 2012-05-19 03:32:32.000000000 +0900 +++ src/share/man/man9/firmware.9 2012-05-19 03:33:03.000000000 +0900 @@ -101,11 +101,13 @@ the firmware subsystem will try to load it using the mechanisms specified below (typically, a kernel module with -.Nm the same name +.Nm +the same name as the image). .Sh API DESCRIPTION The kernel -.Nm firmware API +.Nm +firmware API is made of the following functions: .Pp .Fn firmware_register @@ -225,7 +227,7 @@ If you need to embed firmware images into a system, you should write appropriate entries in the file, e.g. this example is from -.Nm sys/arm/xscale/ixp425/files.ixp425: +.Nm sys/arm/xscale/ixp425/files.ixp425 : .Bd -literal ixp425_npe_fw.c optional npe_fw \\ compile-with "${AWK} -f $S/tools/fw_stub.awk \\ diff -u src/share/man/man9/hashinit.9.orig src/share/man/man9/hashinit.9 --- src/share/man/man9/hashinit.9.orig 2012-05-19 03:33:31.000000000 +0900 +++ src/share/man/man9/hashinit.9 2012-05-19 03:33:43.000000000 +0900 @@ -29,7 +29,7 @@ .Dt HASHINIT 9 .Os .Sh NAME -.Nm hashinit , hashinit_flags, hashdestroy , phashinit +.Nm hashinit , hashinit_flags , hashdestroy , phashinit .Nd manage kernel hash tables .Sh SYNOPSIS .In sys/malloc.h diff -u src/share/man/man9/ieee80211_proto.9.orig src/share/man/man9/ieee80211_proto.9 --- src/share/man/man9/ieee80211_proto.9.orig 2012-05-19 03:35:32.000000000 +0900 +++ src/share/man/man9/ieee80211_proto.9 2012-05-19 03:35:52.000000000 +0900 @@ -72,7 +72,7 @@ Default/initial state. A vap in this state should not hold any dynamic state (e.g. entries for associated stations in the node table). -The driver must quiesce the hardware; e.g. there should be no +The driver must quiescence the hardware; e.g. there should be no interrupts firing. .It Dv IEEE80211_S_SCAN Scanning for a BSS or choosing a channel to operate on. @@ -238,4 +238,4 @@ The state machine concept was part of the original .Nm ieee80211 code base that first appeared in -.Nx 1.5 , +.Nx 1.5 . diff -u src/share/man/man9/ieee80211ap.9,v.orig src/share/man/man9/ieee80211ap.9,v --- src/share/man/man9/ieee80211ap.9,v.orig 2012-05-19 03:36:15.000000000 +0900 +++ src/share/man/man9/ieee80211ap.9,v 2012-05-19 03:36:39.000000000 +0900 @@ -111,7 +111,7 @@ Delete requests cause the .Vt ic_vap_delete method to be called. -Drivers must quiesce the device before calling +Drivers must quiescence the device before calling .Fn ieee80211_vap_detach to deactivate the vap and isolate it from activities such as requests from user applications. diff -u src/share/man/man9/ifnet.9.orig src/share/man/man9/ifnet.9 --- src/share/man/man9/ifnet.9.orig 2012-05-19 03:36:52.000000000 +0900 +++ src/share/man/man9/ifnet.9 2012-05-19 03:37:01.000000000 +0900 @@ -637,7 +637,7 @@ .Aq D This interface blocks transmission of packets and discards incoming packets after BPF processing. -Used to monitor network trafic but not interact +Used to monitor network traffic but not interact with the network in question. .It Dv IFF_STATICARP .Aq D diff -u src/share/man/man9/kqueue.9.orig src/share/man/man9/kqueue.9 --- src/share/man/man9/kqueue.9.orig 2012-05-19 03:37:43.000000000 +0900 +++ src/share/man/man9/kqueue.9 2012-05-19 03:38:01.000000000 +0900 @@ -260,8 +260,7 @@ If used, the .Vt knlist must be initialized with either -.Fn knlist_init -, +.Fn knlist_init , .Fn knlist_init_mtx or .Fn knlist_init_rw_reader . diff -u src/share/man/man9/lock.9.orig src/share/man/man9/lock.9 --- src/share/man/man9/lock.9.orig 2012-05-19 03:38:08.000000000 +0900 +++ src/share/man/man9/lock.9 2012-05-19 03:38:17.000000000 +0900 @@ -230,7 +230,7 @@ The .Fn lockmgr_disown function switches the owner from the current thread to be -.Dv LK_KERNPROC, +.Dv LK_KERNPROC , if the lock is already held. .Pp The diff -u src/share/man/man9/locking.9.orig src/share/man/man9/locking.9 --- src/share/man/man9/locking.9.orig 2012-05-19 03:38:25.000000000 +0900 +++ src/share/man/man9/locking.9 2012-05-19 03:39:11.000000000 +0900 @@ -315,8 +315,7 @@ .Fn mtx_sleep , .Fn rw_sleep and -.Fn msleep_spin -). +.Fn msleep_spin ) . .Pp .Em *4 Though one can sleep holding an sx lock, one can also use @@ -358,6 +357,6 @@ functions appeared in .Bsx 4.1 through -.Fx 7.0 +.Fx 7.0 . .Sh BUGS There are too many locking primitives to choose from. diff -u src/share/man/man9/mbuf.9.orig src/share/man/man9/mbuf.9 --- src/share/man/man9/mbuf.9.orig 2012-05-19 03:39:26.000000000 +0900 +++ src/share/man/man9/mbuf.9 2012-05-19 03:39:46.000000000 +0900 @@ -403,7 +403,8 @@ Associate externally managed data with .Fa mbuf . Any internal data contained in the mbuf will be discarded, and the -.Dv M_EXT flag will be set. +.Dv M_EXT +flag will be set. The .Fa buf and @@ -722,7 +723,8 @@ .Fa mbuf , so they are accessible with .Fn mtod mbuf type . -.Fa len must be smaller than, or equal to, the size of an +.Fa len +must be smaller than, or equal to, the size of an .Vt mbuf cluster . Return a pointer to an intermediate .Vt mbuf diff -u src/share/man/man9/mod_cc.9.orig src/share/man/man9/mod_cc.9 --- src/share/man/man9/mod_cc.9.orig 2012-05-19 03:40:00.000000000 +0900 +++ src/share/man/man9/mod_cc.9 2012-05-19 03:40:13.000000000 +0900 @@ -287,7 +287,7 @@ .Va ack_received and is set when the connection's ability to send data is currently constrained by the value of the congestion window. -Algorithms should use the abscence of this flag being set to avoid accumulating +Algorithms should use the absence of this flag being set to avoid accumulating a large difference between the congestion window and send window. .Sh SEE ALSO .Xr cc_chd 4 , diff -u src/share/man/man9/netisr.9.orig src/share/man/man9/netisr.9 --- src/share/man/man9/netisr.9.orig 2012-05-19 03:40:29.000000000 +0900 +++ src/share/man/man9/netisr.9 2012-05-19 03:40:40.000000000 +0900 @@ -78,7 +78,7 @@ .Fn netisr_getqdrops , .Fn netisr_getqlimit , and -.Fn netisr_setqlimit. +.Fn netisr_setqlimit . .Pp .Nm supports multi-processor execution of handlers, and relies on a combination diff -u src/share/man/man9/pci.9.orig src/share/man/man9/pci.9 --- src/share/man/man9/pci.9.orig 2012-05-19 03:40:48.000000000 +0900 +++ src/share/man/man9/pci.9 2012-05-19 03:41:38.000000000 +0900 @@ -488,7 +488,7 @@ .Fn pci_count_msi function returns the maximum number of MSI messages supported by the device -.Fa dev. +.Fa dev . If the device does not support MSI, then .Fn pci_count_msi @@ -567,7 +567,8 @@ returns zero. For MSI-X messages, the resource ID for each -.Dv SYS_RES_IRQ resource identifies the index in the MSI-X table of the +.Dv SYS_RES_IRQ +resource identifies the index in the MSI-X table of the corresponding message. A resource ID of one maps to the first index of the MSI-X table; a resource ID two identifies the second index in the table, etc. @@ -608,7 +609,7 @@ table entries via the .Fn pci_remap_msix function. -Note that this function must be called after a succesful call to +Note that this function must be called after a successful call to .Fn pci_alloc_msix but before any of the .Dv SYS_RES_IRQ @@ -649,7 +650,8 @@ .Fn pci_alloc_msix . MSI-X table entries that with a vector of zero will not have an associated -.Dv SYS_RES_IRQ resource. +.Dv SYS_RES_IRQ +resource. Additionally, if any of the original messages allocated by .Fn pci_alloc_msix diff -u src/share/man/man9/spl.9.orig src/share/man/man9/spl.9 --- src/share/man/man9/spl.9.orig 2012-05-19 03:44:47.000000000 +0900 +++ src/share/man/man9/spl.9 2012-05-19 03:45:01.000000000 +0900 @@ -220,7 +220,8 @@ The historical number scheme can be considered as a simple linearly ordered set of interrupt priority groups. .Pp -.Fx 5.0 eliminated spl entirely in favor of locking primitives which scale +.Fx 5.0 +eliminated spl entirely in favor of locking primitives which scale to more than one processor. .Sh AUTHORS This manual page was written by diff -u src/share/man/man9/sysctl.9.orig src/share/man/man9/sysctl.9 --- src/share/man/man9/sysctl.9.orig 2012-05-19 03:45:09.000000000 +0900 +++ src/share/man/man9/sysctl.9 2012-05-19 03:45:20.000000000 +0900 @@ -107,7 +107,7 @@ This is an opaque data structure. .It Dv CTLTYPE_STRUCT Alias for -.Dv CTLTYPE_OPAQUE. +.Dv CTLTYPE_OPAQUE . .It Dv CTLTYPE_UINT This is an unsigned integer. .It Dv CTLTYPE_LONG diff -u src/share/man/man9/taskqueue.9.orig src/share/man/man9/taskqueue.9 --- src/share/man/man9/taskqueue.9.orig 2012-05-19 03:45:28.000000000 +0900 +++ src/share/man/man9/taskqueue.9 2012-05-19 03:46:26.000000000 +0900 @@ -189,8 +189,8 @@ count is cleared, and the old value returned in the reference parameter .Fa pendp , -if it is non- -.Dv NULL . +if it is +.Pf non- Dv NULL . If the task is currently running, .Dv EBUSY is returned, otherwise 0. diff -u src/share/man/man9/usbdi.9.orig src/share/man/man9/usbdi.9 --- src/share/man/man9/usbdi.9.orig 2012-05-19 03:47:40.000000000 +0900 +++ src/share/man/man9/usbdi.9 2012-05-19 03:48:13.000000000 +0900 @@ -524,7 +524,7 @@ . This flag can be changed during operation. .Pp -"BOF" is short for "Block On Failure" +"BOF" is short for "Block On Failure". .Pp NOTE: This flag should be set on all BULK and INTERRUPT USB transfers which use an endpoint that can be shared between userland and kernel. diff -u src/share/man/man9m_page_aflag.9,v.orig src/share/man/man9m_page_aflag.9,v --- src/share/man/man9m_page_aflag.9,v.orig 2012-05-19 03:48:30.000000000 +0900 +++ src/share/man/man9m_page_aflag.9,v 2012-05-19 03:49:22.000000000 +0900 @@ -27,7 +27,7 @@ .\" $FreeBSD: src/share/man/man9/src/share/man/man9m_page_aflag.9,v,v 1.1 2011/09/06 10:40:21 kib Exp $ .\" .Dd August 31, 2011 -.Dt VM_PAGE_FLAG 9 +.Dt VM_PAGE_AFLAG 9 .Os .Sh NAME .Nm vm_page_aflag_clear , vm_page_aflag_set , vm_page_reference >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri May 18 19:08:23 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4AC8F10657BA; Fri, 18 May 2012 19:08:23 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1EDF98FC12; Fri, 18 May 2012 19:08:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q4IJ8Nt4041653; Fri, 18 May 2012 19:08:23 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q4IJ8MJF041649; Fri, 18 May 2012 19:08:22 GMT (envelope-from gjb) Date: Fri, 18 May 2012 19:08:22 GMT Message-Id: <201205181908.q4IJ8MJF041649@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/168117: groff mandoc style, usage mistakes or typos. (man9) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 18 May 2012 19:08:23 -0000 Synopsis: groff mandoc style, usage mistakes or typos. (man9) Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Fri May 18 19:08:15 UTC 2012 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=168117