Commits

Devin Jeanpierre committed a56199f Draft

Fixed comments

Comments (0)

Files changed (1)

pygame_display.py

     
     def set_mouse_tracking(self):
         """
-        Enable mouse tracking.
+        Enable mouse event forwarding from Pygame to Urwid.
 
         After calling this function, the screen will also grab mouse events
         from the Pygame event list, and provide equivalent events to urwid.
         self._listening_events += MOUSE_EVENTS
 
     def start(self):
-        """
-        Initialize the screen and input mode.
-
-        Ensures that the screen has a surface to draw to.
-        """
-        
         super(BaseSurfaceScreen, self).start()
         assert hasattr(self, 'surface')
 
     
     def stop(self):
-        """
-        Restore the screen.
-        """
-        
         super(BaseSurfaceScreen, self).stop()
 
     
     def run_wrapper(self,fn):
-        """Call fn in fullscreen mode.  Return to normal on exit.
-        
-        This function should be called to wrap your main program loop.
-        Exception tracebacks will be displayed in normal mode.
-        """
-    
         try:
             self.start()
             return fn()
         self.surface = None
 
     def start(self):
-        """Initialize pygame and open a pygame window for drawing to."""
+        """
+        Initialize pygame and open a pygame window, if one wasn't already open.
+        """
         if self.surface is None:
             resolution = compute_resolution(
                 self._resolution,
         super(Screen, self).start()
 
     def stop(self):
-        """Deinitialize pygame and close the window.
-
-        This does not prevent start() from being called again to reopen a
-        window.
-        """
         super(Screen, self).stop()
         # Turns out some programs (like urwid) stop/start the screen a lot.
         # This makes this sort of measure very annoying.