Improve/add module docstrings

python/nav/web/auth/__init__.py

@@ -15,8 +15,6 @@
 #
 """
 Contains web authentication and login functionality for NAV.
-
-The "*Middleware" is Django-specific.
 """
 
 from datetime import datetime

python/nav/web/auth/middleware.py

@@ -13,6 +13,9 @@
 # more details.  You should have received a copy of the GNU General Public
 # License along with NAV. If not, see <http://www.gnu.org/licenses/>.
 #
+"""
+Django middleware for handling login, authentication and authorization for NAV.
+"""
 
 import logging
 import os

python/nav/web/auth/remote_user.py

@@ -13,7 +13,9 @@
 # more details.  You should have received a copy of the GNU General Public
 # License along with NAV. If not, see <http://www.gnu.org/licenses/>.
 #
-
+"""
+Support logging in by having the web server set the REMOTE_USER header.
+"""
 import logging
 from os.path import join
 

python/nav/web/auth/sudo.py

@@ -14,9 +14,7 @@
 # License along with NAV. If not, see <http://www.gnu.org/licenses/>.
 #
 """
-Contains web authentication and login functionality for NAV.
-
-The "*Middleware" is Django-specific.
+Sudo functionality for web authentication in NAV.
 """
 
 import logging

python/nav/web/auth/utils.py

@@ -13,7 +13,10 @@
 # more details.  You should have received a copy of the GNU General Public
 # License along with NAV. If not, see <http://www.gnu.org/licenses/>.
 #
-
+"""
+Utilities for authentication/authorization in NAV that is independent of
+login method.
+"""
 import logging
 
 from django.conf import settings