[src/trunk]: src/share/man/man7 Harmfully sentence fragments. Use sentences i...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cd5e78247fb3
branches:  trunk
changeset: 817293:cd5e78247fb3
user:      dholland <dholland%NetBSD.org@localhost>
date:      Tue Aug 16 00:08:17 2016 +0000

description:
Harmfully sentence fragments. Use sentences instead.

I've also made some additional minor edits, and added missing
/usr/src/sys/ufs/{chfs,ext2fs}.

diffstat:

 share/man/man7/hier.7 |  1021 ++++++++++++++++++++++++------------------------
 1 files changed, 519 insertions(+), 502 deletions(-)

diffs (truncated from 1661 to 300 lines):

diff -r ed5c3cd49f2c -r cd5e78247fb3 share/man/man7/hier.7
--- a/share/man/man7/hier.7     Mon Aug 15 22:01:44 2016 +0000
+++ b/share/man/man7/hier.7     Tue Aug 16 00:08:17 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hier.7,v 1.112 2016/08/15 21:42:05 maya Exp $
+.\"    $NetBSD: hier.7,v 1.113 2016/08/16 00:08:17 dholland Exp $
 .\"
 .\" Copyright (c) 1990, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -50,596 +50,601 @@
 .Pp
 .Bl -tag -width "/altroot/"
 .It Sy \&/
-root directory of the system
+Root directory of the system.
 .It Sy /COPYRIGHT
-system copyright notice, most often put on
+System copyright notice, most often put on
 .Tn CD-ROM
 distributions.
 .It Sy "/[a-z]/"
-user filesystems
+User filesystems.
 .It Sy /altroot/
-alternate root filesystem, in case of disaster
+Alternate root filesystem, in case of disaster.
 .\" .It Sy /amd/
-.\" home directories mount point; see
-.\" .Xr amd 8
+.\" Home directories mount point; see
+.\" .Xr amd 8 .
 .It Sy /bin/
-utilities used in both single and multi-user environments
+Utilities used in both single and multi-user environments.
 .It Sy /boot*
-second-stage boot loader(s) for some platforms; see
-.Xr installboot 8
+Second-stage boot loader(s) for some platforms; see
+.Xr installboot 8 .
 .It Sy /cdrom/
-empty directory commonly used by
-system administrators as a temporary mount point for CD devices
-for ISO-9660 file systems
+Empty directory commonly used by
+system administrators as a temporary mount point for ISO-9660 file
+systems on CD (or DVD) media.
 .It Sy /dev/
-block, character and other special device files
+Block, character, and other special device files.
 .Pp
 .Bl -tag -width "MAKEDEV" -compact
 .It Sy MAKEDEV
-script for creating device files;
+Script for creating device files;
 see
-.Xr makedev 8
+.Xr makedev 8 .
 .It Sy console
-the computer's console device
+The computer's console device.
 .It Sy drum
-system swap space; see
-.Xr drum 4
+The computer's swap space device; see
+.Xr drum 4 .
 .It Sy fd/
-file descriptor files;
+File descriptor files;
 see
-.Xr fd 4
+.Xr fd 4 .
 .It Sy klog
-kernel logging device; see
-.Xr syslog 3
+Kernel logging device; see
+.Xr syslog 3 .
 .It Sy kmem
-kernel virtual memory device; see
-.Xr mem 4
+Kernel virtual memory device; see
+.Xr mem 4 .
 .It Sy log
 .Ux
 domain datagram log socket; see
-.Xr syslogd 8
+.Xr syslogd 8 .
 .It Sy mem
-kernel physical memory device; see
-.Xr mem 4
+Kernel physical memory device; see
+.Xr mem 4 .
 .It Sy null
-the null device; see
-.Xr null 4
+The null device; see
+.Xr null 4 .
 .It Sy pts/
-mount point for the pseudo-terminal device file system; see
-.Xr mount_ptyfs 8
+Mount point for the pseudo-terminal device file system; see
+.Xr mount_ptyfs 8 .
 .It Sy stderr
 .It Sy stdin
 .It Sy stdout
-file descriptor files;
+File descriptor files;
 see
-.Xr fd 4
+.Xr fd 4 .
 .It Sy tty
-process' controlling terminal device; see
-.Xr tty 4
+Device pointing to each process's own controlling terminal; see
+.Xr tty 4 .
 .It Sy zero
-the zero device; see
-.Xr zero 4
+The zero device; see
+.Xr zero 4 .
 .El
 .\" .It Sy /dump/
-.\" online
+.\" Online
 .\" .Xr dump 8
