@@ -89,7 +89,7 @@ class DocCLI(CLI):

             try:

                 # if the module lives in a non-python file (eg, win_X.ps1), require the corresponding python file for docs

-                filename = module_loader.find_plugin(module, mod_type='.py')

+                filename = module_loader.find_plugin(module, mod_type='.py', ignore_deprecated=True)

                 if filename is None:

                     display.warning("module %s not found in %s\n" % (module, DocCLI.print_paths(module_loader)))

                     continue

@@ -174,7 +174,7 @@ class DocCLI(CLI):

                 continue

             # if the module lives in a non-python file (eg, win_X.ps1), require the corresponding python file for docs

-            filename = module_loader.find_plugin(module, mod_type='.py')

+            filename = module_loader.find_plugin(module, mod_type='.py', ignore_deprecated=True)

             if filename is None:

                 continue

@@ -221,7 +221,7 @@ class PluginLoader:

                 self._extra_dirs.append(directory)

                 self._paths = None

-    def find_plugin(self, name, mod_type=''):

+    def find_plugin(self, name, mod_type='', ignore_deprecated=False):

         ''' Find a plugin named name '''

         if mod_type:

@@ -297,7 +297,7 @@ class PluginLoader:

             alias_name = '_' + name

             # We've already cached all the paths at this point

             if alias_name in pull_cache:

-                if not os.path.islink(pull_cache[alias_name]):

+                if not ignore_deprecated and not os.path.islink(pull_cache[alias_name]):

                     display.deprecated('%s is kept for backwards compatibility '

                               'but usage is discouraged. The module '

                               'documentation details page may explain '