From 6b0cea73cd48542f0108aa08568b74d0641f9b41 Mon Sep 17 00:00:00 2001
From: Alex Crichton <alex@alexcrichton.com>
Date: Tue, 4 Sep 2018 14:52:56 -0700
Subject: [PATCH] Fix regression of missing documentation

I forgot to add MDN docs for #765 to member operations, but this commit adds
them back!

Closes #786
---
 crates/webidl/src/lib.rs | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/crates/webidl/src/lib.rs b/crates/webidl/src/lib.rs
index aec8d42f..5f0e2fc4 100644
--- a/crates/webidl/src/lib.rs
+++ b/crates/webidl/src/lib.rs
@@ -534,8 +534,29 @@ impl<'src> FirstPassRecord<'src> {
                 import_function_kind(backend::ast::OperationKind::IndexingDeleter)
             }
         };
+        let doc = match id {
+            OperationId::Constructor(_) |
+            OperationId::Operation(None) => None,
+            OperationId::Operation(Some(name)) => {
+                Some(format!(
+                    "The `{}()` method\n\n{}",
+                    name,
+                    mdn_doc(self_name, Some(name))
+                ))
+            }
+            OperationId::IndexingGetter => {
+                Some(format!("The indexing getter\n\n"))
+            }
+            OperationId::IndexingSetter => {
+                Some(format!("The indexing setter\n\n"))
+            }
+            OperationId::IndexingDeleter => {
+                Some(format!("The indexing deleter\n\n"))
+            }
+        };
         let attrs = data.definition_attributes;
-        for method in self.create_imports(attrs, kind, id, op_data) {
+        for mut method in self.create_imports(attrs, kind, id, op_data) {
+            method.doc_comment = doc.clone();
             program.imports.push(wrap_import_function(method));
         }
     }