Create FormatUrlForSecurityDisplay helper function.

chrome/browser/ui/elide_url.h

Index: chrome/browser/ui/elide_url.h
diff --git a/chrome/browser/ui/elide_url.h b/chrome/browser/ui/elide_url.h
index bd5321a633fbfb5513374903427ca6353be26ada..0d7e831316002069b937273d93ec71c5e20456bc 100644
--- a/chrome/browser/ui/elide_url.h
+++ b/chrome/browser/ui/elide_url.h
@@ -45,4 +45,16 @@ base::string16 ElideHost(const GURL& host_url,
                          const gfx::FontList& font_list,
                          float available_pixel_width);
 
+// This is a convenience function for formatting a URL in a concise and
+// human-friendly way, to help users make security-related decisions (or in
+// other circumstances when people need to distinguish sites, origins, or
+// otherwise-simplified URLs from each other).
+//
+// - Omits the path for standard schemes, excepting file and filesystem.
+// - Omits the port if it is the default for the scheme.
+//
+// Do not use this for URLs which will be parsed or sent to other applications.
+base::string16 FormatUrlForSecurityDisplay(const GURL& origin,

[Ryan Sleevi, 2015/06/03 19:09:04]

Document languages?

(jshin can update it when he tackles crbug.com/336973 )

Something like

// otherwise-simplified URLs from eachother)
//
// The IDN may be presented in Unicode if |languages| accepts the 
// Unicode representation (see net::FormatUrl for more details on
// the algorithm).

[palmer, 2015/06/03 21:24:38]

Done.

+                                           const std::string& languages);
+
 #endif  // CHROME_BROWSER_UI_ELIDE_URL_H_