* lib/uri.rb: Documented (thanks Dmitry V. Sabanin).

* lib/uri/common.rb: Ditto.
 * lib/uri/ftp.rb: Ditto.
 * lib/uri/generic.rb: Ditto.
 * lib/uri/http.rb: Ditto.
 * lib/uri/https.rb: Ditto.
 * lib/uri/ldap.rb: Ditto.
 * lib/uri/mailto.rb: Ditto.


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@6015 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

lib/uri/http.rb

@@ -1,25 +1,18 @@
 #
-# $Id$
+# = uri/http.rb
 #
-# Copyright (c) 2001 akira yamada <akira@ruby-lang.org>
-# You can redistribute it and/or modify it under the same term as Ruby.
+# Author:: Akira Yamada <akira@ruby-lang.org>
+# License:: You can redistribute it and/or modify it under the same term as Ruby.
+# Revision:: $Id$
 #
 
 require 'uri/generic'
 
 module URI
 
-=begin
-
-== URI::HTTP
-
-=== Super Class
-
-((<URI::Generic>))
-
-=end
-
+  #
   # RFC1738 section 3.3.
+  #
   class HTTP < Generic
     DEFAULT_PORT = 80
 
@@ -31,46 +24,42 @@ module URI
       :fragment
     ].freeze
 
-=begin
-
-=== Class Methods
-
---- URI::HTTP::build
-    Create a new URI::HTTP object from components of URI::HTTP with
-    check.  It is scheme, userinfo, host, port, path, query and
-    fragment. It provided by an Array of a Hash.
-
---- URI::HTTP::new
-    Create a new URI::HTTP object from ``generic'' components with no
-    check.
-
-=end
-
+    #
+    # == Description
+    #
+    # Create a new URI::HTTP object from components of URI::HTTP with
+    # check.  It is scheme, userinfo, host, port, path, query and
+    # fragment. It provided by an Array of a Hash.
+    #
     def self.build(args)
       tmp = Util::make_components_hash(self, args)
       return super(tmp)
     end
 
+    #
+    # == Description
+    #
+    # Create a new URI::HTTP object from ``generic'' components with no
+    # check.
+    #
     def initialize(*arg)
       super(*arg)
     end
 
-=begin
-
-=== Instance Methods
-
---- URI::HTTP#request_uri
-
-=end
+    #
+    # == Description
+    #
+    # Returns: path + '?' + query
+    #
     def request_uri
       r = path_query
       if r[0] != ?/
-	r = '/' + r
+        r = '/' + r
       end
 
       r
     end
-  end # HTTP
+  end
 
   @@schemes['HTTP'] = HTTP
-end # URI
+end