<sect1>
<title>Installation Instructions</title>

  <sect2 id="install-requirements" xreflabel="Requirements">
        <title>Requirements</title>

	The following prerequisites exist for building OpenFTS-&version;:
        <itemizedlist>
          <listitem><para>
	  <ulink
          url="http://www.postgresql.org/">PostgreSQL-&postgresql-version;</ulink> --
	  PostgreSQL is a sophisticated Object-Relational DBMS, supporting almost all SQL constructs, including subselects, transactions, and user-defined types and functions. It is the most advanced open-source database available anywhere.
	  </para></listitem>
          <listitem><para>
	  Tsearch -- This is a PostgreSQL contrib module that provides a new data type, namely "tsvector", which is a string of space separated "words" with indexed access. It can be found under the contrib directory of PostgreSQL.
	  </para></listitem>
          <listitem><para>
	  <ulink url="http://openfts.sourceforge.net/">OpenFTS-&version;</ulink>	  </para></listitem> 
          <listitem><para>
	  PERL modules (DBI, DBD-Pg, Time::HiRes) available
	  from <ulink url="http://www.cpan.org/">CPAN</ulink>. 
	  <itemizedlist>
	    <listitem><para>
	    <ulink url="http://search.cpan.org/search?dist=DBI">DBI</ulink>
	    </para></listitem>
	    <listitem><para>
	    <ulink url="http://search.cpan.org/search?dist=DBD-Pg">DBD::Pg</ulink>
	    </para></listitem>
	    <listitem><para>
	    <ulink url="http://search.cpan.org/search?dist=Time-HiRes">Time::HiRes</ulink>
	    </para></listitem>
	  </itemizedlist>
	  [Only required if you're installing the PERL version of the system.]
	  </para></listitem>
        </itemizedlist>

  </sect2>

  <sect2 id="install-preparation-tasks" xreflabel="Preparation Tasks">
        <title>Preparation Tasks</title>
	<para>
	We will assume that you have all prerequisites installed. However, here are a few things to keep in mind
	during the installation of the prerequisites. First, you have to make sure that you have installed all 
	headers during the PostgreSQL installation -- you can do that with
	<computeroutput>gmake install-all-headers</computeroutput>.
	Next, you have to install Tsearch. Tsearch is under the contrib directory of 
	the PostgreSQL source code.
	</para>
  </sect2>

  <sect2 id="install-short-version" xreflabel="Short Version">
        <title>Short Version</title>

	For those of you who want to get started quickly using OpenFTS,
	follow the instructions below. After you are done you might 
	want to move on	to try the <xref
	linkend="crash-course"/> chapter.

	<programlisting>
	cd /usr/local/src/
	tar -xzvf Search-OpenFTS-0.37.tar.gz
	cd Search-OpenFTS-0.37
	perl Makefile.PL
	make
	make install
	</programlisting>

	<para>
	The long version is the rest of this section.
	</para>


  </sect2>


</sect1>
