# HG changeset patch
# User Johannes Bornhold <johannes@rhodecode.com>
# Date 2016-06-06 08:49:40
# Node ID 2f0daef258a629291c083f7f32a4f16d7f3cd6b5
# Parent  8bc9b96137b01edb22666f6ab9d6b53a693bd7fb

authn: Add docstring to function that discovers legacy plugins.

diff --git a/rhodecode/authentication/__init__.py b/rhodecode/authentication/__init__.py
--- a/rhodecode/authentication/__init__.py
+++ b/rhodecode/authentication/__init__.py
@@ -53,6 +53,11 @@ def _discover_plugins(config, entry_poin
 
 
 def _discover_legacy_plugins(config, prefix='py:'):
+    """
+    Function that imports the legacy plugins stored in the 'auth_plugins'
+    setting in database which are using the specified prefix. Normally 'py:' is
+    used for the legacy plugins.
+    """
     auth_plugins = SettingsModel().get_setting_by_name('auth_plugins')
     enabled_plugins = auth_plugins.app_settings_value
     legacy_plugins = [id_ for id_ in enabled_plugins if id_.startswith(prefix)]