diff --git a/docs/src/ngdoc.js b/docs/src/ngdoc.js
index ac6eb5f25de6..4251465b0f38 100644
--- a/docs/src/ngdoc.js
+++ b/docs/src/ngdoc.js
@@ -451,12 +451,16 @@ Doc.prototype = {
     dom.h('Usage', function() {
       dom.h('In HTML Template Binding', function() {
         dom.tag('code', function() {
-          dom.text('{{ ');
-          dom.text(self.shortName);
-          dom.text('_expression | ');
-          dom.text(self.shortName);
-          self.parameters(dom, ':', true);
-          dom.text(' }}');
+          if (self.usage) {
+            dom.text(self.usage);
+          } else {
+            dom.text('{{ ');
+            dom.text(self.shortName);
+            dom.text('_expression | ');
+            dom.text(self.shortName);
+            self.parameters(dom, ':', true);
+            dom.text(' }}');
+          }
         });
       });
 
diff --git a/src/ngSanitize/filter/linky.js b/src/ngSanitize/filter/linky.js
index e5b543976b18..8cdd3c03f915 100644
--- a/src/ngSanitize/filter/linky.js
+++ b/src/ngSanitize/filter/linky.js
@@ -10,6 +10,9 @@
  * @param {string} text Input text.
  * @returns {string} Html-linkified text.
  *
+ * @usage
+   <span ng-bind-html="linky_expression | linky"></span>
+ *
  * @example
    <doc:example module="ngSanitize">
      <doc:source>