geynis
diff --git a/‎can/io/canutils.py‎
Lines changed: 6 additions & 0 deletions b/‎can/io/canutils.py‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎can/io/csv.py‎
Lines changed: 9 additions & 2 deletions b/‎can/io/csv.py‎
Lines changed: 9 additions & 2 deletions
diff --git a/‎can/io/sqlite.py‎
Lines changed: 6 additions & 0 deletions b/‎can/io/sqlite.py‎
Lines changed: 6 additions & 0 deletions
@@ -94,6 +94,12 @@ class CanutilsLogWriter(BaseIOHandler, Listener):
     """
 
     def __init__(self, filename, channel="vcan0", append=False):
+        """
+        :param channel: a default channel to use when the message does not
+                        have a channel set
+        :param bool append: if set to `True` messages are appended to
+                            the file, else the file is truncated
+        """
         mode = 'a' if append else 'w'
         super(CanutilsLogWriter, self).__init__(open_file=True, filename=filename, mode=mode)
 
 
@@ -22,7 +22,7 @@
 
 class CSVWriter(BaseIOHandler, Listener):
     """Writes a comma separated text file with a line for
-    each message.
+    each message. Includes a header line.
 
     The columns are as follows:
 
@@ -42,6 +42,12 @@ class CSVWriter(BaseIOHandler, Listener):
     """
 
     def __init__(self, filename, append=False):
+        """
+        :param bool append: if set to `True` messages are appended to
+                            the file and no header line is written, else
+                            the file is truncated and starts with a newly
+                            written header line
+        """
         mode = 'a' if append else 'w'
         super(CSVWriter, self).__init__(open_file=True, filename=filename, mode=mode)
 
@@ -66,7 +72,8 @@ def on_message_received(self, msg):
 class CSVReader(BaseIOHandler):
     """Iterator over CAN messages from a .csv file that was
     generated by :class:`~can.CSVWriter` or that uses the same
-    format as described there.
+    format as described there. Assumes that there is a header
+    and thus skips the first line.
 
     Any line seperator is accepted.
     """
 
@@ -39,6 +39,9 @@ class SqliteReader(BaseIOHandler):
     """
 
     def __init__(self, filename, table_name="messages"):
+        """
+        :param str table_name: the name of the table to look for the messages
+        """
         super(SqliteReader, self).__init__(open_file=False)
         self.conn = sqlite3.connect(filename)
         self.cursor = self.conn.cursor()
@@ -101,6 +104,9 @@ class SqliteWriter(BaseIOHandler, BufferedReader):
     """Maximum number of seconds to wait between writes to the database"""
 
     def __init__(self, filename, table_name="messages"):
+        """
+        :param str table_name: the name of the table to store messages in
+        """
         super(SqliteWriter, self).__init__(open_file=False)
         self.table_name = table_name
         self.filename = filename