From: e@... Date: 2014-02-19T01:05:09+00:00 Subject: [ruby-core:60853] [ruby-trunk - Bug #9127] [Assigned] URI::Generic#normalize documentation is vague. Issue #9127 has been updated by Zachary Scott. Status changed from Open to Assigned Assignee set to Zachary Scott Target version set to current: 2.2.0 ---------------------------------------- Bug #9127: URI::Generic#normalize documentation is vague. https://bugs.ruby-lang.org/issues/9127#change-45266 * Author: Robert Gleeson * Status: Assigned * Priority: Low * Assignee: Zachary Scott * Category: doc * Target version: current: 2.2.0 * ruby -v: - * Backport: ---------------------------------------- the documentation for `URI::Generic#normalize` is vague and does not provide enough details about the algorithm that applies normalization. the documentation says, "Returns normalized URI" and nothing more. I would have expected a short piece that explains how normalization is applied. pry session attached (ruby = v2.0.0) $ pry [1] pry(main)> require "uri" => true [2] pry(main)> uri = URI.parse("http://www.ruby-lang.org") => # [3] pry(main)> ? uri.normalize From: /Users/robert/.rubies/ruby-2.0.0-p247/lib/ruby/2.0.0/uri/generic.rb @ line 1418: Owner: URI::Generic Visibility: public Signature: normalize() Number of lines: 2 Returns normalized URI -- http://bugs.ruby-lang.org/