diff --git a/doc/source/audiogenerators.rst b/doc/source/audiogenerators.rst
index bb695a0..229a09e 100644
--- a/doc/source/audiogenerators.rst
+++ b/doc/source/audiogenerators.rst
@@ -11,8 +11,7 @@ randomdir
 ----------
 
 Given a directory ``path``, scan it recursively, then picks ``howmany`` random
-files. No filename extensions checks are done, so beware of non-audio file in
-that directory. Files are copied to ``TMPDIR`` before being returned.
+files. Only files whose filename ends in mp3/ogg/oga/wav are considered . Files are copied to ``TMPDIR`` before being returned.
 
 static
 ---------
@@ -20,6 +19,20 @@ static
 That simple: every element in ``paths`` is returned. Before doing so, they are
 copied to ``TMPDIR``.
 
+http
+---------
+
+Given a sequence of ``urls``, downloads each one and enqueue it.
+
+This is **not** suitable for streams (a fundamental limitation of larigira),
+only for audio files.
+
+mostrecent
+-------------
+
+It is similar to randomdir, but instead of picking randomly, picks the most
+recent file (according to the ctime).
+
 script
 --------