From dfc08933163f1e36ba0bad0390bcc2a1a4636bd3 Mon Sep 17 00:00:00 2001
From: John Reilly <johnny_reilly@hotmail.com>
Date: Fri, 29 May 2015 13:24:40 +0100
Subject: [PATCH] Update angular.d.ts - JSDoc-ed $filter

---
 angularjs/angular.d.ts | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/angularjs/angular.d.ts b/angularjs/angular.d.ts
index 92784af38c..1b12c20268 100755
--- a/angularjs/angular.d.ts
+++ b/angularjs/angular.d.ts
@@ -736,17 +736,37 @@ declare module angular {
         eventFn(element: Node, doneFn: () => void): Function;
     }
 
-    ///////////////////////////////////////////////////////////////////////////
-    // FilterService
-    // see http://docs.angularjs.org/api/ng.$filter
-    // see http://docs.angularjs.org/api/ng.$filterProvider
-    ///////////////////////////////////////////////////////////////////////////
+    /**
+     * $filter - $filterProvider - service in module ng
+     * 
+     * Filters are used for formatting data displayed to the user.
+     * 
+     * see https://docs.angularjs.org/api/ng/service/$filter
+     */
     interface IFilterService {
+        /**
+         * Usage:
+         * $filter(name);
+         * 
+         * @param name Name of the filter function to retrieve
+         */
         (name: string): Function;
     }
 
+    /**
+     * $filterProvider - $filter - provider in module ng
+     * 
+     * Filters are just functions which transform input to an output. However filters need to be Dependency Injected. To achieve this a filter definition consists of a factory function which is annotated with dependencies and is responsible for creating a filter function.
+     * 
+     * see https://docs.angularjs.org/api/ng/provider/$filterProvider
+     */
     interface IFilterProvider extends IServiceProvider {
-        register(name: string, filterFactory: Function): IServiceProvider;
+        /**
+         * register(name);
+         * 
+         * @param name Name of the filter function, or an object map of filters where the keys are the filter names and the values are the filter factories. Note: Filter names must be valid angular Expressions identifiers, such as uppercase or orderBy. Names with special characters, such as hyphens and dots, are not allowed. If you wish to namespace your filters, then you can use capitalization (myappSubsectionFilterx) or underscores (myapp_subsection_filterx).
+         */
+        register(name: string | {}): IServiceProvider;
     }
 
     ///////////////////////////////////////////////////////////////////////////