add parser-specific docs & rewrite sudo parser for journald

diff --git a/logparse/parsers/sudo.py b/logparse/parsers/sudo.py
index d1c3b81c0d72771963a3a1a806d8705ae5ad903c..8a6dcd3954a0612836611d7ac8074a9d4c4bd7fe 100644 (file)
--- a/logparse/parsers/sudo.py
+++ b/logparse/parsers/sudo.py
@@ -3,6 +3,10 @@
 #   
 #   Get number of sudo sessions for each user
 #
+#   NOTE: This file is now deprecated in favour of the newer journald mechanism
+#   used in sudo-journald.py. This parser is still functional but is slower and
+#   has less features. Please switch over if possible.
+#
 
 import re
 
@@ -17,6 +21,8 @@ class Sudo(Parser):
         super().__init__()
         self.name = "sudo"
         self.info = "Get number of sudo sessions for each user"
+        self.deprecated = True
+        self.successor = "sudo_journald"
 
     def parse_log(self):
         logger.debug("Starting sudo section")