Some doc corrections

Author: dschreij

docs/source/index.rst

@@ -6,17 +6,24 @@
 Media decoder documentation
 ===========================
 
-This library allows you to decode and render movies in Python. It is based on 
-the (rather excellent) MoviePy_ module created by Zulko, which offers a convenient 
-Python interface to ffmpeg. This library should hence be able to render any media 
-format that ffmpeg supports. If ffmpeg is not found, moviepy will download it for 
-you on first usage, which may take some time 
+This library allows you to decode and render video files (and in the future also
+audio files) in Python. It provides an internal clock that determines which 
+(video and/or audio) frame needs to be displayed at a specified time, and this frame 
+can then (optionally) be passed on to a callback function that takes care of the 
+actual rendering of the frame. In short, this library should help you get started 
+when you want to implement your own video player and want to have full control over
+the way audio and video is rendered.
+
+It is based on the (rather excellent) MoviePy_ module created by Zulko, which offers
+a convenient Python interface to ffmpeg. This library should hence be able to 
+render any media format that ffmpeg supports. If ffmpeg is not found, moviepy 
+will download it for you on first usage, which may take some time 
 (so keep an eye on that terminal/command prompt to track the download progress).
 
 This library's main purpose is to decode video and/or audio files and supply the 
 user with video and audio frames depending on the playtime of the media stream. 
 The user thus has to take care of the rendering of these frames himself (although 
-modules for sound rendering are included in the package. 
+modules for sound rendering are included in the package). 
 The ``play.py`` contains an example of how to play a video using OpenGL+pygame for 
 the video rendering and pyaudio for audio playback (using pygame.mixer is also an 
 option, but that doesn't work smoothly yet). You can play a video by calling 

mediadecoder/decoder.py

@@ -213,8 +213,8 @@ def set_audiorenderer(self, renderer):
 
 		Parameters
 		----------
-		renderer : sound_renderers.SoundRenderer
-			A subclass of sound_renderers.SoundRenderer that takes care of the
+		renderer : soundrenderers.SoundRenderer
+			A subclass of soundrenderers.SoundRenderer that takes care of the
 			audio rendering.
 
 		Raises

mediadecoder/timer.py

@@ -11,10 +11,10 @@
 from moviepy.tools import cvsecs
 
 class Timer(object):
-	""" Timer serves as a video clock that can be used which frame needs to be
-	displayed at an arbitrary moment in time. It runs in a separate thread. 
+	""" Timer serves as a video clock that is used to determine which frame needs to be
+	displayed at the specified time. It runs in a separate thread. 
 	Time can be polled by checking its property clock.time, and the current frame
-	can be determined using clock.current_frame. """
+	can be determined by checking clock.current_frame. """
 
 	def __init__(self, fps=None, max_duration=None):
 		""" Constructor.