update readme

Author: yomguy

README.rst

@@ -100,53 +100,65 @@ First, list all available plugins:
 
 .. doctest::
 
->>> import timeside.core
->>> timeside.core.list_processors()
+   >>> import timeside.core
+   >>> timeside.core.list_processors()  # doctest: +ELLIPSIS
+   IProcessor
+   ==========
+   ...
 
 Define some processors:
 
 .. doctest::
 
->>> from timeside.core import get_processor
->>> from timeside.core.tools.test_samples import samples
->>> wavfile = samples['sweep.wav']
->>> decoder  =  get_processor('file_decoder')(wavfile)
->>> grapher  =  get_processor('waveform_simple')()
->>> analyzer =  get_processor('level')()
->>> encoder  =  get_processor('vorbis_encoder')('sweep.ogg')
+   >>> from timeside.core import get_processor
+   >>> from timeside.core.tools.test_samples import samples
+   >>> wavfile = samples['sweep.wav']
+   >>> decoder  =  get_processor('file_decoder')(wavfile)
+   >>> grapher  =  get_processor('waveform_simple')()
+   >>> analyzer =  get_processor('level')()
+   >>> encoder  =  get_processor('vorbis_encoder')('sweep.ogg')
+
 
 Then run the *magic* pipeline:
 
 .. doctest::
 
->>> (decoder | grapher | analyzer | encoder).run()
+   >>> (decoder | grapher | analyzer | encoder).run()
 
 Render the grapher results:
 
 .. doctest::
 
->>> grapher.render(output='waveform.png')
+   >>> grapher.render(output='waveform.png')
+
+.. testcleanup::
+
+   import os
+   os.remove('waveform.png')
+   os.remove('sweep.ogg')
+
 
 Show the analyzer results:
 
 .. doctest::
 
->>> print 'Level:', analyzer.results  # doctest: +ELLIPSIS
-    Level: {'level.max': AnalyzerResult(...)}
+   >>> print 'Level:', analyzer.results  # doctest: +ELLIPSIS
+   Level: {'level.max': AnalyzerResult(...), 'level.rms': AnalyzerResult(...)}
 
 
 So, in only one pass, the audio file has been decoded, analyzed, graphed and transcoded.
 
 For more extensive examples, please see the `full documentation <http://files.parisson.com/timeside/doc/>`_.
 
-API / Documentation
-====================
+Documentation
+==============
 
-* General : http://files.parisson.com/timeside/doc/
+* General documentation : http://files.parisson.com/timeside/doc/
 * Tutorials : http://files.parisson.com/timeside/doc/tutorials/index.html
-* Notebooks : http://nbviewer.ipython.org/github/thomasfillon/Timeside-demos/tree/master/
+* API : http://files.parisson.com/timeside/doc/api/index.html
 * Publications : https://github.com/Parisson/Telemeta-doc
-* Player / UI (old wiki) : https://github.com/Parisson/TimeSide/wiki/Ui-Guide
+* Some online notebooks : http://app.mybinder.org/1921720142/tree
+* Player / UI wiki : https://github.com/Parisson/TimeSide/wiki/Ui-Guide
 * A player example : http://archives.crem-cnrs.fr/archives/items/CNRSMH_E_2004_017_001_01/
 
 Install
@@ -200,12 +212,12 @@ License
 
 TimeSide is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as published by
-the Free Software Foundation, either version 2 of the License, or
+the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 
 TimeSide is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Affero General Public License for more details.
 
-See LICENSE for more details.
+Read the LICENSE.txt file for more details.