Switch to unified view

a/src/doc/user/usermanual.sgml b/src/doc/user/usermanual.sgml
...
...
22
      <year>2005</year>
22
      <year>2005</year>
23
      <holder role="mailto:jean-francois.dockes@wanadoo.fr">Jean-Francois
23
      <holder role="mailto:jean-francois.dockes@wanadoo.fr">Jean-Francois
24
      Dockes</holder>
24
      Dockes</holder>
25
    </copyright>
25
    </copyright>
26
26
27
    <releaseinfo>$Id: usermanual.sgml,v 1.24 2006-11-14 13:55:43 dockes Exp $</releaseinfo>
27
    <releaseinfo>$Id: usermanual.sgml,v 1.25 2006-11-20 17:46:11 dockes Exp $</releaseinfo>
28
28
29
    <abstract>
29
    <abstract>
30
      <para>This document introduces full text search notions
30
      <para>This document introduces full text search notions
31
      and describes the installation and use of the &RCL; application.</para>
31
      and describes the installation and use of the &RCL; application.</para>
32
    </abstract>
32
    </abstract>
...
...
552
       using the  <link linkend="rcl.search.sort"><guilabel>Tools</guilabel>
552
       using the  <link linkend="rcl.search.sort"><guilabel>Tools</guilabel>
553
        / <guilabel>Sort parameters</guilabel></link> dialog.</para>
553
        / <guilabel>Sort parameters</guilabel></link> dialog.</para>
554
554
555
      <para>Clicking on the
555
      <para>Clicking on the
556
       <literal>Preview</literal> link for an entry will open an
556
       <literal>Preview</literal> link for an entry will open an
557
       internal preview window for the document. Clicking the
557
       internal preview window for the document. Further
558
       <literal>Preview</literal> clicks for the same search will open
559
       tabs in the existing preview window. You can use
560
       <keycap>Shift</keycap>+Click to force the creation of another
561
       preview window, which may be useful to view the documents side
562
       by side.</para>
563
558
       <literal>Edit</literal> link will attempt to start an external
564
      <para>Clicking the <literal>Edit</literal> link will attempt to 
559
       viewer (have a look at the <filename>mimeconf</filename>
565
       start an external viewer (have a look at the
560
       configuration file to see how these are configured).</para>
566
       <filename>mimeconf</filename> configuration file to see how
567
       these are configured).</para>
561
568
562
      <para>The <literal>Preview</literal> and <literal>Edit</literal>
569
      <para>The <literal>Preview</literal> and <literal>Edit</literal>
563
       edit links may not be present for all entries, meaning that
570
       edit links may not be present for all entries, meaning that
564
       &RCL; has no configured way to preview a given file type (which
571
       &RCL; has no configured way to preview a given file type (which
565
       was indexed by name only), or no configured external viewer for
572
       was indexed by name only), or no configured external viewer for
...
...
658
665
659
    <sect1 id="rcl.search.complex">
666
    <sect1 id="rcl.search.complex">
660
      <title>Complex/advanced search</title>
667
      <title>Complex/advanced search</title>
661
668
662
      <para>The advanced search dialog has fields that will allow a more
669
      <para>The advanced search dialog has fields that will allow a more
663
        refined search, looking for documents with all given elements, a
670
        refined search. It has a number of entry fields, each of which
664
        given exact phrase, none of the given elements, or a given file
671
        is configurable for the following modes:
665
        name (with wildcard expansion). All relevant fields will be
672
        <itemizedlist>
666
        combined by an implicit AND clause. All fields except "Exact
673
    <listitem><para>All terms.</para>
674
    </listitem>
675
    <listitem><para>Any term.</para>
676
    </listitem>
677
    <listitem><para>None of the terms.</para>
678
    </listitem>
679
    <listitem><para>Phrase (exact terms in order within an
680
    adjustable window).</para>
681
    </listitem>
682
    <listitem><para>Proximity (terms in any order within an
683
    adjustable window).</para>
684
    </listitem>
685
    <listitem><para>Filename search with wildcards.</para>
686
    </listitem>
687
  </itemizedlist>
688
       </para>
689
      <para>Additional entry fields can be created by clicking the
690
      <guilabel>Add clause</guilabel> button.</para>
691
692
      <para>All relevant fields will be combined by an implicit AND
693
        or OR conjunction. All types of clauses except "phrase" and
667
        phrase" can accept a mix of single words and phrases enclosed
694
        "near" can accept a mix of single words and phrases enclosed
668
        in double quotes.</para>
695
        in double quotes. Stemming expansion will be performed for all
696
        terms not beginning with a capital letter, except for "phrase"
697
        clauses.</para>
669
698
670
      <para>Advanced search will let you search for documents of specific mime
699
      <para>Advanced search will also let you search for documents of
671
        types (ie: only <literal>text/plain</literal>, or
700
       specific mime types (ie: only <literal>text/plain</literal>, or
672
        <literal>text/HTML</literal> or
701
        <literal>text/HTML</literal> or
673
        <literal>application/pdf</literal> etc...). The state of the
702
        <literal>application/pdf</literal> etc...). The state of the
674
        file type selection can be saved as the default (the file type
703
        file type selection can be saved as the default (the file type
675
        filter will not be activated at program start-up, but the lists
704
        filter will not be activated at program start-up, but the lists
676
        will be in the restored state).</para>
705
        will be in the restored state).</para>
...
...
883
       <para>Entering <keycap>Shift-Down</keycap> or <keycap>Shift-Up</keycap>
912
       <para>Entering <keycap>Shift-Down</keycap> or <keycap>Shift-Up</keycap>
884
       (<keycap>Shift</keycap> + an arrow key) in a preview window will
913
       (<keycap>Shift</keycap> + an arrow key) in a preview window will
885
       display the next or the previous document from the result
914
       display the next or the previous document from the result
886
       list. Any secondary search currently active will be executed on
915
       list. Any secondary search currently active will be executed on
887
       the new document.</para>
916
       the new document.</para>
917
      </formalpara>
918
919
      <formalpara><title>Forced opening of a preview window (1.6)</title>
920
       <para>You can use <keycap>Shift</keycap>+Click on a result list
921
       <literal>Preview</literal> link to force the creation of a
922
       preview window instead of a new tab in the existing one.</para>
888
      </formalpara>
923
      </formalpara>
889
924
890
      <formalpara><title>AutoPhrases (1.5)</title>
925
      <formalpara><title>AutoPhrases (1.5)</title>
891
      <para>This option can be set in the preferences dialog. If it is
926
      <para>This option can be set in the preferences dialog. If it is
892
      set, a phrase will be automatically built and added to simple
927
      set, a phrase will be automatically built and added to simple