diff --git a/src/librustdoc/html/markdown.rs b/src/librustdoc/html/markdown.rs
index 3cc95260e3bd..09006d9ef829 100644
--- a/src/librustdoc/html/markdown.rs
+++ b/src/librustdoc/html/markdown.rs
@@ -212,12 +212,6 @@ pub fn render(w: &mut fmt::Formatter,
         ret = ret.trim_right().to_owned();
 
         let id = ret.clone();
-        // Discard '<em>', '<code>' tags and some escaped characters,
-        // transform the contents of the header into a hyphenated string
-        // without non-alphanumeric characters other than '-' and '_'.
-        //
-        // This is a terrible hack working around how hoedown gives us rendered
-        // html for text rather than the raw text.
         let id = id.chars().filter_map(|c| {
             if c.is_alphanumeric() || c == '-' || c == '_' {
                 if c.is_ascii() {