--- trunk/pam-config/console.handlers	2012/10/12 13:04:00	1955
+++ trunk/pam-config/console.handlers	2012/10/20 12:46:50	1956
@@ -1,3 +1,17 @@
-# Begin /etc/security/console.handlers
-console consoledevs tty[0-9][0-9]* vc/[0-9][0-9]* :[0-9]\.[0-9] :[0-9]
+# /etc/security/console.handlers
+#
+# This file is provided for configuration of handlers which will be
+# executed when user obtains console lock and when he loses it.
+# Additionally it is used for a configuration of console device names.
+#
+# Format:
+# name consoledevs regex regex ...
+# binary lock|unlock flag flag ...
+# See man console.handlers
+#
+# Example:
+# console consoledevs tty[0-9][0-9]* vc/[0-9][0-9]* :[0-9]\.[0-9] :[0-9]
+# echo lock wait Locking console for user on tty
+# touch unlock wait /var/run/console-unlocked
 
+console consoledevs tty[0-9][0-9]* vc/[0-9][0-9]* :[0-9]+\.[0-9]+ :[0-9]+