Plugin backuppc: convert documentation to perldoc header

plugins/backuppc/backuppc

@@ -1,16 +1,47 @@
-#! /bin/sh
-# Copyright (C) 2013 - LGPL - Steve Schnepp <steve.schnepp@pwkf.org>
-#
-#    [backuppc]
-#    user backuppc
-#    env.pcdir /var/lib/BackupPC/pc
-#    env.full_warning 10    # warn if FULL backup older than N days
-#    env.full_critical 20   # critical if FULL backup older than N days
-#    env.incr_warning 1     # warn if INCR backup older than N days
-#    env.incr_critical 3    # critical if INCR backup older than N days
-#
-#%# family=backuppc
-#%# capabilities=autoconf
+#!/bin/sh
+
+: <<=cut
+
+=head1 NAME
+
+backuppc - monitor the age of backuppc's most recent backup operation
+
+
+=head1 APPLICABLE SYSTEMS
+
+Hosts with a local backuppc respository.
+
+
+=head1 CONFIGURATION
+
+ [backuppc]
+ user backuppc
+ env.pcdir /var/lib/BackupPC/pc
+ env.full_warning 10    # warn if FULL backup older than N days
+ env.full_critical 20   # critical if FULL backup older than N days
+ env.incr_warning 1     # warn if INCR backup older than N days
+ env.incr_critical 3    # critical if INCR backup older than N days
+
+
+=head1 AUTHORS
+
+Copyright (C) 2013 Steve Schnepp <steve.schnepp@pwkf.org>
+
+
+=head1 LICENSE
+
+GNU Library General Public License v2 or later
+
+SPDX-License-Identifier: LGPL-2.0-or-later
+
+
+=head1 MAGIC MARKERS
+
+ #%# family=backuppc
+ #%# capabilities=autoconf
+
+=cut
+
 
 PCDIR=${pcdir:-"/var/lib/BackupPC/pc"}
 HOSTS=$(cd ${PCDIR} 2>/dev/null && ls -1)