Add initial logging rework deprecation warnings to docs. #168

Author: amykyta3

docs/api/messages.rst

@@ -44,6 +44,12 @@ Exceptions
 
 Message Handling
 ----------------
+
+.. warning::
+
+    The ``MessagePrinter`` and ``MessageHandler`` classes will be deprecated in
+    a future release. See the following page for details: https://github.com/SystemRDL/systemrdl-compiler/issues/168
+
 .. autoclass:: systemrdl.messages.MessagePrinter
     :members:
 

systemrdl/compiler.py

@@ -104,6 +104,10 @@ def __init__(self, **kwargs: Any):
             raise TypeError("got an unexpected keyword argument '%s'" % list(kwargs.keys())[0])
 
         #: Reference to the compiler's :class:`~systemrdl.messages.MessageHandler` object
+        #:
+        #: .. warning::
+        #:
+        #:      This will be deprecated in a future release. See this page for more details: https://github.com/SystemRDL/systemrdl-compiler/issues/168
         self.msg = self.env.msg
 
         self.namespace = NamespaceRegistry(self.env) # type: NamespaceRegistry

systemrdl/importer.py

@@ -25,6 +25,10 @@ def __init__(self, compiler: RDLCompiler):
         self.compiler = compiler
 
         #: Reference to the compiler message handler
+        #:
+        #: .. warning::
+        #:
+        #:      This will be deprecated in a future release. See this page for more details: https://github.com/SystemRDL/systemrdl-compiler/issues/168
         self.msg = compiler.env.msg
 
         #: Source reference used by default when not specified in importer