From df77423b3294e28701fd364d3ef6a531ee4f08b1 Mon Sep 17 00:00:00 2001
From: Richard Larkin <fruitbat@ZenMint.(none)>
Date: Wed, 24 Jul 2013 22:49:57 +0200
Subject: [PATCH] doc: revisions to core/video/__init__.py

---
 kivy/core/video/__init__.py | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/kivy/core/video/__init__.py b/kivy/core/video/__init__.py
index 6d69cbc67..650c9fe6f 100644
--- a/kivy/core/video/__init__.py
+++ b/kivy/core/video/__init__.py
@@ -2,7 +2,7 @@
 Video
 =====
 
-Core class for reading video file and manage the
+Core class for reading video files and managing the
 :class:`kivy.graphics.texture.Texture` video.
 
 .. note::
@@ -19,27 +19,31 @@ from kivy.logger import Logger
 
 
 class VideoBase(EventDispatcher):
-    '''VideoBase, a class to implement a video reader.
+    '''VideoBase, a class used to implement a video reader.
 
     :Parameters:
         `filename` : str
             Filename of the video. Can be a file or an URI.
-        `eos` : str, default to 'pause'
-            Action to do when EOS is hit. Can be one of 'pause', 'stop' or
-            'loop'
-            .. versionchanged:: added 'pause'
-        `async` : bool, default to True
-            Asynchronous loading (may be not supported by all providers)
-        `autoplay` : bool, default to False
-            Auto play the video at init
+        `eos` : str, defaults to 'pause'
+            Action to take when EOS is hit. Can be one of 'pause', 'stop' or
+            'loop'.
+
+            .. versionchanged::
+                added 'pause'
+
+        `async` : bool, defaults to True
+            Load the video asynchronously (may be not supported by all
+            providers).
+        `autoplay` : bool, defaults to False
+            Auto play the video on init.
 
     :Events:
         `on_eos`
-            Fired when EOS is hit
+            Fired when EOS is hit.
         `on_load`
-            Fired when the video is loaded, texture is available
+            Fired when the video is loaded and the texture is available.
         `on_frame`
-            Fired when a new frame is written on texture
+            Fired when a new frame is written to the texture.
     '''
 
     __slots__ = ('_wantplay', '_buffer', '_filename', '_texture',
@@ -101,7 +105,7 @@ class VideoBase(EventDispatcher):
 
     filename = property(lambda self: self._get_filename(),
             lambda self, x: self._set_filename(x),
-            doc='Get/set the filename/uri of current video')
+            doc='Get/set the filename/uri of the current video')
 
     def _get_position(self):
         return 0
@@ -170,6 +174,7 @@ class VideoBase(EventDispatcher):
 
     def pause(self):
         '''Pause the video
+
         .. versionadded:: 1.4.0
         '''
         self._state = 'paused'