ping.rb doc patch

A patch to move the module docs closer to the module, add a comment for
the pingecho method.

Patch against the stable snapshot.
        HTH
        Hugh

--- ./lib/ping.rb.orig	2005-08-01 17:42:48.000000000 +0100
+++ ./lib/ping.rb	2006-08-01 12:49:59.769142000 +0100
@@ -1,6 +1,10 @@
 #
 # ping.rb -- check a host for upness
 #
+
+require 'timeout'
+require "socket"
+
 #= SYNOPSIS
 #
 #   require 'ping'
@@ -35,12 +39,10 @@
 # pingecho() uses user-level thread to implement the timeout, so it may block
 # for long period if named does not respond for some reason.
 #
-#=end
-
-require 'timeout'
-require "socket"
-
 module Ping
+
+  # return true if we can open a connection to +host+
+  # on port +service+ (which defaults to "echo" i.e ping.
   def pingecho(host, timeout=5, service="echo")
     begin
       timeout(timeout) do