-.\" repository
+.\" repository.
 .It Sy /etc/
-system configuration files and scripts
+System configuration files and scripts.
 .Pp
 .Bl -tag -width "master.passwd" -compact
 .It Sy amd*
-configuration files for
-.Xr amd 8
+Configuration files for
+.Xr amd 8 .
 .It Sy changelist
-files backed up by the security script
+Files backed up by the
+.Sy security
+script.
 .It Sy crontab
-schedule used by the
+Schedule used by the
 .Xr cron 8
-daemon
+daemon.
 .It Sy csh.cshrc
 .It Sy csh.login
 .It Sy csh.logout
-system-wide scripts for
-.Xr csh 1
+System-wide scripts for
+.Xr csh 1 .
 .It Sy daily
-script run each day by
-.Xr cron 8
+Script run each day by
+.Xr cron 8 .
 .It Sy daily.conf
-configuration file for
+Configuration file for
 .Sy daily ;
 see
-.Xr daily.conf 5
+.Xr daily.conf 5 .
 .It Sy defaults/
-default configuration files read by various
+Default configuration files read by various
 .Pa /etc/*.conf
-files
+files.
 .It Sy disktab
-disk description file, see
-.Xr disktab 5
+Disk description file; see
+.Xr disktab 5 .
 .It Sy dm.conf
-dungeon master configuration; see
-.Xr dm.conf 5
+Dungeon master configuration; see
+.Xr dm.conf 5 .
 .It Sy dumpdates
-dump history; see
-.Xr dump 8
+Dump history; see
+.Xr dump 8 .
 .It Sy exports
-filesystem export information; see
-.Xr mountd 8
+Filesystem export information; see
+.Xr mountd 8 .
 .It Sy fstab
-filesystem information; see
+File system mounting table; see
 .Xr fstab 5
 and
-.Xr mount 8
+.Xr mount 8 .
 .It Sy ftpusers
-users denied
+Users denied
 .Xr ftp 1
 access; see
-.Xr ftpd 8
+.Xr ftpd 8 .
 .It Sy ftpwelcome
 .Xr ftp 1
 initial message; see
-.Xr ftpd 8
+.Xr ftpd 8 .
 .It Sy gettytab
-terminal configuration database; see
-.Xr gettytab 5
+Terminal configuration database; see
+.Xr gettytab 5 .
 .It Sy group
-group permissions file; see
-.Xr group 5
+Group permissions file; see
+.Xr group 5 .
 .It Sy hosts
-host name database backup for
+Host name database backup for
 .Xr named 8 ;
 see
-.Xr hosts 5
+.Xr hosts 5 .
 .It Sy hosts.equiv
-trusted machines with equivalent user ID's
+Trusted machines with equivalent user IDs.
+(Obsolete.)
 .It Sy hosts.lpd
-trusted machines with printing privileges
+Trusted machines with printing privileges.
 .It Sy inetd.conf
 Internet server configuration file; see
-.Xr inetd 8
+.Xr inetd 8 .
 .It Sy kerberosV/
-configuration files for the kerberos version V;
+Configuration files for Kerberos version V;
 see
-.Xr kerberos 8
+.Xr kerberos 8 .
 .It Sy localtime
-local timezone information;
+Local time zone;
 see
-.Xr ctime 3
+.Xr ctime 3 .
 .It Sy mail/
-configuration files for
-.Xr sendmail 1
+Configuration files for
+.Xr sendmail 1 .
 .Pp
 .Bl -tag -width "sendmail.*" -compact
 .It Sy aliases*
-name alias files
+Username alias files.
 .It Sy sendmail.*
 .Xr sendmail 1
-configuration information
+configuration information.
 .El
 .It Sy mail.rc
-system-wide initialization script for
-.Xr mail 1
+System-wide initialization script for
+.Xr mail 1 .
 .It Sy man.conf
-configuration file for
+Configuration file for
 .Xr man 1 ;
 see
-.Xr man.conf 5
+.Xr man.conf 5 .
 .It Sy master.passwd
 Main password file, readable only by root; see
-.Xr passwd 5
+.Xr passwd 5 .
 .It Sy mk.conf
-optional file containing
+Optional file containing
 .Xr make 1
-variables, read by pkgsrc and the system sources.
+variables, used to configure pkgsrc and the system sources.
 .It Sy monthly
-script run each month by
-.Xr cron 8
+Script run each month by
+.Xr cron 8 .
 .It Sy monthly.conf
-configuration file for
+Configuration file for
 .Sy monthly ;
 see
-.Xr monthly.conf 5
+.Xr monthly.conf 5 .