aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoryoni-r <yoni-r>2006-06-13 10:01:00 +0000
committeryoni-r <mwolson@gnu.org>2006-06-13 10:01:00 +0000
commit39b42febb1f1c5fe75547271cad33eb29e9fde72 (patch)
treea6cf9d309657329adcb56a175151307f0e8fca8f
parent4cf3a346444fc11195dc609db892ecdea17cda7a (diff)
added the section "Finding files and speed" to the manual
darcs-hash:20060613100136-85c19-5c278ce45fa496e37f3d4ba1f5c15e7bb08c1c9a.gz
-rw-r--r--emms.texinfo26
1 files changed, 26 insertions, 0 deletions
diff --git a/emms.texinfo b/emms.texinfo
index 55947a5..6dcbdd3 100644
--- a/emms.texinfo
+++ b/emms.texinfo
@@ -296,6 +296,32 @@ second sets the default name of the Emms playlist buffer.
Another way to change Emms variables is to use the M-x
@command{customize} mechanism provided by Emacs.
+@menu
+* Finding files and speed:: Finding files quickly or portably
+@end menu
+
+@node Finding files and speed
+@section Finding files and speed
+
+@cindex files
+@cindex speed
+
+Emms needs to traverse directories in order to find playable
+media. The default method Emms uses to achive this is
+@code{emms-source-file-directory-tree-internal} as defined in
+@file{emms-source-file.el}. The above method is written portably and
+will always work, but might be too slow if we want to load several
+hundred tracks (or more).
+
+@file{emms-source-file.el} defines another method for finding files,
+@code{emms-source-file-directory-tree-find} which uses
+GNU/find. @code{emms-source-file-directory-tree-find} is usually an
+order of magnitude faster, but of course will not work if you do not
+have GNU/find installed.
+
+The method Emms will use is defined in the customisable variable
+@var{emms-source-file-directory-tree-function}.
+
@node Basic Commands
@chapter Basic Commands