* try to find out module that calls I2nLogger constructor to provide a good
   default value for name (finding out the current module is a pain in the a..)
 
-..todo:: create unittests from test_* functions at bottom
-..todo:: think about how to allow different levels per handler
-..todo:: do not limit logs by line numbers but by disc size? Warn when at 50%,
+.. todo:: create unittests from test_* functions at bottom
+.. todo:: think about how to allow different levels per handler
+.. todo:: do not limit logs by line numbers but by disc size? Warn when at 50%,
          75%, 90%, 99% of limit?
 
 .. codeauthor:: Intra2net
 
 Runs stat in a loop to find out whether file size has changed. Then reads the
 new data and forwards that
 
-..todo:: Want to also use lsof to find out whether file/pipe/socket was closed,
+.. todo:: Want to also use lsof to find out whether file/pipe/socket was closed,
          so can return from read loop
 
 :py:class:`LineReader` takes output of :py:class:`IterativeReader` and returns
 :py:class:`LogParser` takes those lines and tries to parse them into fields
 like date, time, module name, urgency and message.
 
-..todo:: auto-detect log line layout
+.. todo:: auto-detect log line layout
 
 .. codeauthor:: Intra2net
 """
 
 This is a little more involved since in order to test properly, need a second
 thread that writes to file/socket/stdout
 
-..todo:: as in log_read_unittest: disable buffering in LogFileWriter
+.. todo:: as in log_read_unittest: disable buffering in LogFileWriter
 
-DEPRECATED
-(at least for files see log_read; may still be usefull for pipes/sockets)
+.. warn:: DEPRECATED (at least for files see log_read; may still be useful for
+          pipes/sockets)
 
 .. codeauthor:: Intra2net
 """