--- a/src/kde/kioslave/recoll/data/help.html
+++ b/src/kde/kioslave/recoll/data/help.html
@@ -8,9 +8,7 @@
<h2>Recoll kio slave</h2>
<p>Use this module to perform Recoll searches from any program with
- a KIO interface. <b>kio_recoll</b> is primarily
- designed and tested with <b>konqueror</b>, and you will
- undoubtedly get even more surprising effects with other tools.</p>
+ a KIO interface.</p>
<p>The module can work in two modes:</p>
<ul>
@@ -25,6 +23,12 @@
ideas about improving kio_recoll, or observe an interesting and
reproducible sequence, please <a href="mailto:jfd@recoll.org">
report it</a>.</p>
+ <p><b>kio_recoll</b> is primarily
+ designed and tested with <b>konqueror</b>, and you will
+ undoubtedly get <i>even</i> more surprising effects with other tools.</p>
+
+ <p>The Html interface is currently much more usable. The directory
+ interface is extremely quirky.</p>
<p>The module is particularly unhelpful with search hits inside
email folders, which Konqueror has no way to access.</p>
@@ -40,26 +44,21 @@
<p>You normally enter this interface by entering "recoll:" or
"recoll:/" in the Konqueror URL entry, and following the "search"
- link.<br> In most circumstances, entering a link like
+ link. You can also directly enter "recoll:/search.html".<br>
+
+ In most circumstances, entering a link like
<a href="recoll:/john smith">recoll:/john smith</a> will also
yield an HTML result list.</p>
+ <p>Compared to QT Recoll, the nice point is that you can click or
+ drag/drop the icons to access the results in the standard desktop
+ way.</p>
<h3>File manager interface</h3>
-
- <p>Search results are returned as directory entries. No search
- result details (samples, relevance etc.) are available, but this
- interface allows multiple selections and copies, usage inside any
- KDE open dialog, etc.</p>
<p>The <i>path</i> part of the URI is taken as a Recoll query
language string and executed. The results are displayed as
directory entries.</p>
-
- <p>To avoid swamping the interface with thousands of results, the
- result count is limited to 100 by default. You can change this value
- by setting the <code>kio_max_direntries</code> parameter in your recoll
- configuration file (typically ~/.recoll/recoll.conf)</p>
<p>There are several ways to enter this interface:</p>
<ul>
@@ -72,15 +71,6 @@
recoll:/red apples ext:html/</a>
</blockquote>
</li>
-
- <li>Switching from the HTML interface in konqueror by clicking the
- "Directory view" link at the top of the page. When doing
- this, the directory content will be synchronized with the
- current HTML result page. This offers a way to display results
- in the file manager beyond the <code>kio_max_direntries</code>
- limit. <em>In most cases, you will have to reload the file
- manager page to obtain this synchronization</em>.</li>
-
<li>Users who will want to use the file manager view most of the
time can set the <code>RECOLL_KIO_ALWAYS_DIR</code> environment
variable or the <code>kio_always_dir</code> recoll.conf variable
@@ -88,6 +78,22 @@
through the search link in the top "recoll:" view.</li>
</ul>
+ <p>No search result details (samples, relevance etc.) are available,
+ but this interface allows multiple selections and copies, usage
+ inside any KDE open dialog, etc.</p>
+
+ <p>To avoid swamping the interface with thousands of results, the
+ result count is limited to 100 by default. You can change this value
+ by setting the <code>kio_max_direntries</code> parameter in your recoll
+ configuration file (typically ~/.recoll/recoll.conf)</p>
+
+ <p>Because of limitations in the current KIO slave usage, the actual
+ entry names are not those displayed but synthetic ones like
+ "recollResultxxx". This has unfortunate side-effects when
+ dragging/dropping the entries to some other application, or when
+ using an open dialog (the opened file doesn't have the correct path
+ to the original file).</p>
+
<p><a href="recoll:///search.html">Recoll Search</a></p>
</body>