More code docs

Author: tony

tmuxp/server.py

@@ -365,7 +365,6 @@ def attach_session(self, target_session=None):
         :param: target_session: str. name of the session. fnmatch(3) works.
 
         """
-        # tmux('switch-client', '-t', target_session)
         tmux_args = tuple()
         if target_session:
             tmux_args += ('-t%s' % target_session,)

tmuxp/window.py

@@ -382,6 +382,11 @@ def _list_panes(self):
 
     @property
     def _panes(self):
+        """Return list of the windows' panes as :py:obj:`dict`.
+
+        :rtype: list
+
+        """
         return self._list_panes()
 
     def list_panes(self):
@@ -395,5 +400,7 @@ def list_panes(self):
 
     @property
     def panes(self):
+        """Return a :py:obj:`list` of the windows' :class:`Pane` objects."""
         return self.list_panes()
+    #: Alias of :attr:`panes`.
     children = panes