Move documentation to README, and expand a bit on it.

README.md

@@ -356,6 +356,11 @@ classes may inherit from this one and add to its subscription list
 using the plusignment (`+>`) operator. A real-world example can be
 seen in the `apt::dist_upgrade::initiator` source.
 
+Parameters:
+
+ * timeout: specified in seconds; the maximum time the `dist-upgrade`
+   command should take. If the command takes longer than the timeout,
+   the command is considered to have failed and will be stopped.
 
 ## apt::dist_upgrade::initiator<a name="apt-dist_upgrade-initiator"></a>
 

manifests/dist_upgrade.pp

@@ -1,5 +1,3 @@
-# Parameters:
-# - timeout: specified in seconds
 class apt::dist_upgrade (
   $timeout = 300,
 ) {