diff --git a/plugins/rabbitmq/rabbitmq_connections b/plugins/rabbitmq/rabbitmq_connections
index 2e6970b9..9b943b93 100755
--- a/plugins/rabbitmq/rabbitmq_connections
+++ b/plugins/rabbitmq/rabbitmq_connections
@@ -1,19 +1,46 @@
 #!/bin/sh
-# 
-# Plugin to monitor the number of connections to RabbitMQ
-#
-# Usage: Link or copy into /etc/munin/node.d/
-#
-# Parameters
-#     env.conn_warn <warning connections>
-#     env.conn_crit <critical connections>
-#
-# Magic markers (optional - only used by munin-config and some
-# installation scripts):
-#
-#%# family=auto
 
-HOME=/tmp/
+: << =cut
+
+=head1 NAME
+
+rabbitmq_connections - monitor the number of connections to RabbitMQ
+
+=head1 CONFIGURATION
+
+You will need to add configuration to
+/etc/munin/plugin-conf.d/rabbitmq_connection.conf for this plugin to
+work.
+
+=over 2
+
+=item C<user>
+
+Required. Valid choices are C<rabbitmq> and C<root>. This is required
+by C<rabbitmqctl>.
+
+=item C<env.conn_warn>
+
+Optional, default value is 500
+
+=item C<env.conn_crit>
+
+Optional, default value is 1000
+
+=back
+
+=head2 EXAMPLE CONFIGURATION
+
+  [rabbitmq_connections]
+    user rabbitmq
+    env.conn_warn 512
+    env.conn_crit 1024
+
+=head1 MAGIC MARKERS
+
+  #%# family=contrib
+
+=cut
 
 # If run with the "config"-parameter, give out information on how the
 # graphs should look.