Update comments and documentation

Author: BoboTiG

README.rst

@@ -2,7 +2,7 @@
 A cross-platform multi-screen shot module in pure python using ctypes
 **********************************************************************
 
-Very basic, it will grab one screen shot by monitor or a screen shot of all monitors and save it to an optimised/progressive PNG/JPEG file, Python 2.7/3.3 compatible.
+Very basic, it will grab one screen shot by monitor or a screen shot of all monitors and save it to an optimised PNG file, Python 2.7/3.3 compatible.
 
 So, while you can `pip install mss`, you may just drop it in your project and forget about it.
 
@@ -43,7 +43,7 @@ When initalising an instance of MSS, you can enable debug output::
     mss = MSS(debug=True)
 
 
-save(output='mss', oneshot=False, ext='png', ftype=0)
+save(output='mss', oneshot=False)
 -----------------------------------------------------
 
 For each monitor, grab a screen shot and save it to a file.
@@ -52,17 +52,15 @@ Parameters::
 
     output - string - the output filename without extension
     oneshot - boolean - grab only one screen shot of all monitors
-    ext - string - file format to save
-    ftype - int - PNG filter type (0..4 [slower])
 
 This is a generator which returns created files::
 
-    'output-1.ext',
-    'output-2.ext',
+    'output-1.png',
+    'output-2.png',
     ...,
-    'output-NN.ext'
+    'output-NN.png'
     or
-    'output-full.ext'
+    'output-full.png'
 
 
 Example

mss.py

@@ -10,7 +10,6 @@
     Note: please keep this module compatible to Python 2.6.
 
     Still needed:
-    * support for built-in JPEG format
     * support for additional systems
 
     Many thanks to all those who helped (in no particular order):
@@ -29,7 +28,7 @@
 
     You can always get the latest version of this module at:
 
-            https://raw.github.com/BoboTiG/python-mss/mss.py
+            https://raw.github.com/BoboTiG/python-mss/master/mss.py
 
     If that URL should fail, try contacting the author.
 '''
@@ -244,12 +243,12 @@ def save(self, output='mss', oneshot=False):
                     raise ValueError('MSS: no data to process.')
 
                 if hasattr(self, 'save_'):
-                     img_out = self.save_(output=filename)
+                    img_out = self.save_(output=filename)
                 else:
                     img = MSSImage(pixels, monitor[b'width'], monitor[b'height'])
                     img_out = img.dump(filename)
                 self.debug('save', 'img_out', img_out)
-                if img_out is not None:
+                if img_out:
                     yield img_out
             else:
                 yield filename + ' (already exists)'
@@ -342,15 +341,14 @@ def get_pixels(self, monitor):
 
         width, height = monitor[b'width'], monitor[b'height']
         left, top = monitor[b'left'], monitor[b'top']
-
         rect = CGRect((left, top), (width, height))
         self.image = CGWindowListCreateImage(
                     rect, kCGWindowListOptionOnScreenOnly,
                     kCGNullWindowID, kCGWindowImageDefault)
         return 1
 
     def save_(self, output):
-        ''' Special method to not use MSSImage class. Speedy. '''
+        ''' Special method to not use MSSImage class. '''
 
         self.debug('save_')
 
@@ -719,18 +717,17 @@ def __init__(self, data=None, width=1, height=1):
         self.height = int(height)
 
     def dump(self, output=None):
-        ''' Dump data to the image file using file format specified by ext.
+        ''' Dump data to the image file.
             Returns to created file name if success, else None.
         '''
 
         if self.data is None:
             raise ValueError('MSSImage: no data to process.')
 
         contents = self.png()
-        if contents:
-            with open(output, 'wb') as fileh:
-                fileh.write(contents)
-                return output
+        with open(output, 'wb') as fileh:
+            fileh.write(contents)
+            return output
         return None
 
     def png(self):