[DOC] Enhanced RDoc for Net::HTTP

[BurdetteLamar]

Treats:

• #post
• #post_form
• ::start
• ::new

Caveats:

• Not sure I have :ENV right.
• I have said nothing about argument +p_no_proxy+, b/c I don't know what to say. The previous doc is less than informative.

I've marked several things as :nodoc:, believing them to be obsolete.

[peterzhu2118]

It looks like p_no_proxy can reject certain proxies. Some examples:

It can reject a certain address:

http = Net::HTTP.new("example.com", nil, 'proxy.example', 8000, 'pname', 'ppass', "proxy.example")
http.proxy_address # => nil

It can reject certain domains or subdomains:

http = Net::HTTP.new("example.com", nil, 'my.proxy.example', 8000, 'pname', 'ppass', "proxy.example")
http.proxy_address # => nil

It can reject certain addresses and port combinations:

http = Net::HTTP.new("example.com", nil, 'proxy.example', 8000, 'pname', 'ppass', "proxy.example:1234")
http.proxy_address # => "proxy.example"
http = Net::HTTP.new("example.com", nil, 'proxy.example', 8000, 'pname', 'ppass', "proxy.example:8000")
http.proxy_address # => nil

It can reject a list of the types above delimited using a comma:

http = Net::HTTP.new("example.com", nil, 'proxy.example', 8000, 'pname', 'ppass', "my.proxy,proxy.example:8000")
http.proxy_address # => nil
http = Net::HTTP.new("example.com", nil, 'my.proxy', 8000, 'pname', 'ppass', "my.proxy,proxy.example:8000")
http.proxy_address # => nil

[BurdetteLamar]

Added text about p_no_proxy.

[BurdetteLamar]

Thanks, @peterzhu2118, for your prompt review. I somehow got the notification email marked as read, and so didn't discover til now.

[peterzhu2118]

Looks good!