cleanup descriptions

diff --git a/analyze/api.py b/analyze/api.py
index 6584d3182b7d04718185c72fe7aa2505677e0759..b02bf4be03c43ac146060ecb2d22623061b8c3e1 100644 (file)
--- a/analyze/api.py
+++ b/analyze/api.py
@@ -26,9 +26,9 @@ class IAnalyzer(Interface):
 
     def id():
         """Return a short id alphanumeric, lower-case string."""
-
+s
     def name():
-        """Return the analyze name, such as "Mean Level", "Max level",
+        """Return the analyzer name, such as "Mean Level", "Max level",
         "Total length, etc..
         """
 

diff --git a/encode/api.py b/encode/api.py
index 7f77f7500e5bab7285d0f010d90f8f15cfaa07d3..4e45324c9925eefd0de455f4d40b0f7e19916d6e 100644 (file)
--- a/encode/api.py
+++ b/encode/api.py
@@ -46,6 +46,14 @@ class IEncoder(Interface):
     def mime_type():
         """Return the mime type corresponding to this encode format"""
 
+    def set_cache_dir(path):
+        """Set the directory where cached files should be stored. Does nothing
+        if the encoder doesn't support caching.
+       
+        The driver shouldn't assume that this method will always get called. A
+        temporary directory should be used if that's not the case.
+        """
+        
     def process(source, metadata, options=None):
         """Perform the encoding process and stream the result as a generator.
 

diff --git a/encode/flac.py b/encode/flac.py
index 8c38ac2e8367aff05e4597836f665ef63bf3f408..8312e900d4f00771af1a3c40026ca3f1cae02ceb 100644 (file)
--- a/encode/flac.py
+++ b/encode/flac.py
@@ -50,10 +50,7 @@ class FlacEncoder(EncoderCore):
     def description(self):
         return """
         Free Lossless Audio Codec (FLAC) is a file format for lossless audio
-        data compression. During compression, FLAC does not lose quality from
-        the audio stream, as lossy compression formats such as MP3, AAC, and
-        Vorbis do. Josh Coalson is the primary author of FLAC.
-        (source Wikipedia)
+        data compression.
         """
 
     def get_file_info(self):

diff --git a/encode/mp3.py b/encode/mp3.py
index 4f04ab5e84736386578b15b7573895ec1b232628..e38f5b87bba067ad4f7a88744457d4ed27779c03 100644 (file)
--- a/encode/mp3.py
+++ b/encode/mp3.py
@@ -64,11 +64,6 @@ class Mp3Encoder(EncoderCore):
         return """
         MPEG-1 Audio Layer 3, more commonly referred to as MP3, is a patented
         digital audio encoding format using a form of lossy data compression.
-        It is a common audio format for consumer audio storage, as well as a
-        de facto standard of digital audio compression for the transfer and
-        playback of music on digital audio players. MP3 is an audio-specific
-        format that was designed by the Moving Picture Experts Group as part
-        of its MPEG-1 standard. (source Wikipedia)
         """
 
     def get_file_info(self):