On Fri, Aug 16, 2013 at 08:34:51PM +0100, Craig R. Skinner wrote:
> The existing grammar is erratic:
>
> $ fgrep filesystem dump.8 | wc -l
> 15
> $ fgrep 'file system' dump.8 | wc -l
> 6
>
erratic, you say?
$ grep -i "filesystem" restore.8 | wc -l
0
$ grep -i "file system" restore.8 | wc -l
13
file system, or filesystem if you prefer, is one of the spellings that
exist in two forms in our docs. within a single document, i guess it's
correct to argue that a spelling should be consistent, but changing
this, in one file, just feels a bit pointless.
$ grep -ir "filesystem" /usr/share/man | wc -l
844
$ grep -ir "file system" /usr/share/man | wc -l
2174
bet there's a rake of other pages that contain both spellings within.
can we agree to live with this quirk?
jmc
>
> Uniformly concatenate both words into one:
>
>
> Index: dump.8
> ===================================================================
> RCS file: /cvs/src/sbin/dump/dump.8,v
> retrieving revision 1.45
> diff -u -r1.45 dump.8
> --- dump.8 4 Apr 2013 10:47:21 -0000 1.45
> +++ dump.8 16 Aug 2013 19:28:41 -0000
> @@ -114,7 +114,7 @@
> .It Fl 0\-9
> Dump levels.
> A level 0, full backup,
> -guarantees the entire file system is copied
> +guarantees the entire filesystem is copied
> (but see also the
> .Fl h
> option below).
> @@ -250,7 +250,7 @@
> is ignored.
> .It Fl W
> .Nm
> -tells the operator what file systems need to be dumped.
> +tells the operator what filesystems need to be dumped.
> This information is gleaned from the files
> .Pa /etc/dumpdates
> and
> @@ -259,10 +259,10 @@
> .Fl W
> flag causes
> .Nm
> -to print out, for each file system in
> +to print out, for each filesystem in
> .Pa /etc/dumpdates ,
> the most recent dump date and level,
> -and highlights those file systems that should be dumped.
> +and highlights those filesystems that should be dumped.
> If the
> .Fl W
> flag is set, all other options are ignored, and
> @@ -365,7 +365,7 @@
> and on a set of fresh tapes that is saved forever.
> .It
> After the level 0 dump,
> -backups of active file systems are taken on each day in a cycle of a week.
> +backups of active filesystems are taken on each day in a cycle of a week.
> Once a week, a level 1 dump is taken.
> The other days of the week a higher level dump is done.
> .Pp
> @@ -413,7 +413,7 @@
> .It Pa /etc/dumpdates
> dump date records
> .It Pa /etc/fstab
> -dump table: file systems and frequency
> +dump table: filesystems and frequency
> .It Pa /etc/group
> to find group
> .Em operator
>
>
> --
> Craig Skinner | http://twitter.com/Craig_Skinner | http://linkd.in/yGqkv7
