Fix bug trusteddomainproject#53: Add man page for opendmarc-importsta…

…ts. Requested by

Scott Kitterman.

RELEASE_NOTES

@@ -4,6 +4,8 @@ This listing shows the versions of the OpenDMARC package, the date of
 release, and a summary of the changes in that release.
 
 1.2.0		2014/01/??
+	Fix bug #53: Add man page for opendmarc-importstats.  Requestedj
+		by Scott Kitterman.
 	Fix bug #55: The "SoftwareHeader" setting wasn't being set properly.
 		Problem noted by Birta Levente.
 	Fix bug #60: Default AuthservID to the name provided by the MTA,

configure.ac

@@ -415,6 +415,7 @@ AC_OUTPUT([ Makefile
 		reports/opendmarc-expire.8
 		reports/opendmarc-import
 		reports/opendmarc-import.8
+		reports/opendmarc-importstats.8
 		reports/opendmarc-params
 		reports/opendmarc-params.8
 		reports/opendmarc-reports

reports/Makefile.am

@@ -8,4 +8,4 @@ dist_sbin_SCRIPTS = opendmarc-expire opendmarc-import opendmarc-importstats \
 	opendmarc-params opendmarc-reports
 
 dist_man_MANS = opendmarc-expire.8 opendmarc-import.8 opendmarc-params.8 \
-	opendmarc-reports.8
+	opendmarc-reports.8 opendmarc-importstats.8

reports/opendmarc-importstats.8.in

@@ -0,0 +1,33 @@
+.TH opendmarc-importstats 8 "The Trusted Domain Project"
+.SH NAME
+.B opendmarc-importstats
+\- import OpenDMARC statistics/history data 
+.SH SYNOPSIS
+.B opendmarc-importstats
+.SH DESCRIPTION
+.B opendmarc-importstats
+is a fairly trivial shell script, typically executed by
+.I cron(8),
+that rotates an OpenDMARC statistics/history data file to a unique filename
+and then attempts to import it to a local database for later processing by
+executing
+.I opendmarc-import(8).
+On successful import, the unique file is removed; on failure, the script
+executes
+.I ls(1)
+on the file and exits without removing the unique file.  The intent of this
+last step is to cause
+.I cron
+to generate a message to a responsible party so that the failure will be
+investigated.
+.SH VERSION
+This man page covers the version of
+.I opendmarc-importstats
+that shipped with version @VERSION@ of
+.I OpenDMARC.
+.SH COPYRIGHT
+Copyright (c) 2013, The Trusted Domain Project.  All rights reserved.
+.SH SEE ALSO
+.I cron(8),
+.I opendmarc(8),
+.I opendmarc-import(8)