diff --git a/plugins/network/transmission_ratios/tr_ratios b/plugins/network/transmission_ratios/tr_ratios
index ce058a68..1e59ff3f 100755
--- a/plugins/network/transmission_ratios/tr_ratios
+++ b/plugins/network/transmission_ratios/tr_ratios
@@ -1,7 +1,43 @@
 #!/bin/sh
+# -*- sh -*-
 
 user=''
 pass=''
+: <<=cut
+
+=head1 NAME
+
+tr_ratios - monitor transfer ratios of the "transmission" bittorent program
+
+=head1 APPLICABLE SYSTEMS
+
+Any system with "transmission" installed and a transmission daemon running.
+
+=head1 CONFIGURATION
+
+Maybe you need to configure access credentials and connection settings:
+
+  [tr_ratios]
+  env.host localhost
+  env.port 9091
+  env.username alice
+  env.password secret
+
+=head1 MAGIC MARKERS
+
+  #%# family=auto
+  #%# capabilities=autoconf
+
+=head1 AUTHOR
+
+unspecified
+
+=head1 LICENSE
+
+unspecified
+
+=cut
+
 
 if [ "$1" = "config" ]; then
         echo "graph_title Transmission seed ratios"