/[pgestraier]/trunk/README.pod
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk/README.pod

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/README revision 29 by dpavlin, Wed Jul 6 11:47:56 2005 UTC trunk/README.pod revision 33 by dpavlin, Wed Jul 6 16:35:51 2005 UTC
# Line 1  Line 1 
1  1. pgestraier - search Hyper Estraier indexes from PostgreSQL  =head1 pgestraier - search Hyper Estraier indexes from PostgreSQL
2    
3  This package is essentially PostgreSQL C function which calls Hyper Estraier  This package is essentially PostgreSQL C function which calls Hyper Estraier
4  API and returns results in user defined format.  API and returns results in user defined format.
5    
6  2. Why is it written?  =head1 Why is it written?
7    
8  Aside from providing single API to query your RDBMS and full text index  Aside from providing single API to query your RDBMS and full text index
9  (using any language that has PostgreSQL client libraries), real power is  (using any language that has PostgreSQL client libraries), real power is
10  hidden in ability to join results from full text index and structured data  hidden in ability to join results from full text index and structured data
11  in RDBMS.  in RDBMS.
12    
13  3. How to install  =head1 How to install
14    
15  Installation should be simple. However, you will have to have following  Installation should be simple. However, you will have to have following
16  software already installed before you try this function:  software already installed before you try this function:
17    
18   * PostgreSQL (tested with version 7.4.8) with development libraries  =over
19   * Hyper Estraier (tested with versions 0.3.9 and 0.3.10)  
20    =item *
21    
22    PostgreSQL (tested with version 7.4.8) with development libraries
23    
24    =item *
25    
26    Hyper Estraier (tested with versions 0.3.9 and 0.3.10)
27    
28    =back
29    
30  To run tests you will also need:  To run tests you will also need:
31    
32   * working perl installation  =over
33   * perl modules DBI, DBD::Pg, Test::More  
34   * trivia.list.gz from Internet Movie Database in data/ directory  =item *
35   * database "test" with permissions for current user  
36    working perl installation
37    
38    =item *
39    
40    perl modules C<DBI>, C<DBD::Pg>, C<Test::More> and optionally C<HyperEstraier>
41    
42    =item *
43    
44    C<trivia.list.gz> from Internet Movie Database in data/ directory
45    
46    =item *
47    
48    database "test" with permissions for current user
49    
50    =back
51    
52  If you have all that, you should be able to type  If you have all that, you should be able to type
53    
# Line 35  could access it. Line 59  could access it.
59    
60  Next, you will have to create test index. You have two options:  Next, you will have to create test index. You have two options:
61    
62  3.1. Create index using estcmd  =head2 Create index using estcmd
63    
64  This will create temporary files on disk and index them using estcmd gather  This will create temporary files on disk and index them using estcmd gather
65    
# Line 43  This will create temporary files on disk Line 67  This will create temporary files on disk
67    make index    make index
68    cd ..    cd ..
69    
70  3.2. Create index using Hyper Estraier perl bindings  =head2 Create index using Hyper Estraier perl bindings
71    
72  For this, you will have to install perl bindings from  For this, you will have to install perl bindings from
73    
74    http://tokuhirom.dnsalias.org/~tokuhirom/archive/hyper_estraier_wrappers-0.0.6.tar.gz  L<http://tokuhirom.dnsalias.org/~tokuhirom/archive/hyper_estraier_wrappers-0.0.6.tar.gz>
75    
76  If you installed bindings as documented in README file, you can issue  If you installed bindings as documented in README file, you can issue
77  following commands to create index about three times faster than using  following commands to create index about three times faster than using
# Line 63  To run tests (which require that you hav Line 87  To run tests (which require that you hav
87    
88  See also included file test.sql for more examples of usage.  See also included file test.sql for more examples of usage.
89    
90  4. Who wrote this?  =head1 Who wrote this?
91    
92  Hyper Estraier is written by Mikio Hirabayashi.  Hyper Estraier is written by Mikio Hirabayashi.
93    
Legend:
Removed from v.29  
changed lines
  Added in v.33
  ViewVC Help
Powered by ViewVC 1.1.26