[src/trunk]: src/share/man/man4 Document the keep-filename entry in the dicti...

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

details:   https://anonhg.NetBSD.org/src/rev/a7104456a3bf
branches:  trunk
changeset: 826362:a7104456a3bf
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Tue Aug 29 23:38:50 2017 +0000

description:
Document the keep-filename entry in the dictionary passed to VERIEXEC_LOAD.

Clean up English grammar in description of VERIEXEC_DUMP (relating to the
retention of filenames).

XXX There are several tables in this man page with column headers defined
XXX using .It Sy Col1 Col2 Col3   This causes the first header to appear
XXX as "Bold" but the remaining column headers are "Normal".  I don't know
XXX how to fix it to make all the headers "Bold".  :(

diffstat:

 share/man/man4/veriexec.4 |  9 +++++----
 1 files changed, 5 insertions(+), 4 deletions(-)

diffs (42 lines):

diff -r 8f76fa1fc1a4 -r a7104456a3bf share/man/man4/veriexec.4
--- a/share/man/man4/veriexec.4 Tue Aug 29 22:57:05 2017 +0000
+++ b/share/man/man4/veriexec.4 Tue Aug 29 23:38:50 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: veriexec.4,v 1.23 2014/03/18 18:20:39 riastradh Exp $
+.\" $NetBSD: veriexec.4,v 1.24 2017/08/29 23:38:50 pgoyette Exp $
 .\"
 .\" Copyright 2005 Elad Efrat <elad%bsd.org.il@localhost>
 .\" Copyright 2005 Brett Lymn <blymn%netbsd.org@localhost>
@@ -26,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 19, 2011
+.Dd August 30, 2017
 .Dt VERIEXEC 4
 .Os
 .Sh NAME
@@ -59,12 +59,13 @@
 .Em Veriexec .
 .Pp
 The dictionary passed contains the following elements:
-.Bl -column entryxtype string
+.Bl -column keepxfilename string
 .It Sy Name    Type    Purpose
 .It file       string  filename for this entry
 .It entry-type uint8   entry type ( see below )
 .It fp-type    string  fingerprint hashing algorithm
 .It fp data    the fingerprint
+.It keep-filename      bool    whether or not to retain the entry's filename
 .El
 .Pp
 .Dq entry-type
@@ -90,7 +91,7 @@
 .Em Veriexec
 monitored files database from the kernel.
 .Pp
-Only files that the filename is kept for them will be dumped.
+Only files for which the filename was kept will be dumped.
 The returned array contains dictionaries with the following elements:
 .Bl -column entryxtype string
 .It Sy Name    Type    Purpose