From 39b42febb1f1c5fe75547271cad33eb29e9fde72 Mon Sep 17 00:00:00 2001 From: yoni-r Date: Tue, 13 Jun 2006 10:01:00 +0000 Subject: added the section "Finding files and speed" to the manual darcs-hash:20060613100136-85c19-5c278ce45fa496e37f3d4ba1f5c15e7bb08c1c9a.gz --- emms.texinfo | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) 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 -- cgit v1.2.3