Add --enable-guidebug configure option to build the recoll program with debug symbols. Closes issue #91
This commit is contained in:
Jean-Francois Dockes
parent
6b22d38a3e
commit
d5060a132c
@ -466,6 +466,18 @@ if test X$enableQT = Xyes ; then
|
|||||||
QMAKE_DISABLE_ZEITGEIST=""
|
QMAKE_DISABLE_ZEITGEIST=""
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Retain debugging symbols in GUI recoll ? This makes it enormous (~50MB)
|
||||||
|
AC_ARG_ENABLE(guidebug,
|
||||||
|
AC_HELP_STRING([--enable-guidebug],
|
||||||
|
[Generate and retain debug symbols in GUI program (makes the file very big).]),
|
||||||
|
enableGuiDebug=$enableval, enableGuiDebug="no")
|
||||||
|
|
||||||
|
if test "$enableGuiDebug" = "yes" ; then
|
||||||
|
QMAKE_ENABLE_GUIDEBUG=""
|
||||||
|
else
|
||||||
|
QMAKE_ENABLE_GUIDEBUG="#"
|
||||||
|
fi
|
||||||
|
|
||||||
AC_CONFIG_FILES($QTGUI/recoll.pro)
|
AC_CONFIG_FILES($QTGUI/recoll.pro)
|
||||||
|
|
||||||
##################### End QT stuff
|
##################### End QT stuff
|
||||||
@ -565,6 +577,8 @@ AC_SUBST(QMAKE_ENABLE_WEBKIT)
|
|||||||
AC_SUBST(QMAKE_DISABLE_WEBKIT)
|
AC_SUBST(QMAKE_DISABLE_WEBKIT)
|
||||||
AC_SUBST(QMAKE_ENABLE_WEBENGINE)
|
AC_SUBST(QMAKE_ENABLE_WEBENGINE)
|
||||||
AC_SUBST(QMAKE_DISABLE_WEBENGINE)
|
AC_SUBST(QMAKE_DISABLE_WEBENGINE)
|
||||||
|
AC_SUBST(QMAKE_ENABLE_GUIDEBUG)
|
||||||
|
AC_SUBST(QMAKE_DISABLE_GUIDEBUG)
|
||||||
AC_SUBST(QMAKE_ENABLE_ZEITGEIST)
|
AC_SUBST(QMAKE_ENABLE_ZEITGEIST)
|
||||||
AC_SUBST(QMAKE_DISABLE_ZEITGEIST)
|
AC_SUBST(QMAKE_DISABLE_ZEITGEIST)
|
||||||
AC_SUBST(LIBQZEITGEIST)
|
AC_SUBST(LIBQZEITGEIST)
|
||||||
|
|||||||
@ -8389,169 +8389,158 @@ hasextract = False
|
|||||||
system, and need to modify things, <a class="ulink" href=
|
system, and need to modify things, <a class="ulink" href=
|
||||||
"mailto:jfd@recoll.org" target="_top">I would very much
|
"mailto:jfd@recoll.org" target="_top">I would very much
|
||||||
welcome patches</a>.</p>
|
welcome patches</a>.</p>
|
||||||
<p><b>Configure options: </b></p>
|
<div class="sect3">
|
||||||
<div class="itemizedlist">
|
<div class="titlepage">
|
||||||
<ul class="itemizedlist" style=
|
<div>
|
||||||
"list-style-type: disc;">
|
<div>
|
||||||
<li class="listitem">
|
<h4 class="title"><a name=
|
||||||
<p><code class="option">--without-aspell</code>
|
"RCL.INSTALL.BUILDING.BUILDING.CONFIGURE" id=
|
||||||
will disable the code for phonetic matching of
|
"RCL.INSTALL.BUILDING.BUILDING.CONFIGURE"></a>Configure
|
||||||
search terms.</p>
|
options:</h4>
|
||||||
</li>
|
</div>
|
||||||
<li class="listitem">
|
</div>
|
||||||
<p><code class="option">--with-fam</code> or
|
</div>
|
||||||
<code class="option">--with-inotify</code> will
|
<p><code class="option">--without-aspell</code> will
|
||||||
enable the code for real time indexing. Inotify
|
disable the code for phonetic matching of search
|
||||||
support is enabled by default on Linux systems.</p>
|
terms.</p>
|
||||||
</li>
|
<p><code class="option">--with-fam</code> or
|
||||||
<li class="listitem">
|
<code class="option">--with-inotify</code> will enable
|
||||||
<p><code class="option">--with-qzeitgeist</code>
|
the code for real time indexing. Inotify support is
|
||||||
will enable sending <span class=
|
enabled by default on Linux systems.</p>
|
||||||
"application">Zeitgeist</span> events about the
|
<p><code class="option">--with-qzeitgeist</code> will
|
||||||
visited search results, and needs the <span class=
|
enable sending <span class=
|
||||||
"application">qzeitgeist</span> package.</p>
|
"application">Zeitgeist</span> events about the visited
|
||||||
</li>
|
search results, and needs the <span class=
|
||||||
<li class="listitem">
|
"application">qzeitgeist</span> package.</p>
|
||||||
<p><code class="option">--disable-webkit</code> is
|
<p><code class="option">--disable-qtgui</code> will
|
||||||
available from version 1.17 to implement the result
|
disable the Qt graphical interface, which allows
|
||||||
list with a <span class="application">Qt</span>
|
building the indexer and the command line search
|
||||||
QTextBrowser instead of a WebKit widget if you do
|
program in absence of a Qt environment.</p>
|
||||||
not or can't depend on the latter.</p>
|
<p><code class="option">--disable-webkit</code> will
|
||||||
</li>
|
implement the result list with a <span class=
|
||||||
<li class="listitem">
|
"application">Qt</span> QTextBrowser instead of a
|
||||||
<p><code class="option">--disable-qtgui</code>
|
WebKit widget if you do not or can't depend on the
|
||||||
Disable the Qt interface. Will allow building the
|
latter.</p>
|
||||||
indexer and the command line search program in
|
<p><code class="option">--enable-webengine</code> will
|
||||||
absence of a Qt environment.</p>
|
enable the use of Qt Webengine (only meaningful if the
|
||||||
</li>
|
Qt GUI is enabled), in place or Qt Webkit.</p>
|
||||||
<li class="listitem">
|
<p><code class="option">--enable-guidebug</code> will
|
||||||
<p><code class="option">--enable-webengine</code>
|
build the recoll GUI program with debug symbols. This
|
||||||
Enable the use of Qt Webengine (only meaningful if
|
makes it very big (~50MB), which is why it is stripped
|
||||||
the Qt GUI is enabled), in place or Qt Webkit.</p>
|
by default.</p>
|
||||||
</li>
|
<p><code class="option">--disable-idxthreads</code> is
|
||||||
<li class="listitem">
|
available from version 1.19 to suppress multithreading
|
||||||
<p><code class="option">--disable-idxthreads</code>
|
inside the indexing process. You can also use the
|
||||||
is available from version 1.19 to suppress
|
run-time configuration to restrict <span class=
|
||||||
multithreading inside the indexing process. You can
|
"command"><strong>recollindex</strong></span> to using
|
||||||
also use the run-time configuration to restrict
|
a single thread, but the compile-time option may
|
||||||
<span class=
|
disable a few more unused locks. This only applies to
|
||||||
"command"><strong>recollindex</strong></span> to
|
the use of multithreading for the core index processing
|
||||||
using a single thread, but the compile-time option
|
(data input). The <span class=
|
||||||
may disable a few more unused locks. This only
|
"application">Recoll</span> monitor mode always uses at
|
||||||
applies to the use of multithreading for the core
|
least two threads of execution.</p>
|
||||||
index processing (data input). The <span class=
|
<p><code class="option">--disable-python-module</code>
|
||||||
"application">Recoll</span> monitor mode always
|
will avoid building the <span class=
|
||||||
uses at least two threads of execution.</p>
|
"application">Python</span> module.</p>
|
||||||
</li>
|
<p><code class="option">--disable-python-chm</code>
|
||||||
<li class="listitem">
|
will avoid building the Python libchm interface used to
|
||||||
<p><code class=
|
index CHM files.</p>
|
||||||
"option">--disable-python-module</code> will avoid
|
<p><code class="option">--enable-camelcase</code> will
|
||||||
building the <span class=
|
enable splitting <em class=
|
||||||
"application">Python</span> module.</p>
|
"replaceable"><code>camelCase</code></em> words. This
|
||||||
</li>
|
is not enabled by default as it has the unfortunate
|
||||||
<li class="listitem">
|
side-effect of making some phrase searches quite
|
||||||
<p><code class="option">--disable-python-chm</code>
|
confusing: ie, <code class="literal">"MySQL
|
||||||
will avoid building the Python libchm interface
|
manual"</code> would be matched by <code class=
|
||||||
used to index CHM files.</p>
|
"literal">"MySQL manual"</code> and <code class=
|
||||||
</li>
|
"literal">"my sql manual"</code> but not <code class=
|
||||||
<li class="listitem">
|
"literal">"mysql manual"</code> (only inside phrase
|
||||||
<p><code class="option">--enable-camelcase</code>
|
searches).</p>
|
||||||
will enable splitting <em class=
|
<p><code class="option">--with-file-command</code>
|
||||||
"replaceable"><code>camelCase</code></em> words.
|
Specify the version of the 'file' command to use (ie:
|
||||||
This is not enabled by default as it has the
|
--with-file-command=/usr/local/bin/file). Can be useful
|
||||||
unfortunate side-effect of making some phrase
|
to enable the gnu version on systems where the native
|
||||||
searches quite confusing: ie, <code class=
|
one is bad.</p>
|
||||||
"literal">"MySQL manual"</code> would be matched by
|
<p><code class="option">--disable-x11mon</code> Disable
|
||||||
<code class="literal">"MySQL manual"</code> and
|
<span class="application">X11</span> connection
|
||||||
<code class="literal">"my sql manual"</code> but
|
monitoring inside recollindex. Together with
|
||||||
not <code class="literal">"mysql manual"</code>
|
--disable-qtgui, this allows building recoll without
|
||||||
(only inside phrase searches).</p>
|
<span class="application">Qt</span> and <span class=
|
||||||
</li>
|
"application">X11</span>.</p>
|
||||||
<li class="listitem">
|
<p><code class="option">--disable-userdoc</code> will
|
||||||
<p><code class="option">--with-file-command</code>
|
avoid building the user manual. This avoids having to
|
||||||
Specify the version of the 'file' command to use
|
install the Docbook XML/XSL files and the TeX toolchain
|
||||||
(ie: --with-file-command=/usr/local/bin/file). Can
|
used for translating the manual to PDF.</p>
|
||||||
be useful to enable the gnu version on systems
|
<p><code class="option">--enable-recollq</code> Enable
|
||||||
where the native one is bad.</p>
|
building the <span class=
|
||||||
</li>
|
"command"><strong>recollq</strong></span> command line
|
||||||
<li class="listitem">
|
query tool (recoll -t without need for Qt). This is
|
||||||
<p><code class="option">--disable-x11mon</code>
|
done by default if --disable-qtgui is set but this
|
||||||
Disable <span class="application">X11</span>
|
option enables forcing it.</p>
|
||||||
connection monitoring inside recollindex. Together
|
<p><code class="option">--disable-pic</code>
|
||||||
with --disable-qtgui, this allows building recoll
|
(<span class="application">Recoll</span> versions up to
|
||||||
without <span class="application">Qt</span> and
|
1.21 only) will compile <span class=
|
||||||
<span class="application">X11</span>.</p>
|
"application">Recoll</span> with position-dependant
|
||||||
</li>
|
code. This is incompatible with building the KIO or the
|
||||||
<li class="listitem">
|
<span class="application">Python</span> or <span class=
|
||||||
<p><code class="option">--disable-userdoc</code>
|
"application">PHP</span> extensions, but might yield
|
||||||
will avoid building the user manual. This avoids
|
very marginally faster code.</p>
|
||||||
having to install the Docbook XML/XSL files and the
|
<p><code class="option">--without-systemd</code>
|
||||||
TeX toolchain used for translating the manual to
|
Disable the automatic installation of systemd unit
|
||||||
PDF.</p>
|
files. Normally unit files are installed if the install
|
||||||
</li>
|
path can be detected.</p>
|
||||||
<li class="listitem">
|
<p><code class=
|
||||||
<p><code class="option">--enable-recollq</code>
|
"option">--with-system-unit-dir=DIR</code> Provide an
|
||||||
Enable building the <span class=
|
install path for the systemd system unit template
|
||||||
"command"><strong>recollq</strong></span> command
|
file.</p>
|
||||||
line query tool (recoll -t without need for Qt).
|
<p><code class="option">--with-user-unit-dir=DIR</code>
|
||||||
This is done by default if --disable-qtgui is set
|
Provide an install path for the systemd user unit
|
||||||
but this option enables forcing it.</p>
|
file.</p>
|
||||||
</li>
|
<p>Of course the usual <span class=
|
||||||
<li class="listitem">
|
"application">autoconf</span> <span class=
|
||||||
<p><code class="option">--disable-pic</code>
|
"command"><strong>configure</strong></span> options,
|
||||||
(<span class="application">Recoll</span> versions
|
like <code class="option">--prefix</code> apply.</p>
|
||||||
up to 1.21 only) will compile <span class=
|
</div>
|
||||||
"application">Recoll</span> with position-dependant
|
<div class="sect3">
|
||||||
code. This is incompatible with building the KIO or
|
<div class="titlepage">
|
||||||
the <span class="application">Python</span> or
|
<div>
|
||||||
<span class="application">PHP</span> extensions,
|
<div>
|
||||||
but might yield very marginally faster code.</p>
|
<h4 class="title"><a name=
|
||||||
</li>
|
"RCL.INSTALL.BUILDING.BUILDING.TAR" id=
|
||||||
<li class="listitem">
|
"RCL.INSTALL.BUILDING.BUILDING.TAR"></a>Normal
|
||||||
<p><code class="option">--without-systemd</code>
|
procedure, for source extracted from a tar
|
||||||
Disable the automatic installation of systemd unit
|
distribution)</h4>
|
||||||
files. Normally unit files are installed if the
|
</div>
|
||||||
install path can be detected.</p>
|
</div>
|
||||||
</li>
|
</div>
|
||||||
<li class="listitem">
|
<pre class="screen"><strong class=
|
||||||
<p><code class=
|
"userinput"><code>cd recoll-xxx</code></strong>
|
||||||
"option">--with-system-unit-dir=DIR</code> Provide
|
<strong class="userinput"><code>./configure <em class=
|
||||||
an install path for the systemd system unit
|
"replaceable"><code>[options]</code></em></code></strong>
|
||||||
template file.</p>
|
<strong class="userinput"><code>make</code></strong>
|
||||||
</li>
|
<strong class=
|
||||||
<li class="listitem">
|
"userinput"><code>(practices usual hardship-repelling invocations)</code></strong></pre>
|
||||||
<p><code class=
|
</div>
|
||||||
"option">--with-user-unit-dir=DIR</code> Provide an
|
<div class="sect3">
|
||||||
install path for the systemd user unit file.</p>
|
<div class="titlepage">
|
||||||
</li>
|
<div>
|
||||||
<li class="listitem">
|
<div>
|
||||||
<p>Of course the usual <span class=
|
<h4 class="title"><a name=
|
||||||
"application">autoconf</span> <span class=
|
"RCL.INSTALL.BUILDING.BUILDING.GIT" id=
|
||||||
"command"><strong>configure</strong></span>
|
"RCL.INSTALL.BUILDING.BUILDING.GIT"></a>Building
|
||||||
options, like <code class="option">--prefix</code>
|
from git code</h4>
|
||||||
apply.</p>
|
</div>
|
||||||
</li>
|
</div>
|
||||||
</ul>
|
</div>
|
||||||
|
<p>When building from source cloned from the git
|
||||||
|
repository, you also need to install <span class=
|
||||||
|
"application">autoconf</span>, <span class=
|
||||||
|
"application">automake</span>, and <span class=
|
||||||
|
"application">libtool</span> and you must execute
|
||||||
|
<code class="literal">sh autogen.sh</code> in the top
|
||||||
|
source directory before running <code class=
|
||||||
|
"literal">configure</code>.</p>
|
||||||
</div>
|
</div>
|
||||||
<p>Normal procedure (for source extracted from a tar
|
|
||||||
distribution):</p>
|
|
||||||
<pre class="screen">
|
|
||||||
<strong class=
|
|
||||||
"userinput"><code>cd recoll-xxx</code></strong>
|
|
||||||
<strong class=
|
|
||||||
"userinput"><code>./configure</code></strong>
|
|
||||||
<strong class="userinput"><code>make</code></strong>
|
|
||||||
<strong class=
|
|
||||||
"userinput"><code>(practices usual hardship-repelling invocations)</code></strong>
|
|
||||||
</pre>
|
|
||||||
<p>When building from source cloned from the git
|
|
||||||
repository, you also need to install <span class=
|
|
||||||
"application">autoconf</span>, <span class=
|
|
||||||
"application">automake</span>, and <span class=
|
|
||||||
"application">libtool</span> and you must execute
|
|
||||||
<code class="literal">sh autogen.sh</code> in the top
|
|
||||||
source directory before running <code class=
|
|
||||||
"literal">configure</code>.</p>
|
|
||||||
</div>
|
</div>
|
||||||
<div class="sect2">
|
<div class="sect2">
|
||||||
<div class="titlepage">
|
<div class="titlepage">
|
||||||
|
|||||||
@ -5363,10 +5363,10 @@ text/html [file:///Users/uncrypted-dockes/projets/bateaux/ilur/factEtCie/r
|
|||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
<para>There is a good chance that your system repository has
|
<para>There is a good chance that your system repository has packages for the Recoll Python
|
||||||
packages for the Recoll Python API, sometimes in a package separate
|
API, sometimes in a package separate from the main one (maybe named something like
|
||||||
from the main one (maybe named something like python-recoll). Else
|
python-recoll). Else refer to the <link linkend="RCL.INSTALL.BUILDING">Building from source
|
||||||
refer to the <link linkend="RCL.INSTALL.BUILDING">Building from source chapter</link>.</para>
|
chapter</link>.</para>
|
||||||
|
|
||||||
<para>As an introduction, the following small sample will run a
|
<para>As an introduction, the following small sample will run a
|
||||||
query and list the title and url for each of the results. The
|
query and list the title and url for each of the results. The
|
||||||
@ -6323,12 +6323,10 @@ hasextract = False
|
|||||||
for <ulink url="http://www.xapian.org"> <application>Xapian
|
for <ulink url="http://www.xapian.org"> <application>Xapian
|
||||||
core</application></ulink>.</para>
|
core</application></ulink>.</para>
|
||||||
<important>
|
<important>
|
||||||
<para>If you are
|
<para>If you are building Xapian for an older CPU (before Pentium 4 or Athlon 64), you
|
||||||
building Xapian for an older CPU (before Pentium 4 or Athlon
|
need to add the <option>--disable-sse</option> flag to the configure command. Else all
|
||||||
64), you need to add the <option>--disable-sse</option> flag
|
Xapian application will crash with an <literal>illegal instruction</literal>
|
||||||
to the configure command. Else all Xapian application will
|
error.</para>
|
||||||
crash with an <literal>illegal instruction</literal>
|
|
||||||
error.</para>
|
|
||||||
</important>
|
</important>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
@ -6357,8 +6355,8 @@ hasextract = False
|
|||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
<para>Check the <ulink url="http://www.recoll.org/pages/download.html">
|
<para>Check the <ulink url="http://www.recoll.org/pages/download.html">
|
||||||
&RCL; download page</ulink> for up to date version
|
&RCL; download page</ulink> for up to date version
|
||||||
information.</para>
|
information.</para>
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
@ -6366,147 +6364,143 @@ hasextract = False
|
|||||||
<title>Building</title>
|
<title>Building</title>
|
||||||
|
|
||||||
<para>&RCL; has been built on Linux, FreeBSD, Mac OS X, and Solaris,
|
<para>&RCL; has been built on Linux, FreeBSD, Mac OS X, and Solaris,
|
||||||
most versions after 2005 should be ok, maybe some older ones too
|
most versions after 2005 should be ok, maybe some older ones too (Solaris 8 used to be
|
||||||
(Solaris 8 used to be ok). If you build on another system, and
|
ok). If you build on another system, and need to modify
|
||||||
need to modify things,
|
things, <ulink url="mailto:jfd@recoll.org">I would very much welcome
|
||||||
<ulink url="mailto:jfd@recoll.org">I would
|
patches</ulink>.</para>
|
||||||
very much welcome patches</ulink>.</para>
|
|
||||||
|
|
||||||
|
|
||||||
<formalpara>
|
<sect3 id="RCL.INSTALL.BUILDING.BUILDING.CONFIGURE">
|
||||||
<title>Configure options:</title>
|
<title>Configure options:</title>
|
||||||
<para>
|
|
||||||
<itemizedlist>
|
|
||||||
|
|
||||||
<listitem><para><option>--without-aspell</option>
|
<para><option>--without-aspell</option>
|
||||||
will disable the code for phonetic matching of search
|
will disable the code for phonetic matching of search
|
||||||
terms. </para></listitem>
|
terms. </para>
|
||||||
|
|
||||||
<listitem><para><option>--with-fam</option> or
|
<para><option>--with-fam</option> or
|
||||||
<option>--with-inotify</option> will enable the code for real
|
<option>--with-inotify</option> will enable the code for real
|
||||||
time indexing. Inotify support is enabled by default on Linux
|
time indexing. Inotify support is enabled by default on Linux
|
||||||
systems.</para></listitem>
|
systems.</para>
|
||||||
|
|
||||||
|
|
||||||
<listitem><para><option>--with-qzeitgeist</option> will
|
<para><option>--with-qzeitgeist</option> will
|
||||||
enable sending <application>Zeitgeist</application>
|
enable sending <application>Zeitgeist</application>
|
||||||
events about the visited search results, and needs
|
events about the visited search results, and needs
|
||||||
the <application>qzeitgeist</application>
|
the <application>qzeitgeist</application>
|
||||||
package.</para></listitem>
|
package.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-webkit</option> is available
|
<para><option>--disable-qtgui</option> will disable the Qt
|
||||||
from version 1.17 to implement the result list with a
|
graphical interface, which allows building the indexer and the command line search
|
||||||
<application>Qt</application> QTextBrowser instead of a
|
program in absence of a Qt environment.</para>
|
||||||
WebKit widget if you do not or can't depend on the
|
|
||||||
latter.</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para><option>--disable-qtgui</option> Disable the Qt
|
<para><option>--disable-webkit</option> will implement the result list with
|
||||||
interface. Will allow building the indexer and the command line
|
a <application>Qt</application> QTextBrowser instead of a WebKit widget if you do
|
||||||
search program in absence of a Qt environment.</para>
|
not or can't depend on the latter.</para>
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem><para><option>--enable-webengine</option> Enable the
|
<para><option>--enable-webengine</option> will enable the use of Qt
|
||||||
use of Qt Webengine (only meaningful if the Qt GUI
|
Webengine (only meaningful if the Qt GUI is enabled), in place or Qt
|
||||||
is enabled), in place or Qt Webkit.</para></listitem>
|
Webkit.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-idxthreads</option> is available
|
<para><option>--enable-guidebug</option> will build the recoll GUI program
|
||||||
from version 1.19 to suppress multithreading inside the
|
with debug symbols. This makes it very big (~50MB), which is why it is stripped by
|
||||||
indexing process. You can also use the run-time
|
default.</para>
|
||||||
configuration to restrict <command>recollindex</command>
|
|
||||||
to using a single thread, but the compile-time option
|
|
||||||
may disable a few more unused locks. This only applies
|
|
||||||
to the use of multithreading for the core index
|
|
||||||
processing (data input). The &RCL; monitor mode always
|
|
||||||
uses at least two threads of execution.</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para><option>--disable-python-module</option> will
|
<para><option>--disable-idxthreads</option> is available from version 1.19
|
||||||
avoid building the <application>Python</application>
|
to suppress multithreading inside the indexing process. You can also use the run-time
|
||||||
module.</para></listitem>
|
configuration to restrict <command>recollindex</command> to using a single thread, but
|
||||||
|
the compile-time option may disable a few more unused locks. This only applies to the
|
||||||
|
use of multithreading for the core index processing (data input). The &RCL; monitor
|
||||||
|
mode always uses at least two threads of execution.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-python-chm</option> will
|
<para><option>--disable-python-module</option> will
|
||||||
avoid building the Python libchm interface used to index CHM
|
avoid building the <application>Python</application>
|
||||||
files.</para></listitem>
|
module.</para>
|
||||||
|
|
||||||
<listitem><para><option>--enable-camelcase</option> will enable
|
<para><option>--disable-python-chm</option> will
|
||||||
splitting <replaceable>camelCase</replaceable> words. This
|
avoid building the Python libchm interface used to index CHM
|
||||||
is not enabled by default as it has the unfortunate
|
files.</para>
|
||||||
side-effect of making some phrase searches quite
|
|
||||||
confusing: ie, <literal>"MySQL manual"</literal> would be
|
|
||||||
matched by <literal>"MySQL manual"</literal> and
|
|
||||||
<literal>"my sql manual"</literal> but not
|
|
||||||
<literal>"mysql manual"</literal> (only inside phrase
|
|
||||||
searches).</para>
|
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem><para><option>--with-file-command</option> Specify
|
<para><option>--enable-camelcase</option> will enable
|
||||||
the version of the 'file' command to use (ie:
|
splitting <replaceable>camelCase</replaceable> words. This
|
||||||
--with-file-command=/usr/local/bin/file). Can be useful to
|
is not enabled by default as it has the unfortunate
|
||||||
enable the gnu version on systems where the native one is
|
side-effect of making some phrase searches quite
|
||||||
bad.</para> </listitem>
|
confusing: ie, <literal>"MySQL manual"</literal> would be
|
||||||
|
matched by <literal>"MySQL manual"</literal> and
|
||||||
|
<literal>"my sql manual"</literal> but not
|
||||||
|
<literal>"mysql manual"</literal> (only inside phrase
|
||||||
|
searches).</para>
|
||||||
|
|
||||||
|
<para><option>--with-file-command</option> Specify
|
||||||
|
the version of the 'file' command to use (ie:
|
||||||
|
--with-file-command=/usr/local/bin/file). Can be useful to
|
||||||
|
enable the gnu version on systems where the native one is
|
||||||
|
bad.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-x11mon</option> Disable
|
<para><option>--disable-x11mon</option> Disable
|
||||||
<application>X11</application> connection monitoring
|
<application>X11</application> connection monitoring
|
||||||
inside recollindex. Together with --disable-qtgui, this
|
inside recollindex. Together with --disable-qtgui, this
|
||||||
allows building recoll without
|
allows building recoll without
|
||||||
<application>Qt</application> and
|
<application>Qt</application> and
|
||||||
<application>X11</application>.</para> </listitem>
|
<application>X11</application>.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-userdoc</option>
|
<para><option>--disable-userdoc</option>
|
||||||
will avoid building the user manual. This avoids having to
|
will avoid building the user manual. This avoids having to
|
||||||
install the Docbook XML/XSL files and the TeX toolchain used for
|
install the Docbook XML/XSL files and the TeX toolchain used for
|
||||||
translating the manual to PDF.</para></listitem>
|
translating the manual to PDF.</para>
|
||||||
|
|
||||||
<listitem><para><option>--enable-recollq</option> Enable
|
<para><option>--enable-recollq</option> Enable
|
||||||
building the <command>recollq</command> command line query
|
building the <command>recollq</command> command line query
|
||||||
tool (recoll -t without need for Qt). This is done by
|
tool (recoll -t without need for Qt). This is done by
|
||||||
default if --disable-qtgui is set but this option
|
default if --disable-qtgui is set but this option
|
||||||
enables forcing it.</para></listitem>
|
enables forcing it.</para>
|
||||||
|
|
||||||
<listitem><para><option>--disable-pic</option> (&RCL; versions up
|
<para><option>--disable-pic</option> (&RCL; versions up to 1.21 only) will
|
||||||
to 1.21 only) will compile
|
compile &RCL; with position-dependant code. This is incompatible with building the KIO
|
||||||
&RCL; with position-dependant code. This is incompatible with
|
or the <application>Python</application> or <application>PHP</application> extensions,
|
||||||
building the KIO or the <application>Python</application>
|
but might yield very marginally faster code.</para>
|
||||||
or <application>PHP</application> extensions, but might
|
|
||||||
yield very marginally faster code.</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para><option>--without-systemd</option> Disable
|
<para><option>--without-systemd</option> Disable
|
||||||
the automatic installation of systemd unit files. Normally
|
the automatic installation of systemd unit files. Normally
|
||||||
unit files are installed if the install path can be detected.
|
unit files are installed if the install path can be detected.
|
||||||
</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para>
|
|
||||||
<option>--with-system-unit-dir=DIR</option> Provide
|
|
||||||
an install path for the systemd system unit template file.
|
|
||||||
</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para>
|
|
||||||
<option>--with-user-unit-dir=DIR</option> Provide
|
|
||||||
an install path for the systemd user unit file.
|
|
||||||
</para></listitem>
|
|
||||||
|
|
||||||
<listitem><para>Of course the usual
|
|
||||||
<application>autoconf</application> <command>configure</command>
|
|
||||||
options, like <option>--prefix</option> apply.</para>
|
|
||||||
</listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</para>
|
</para>
|
||||||
</formalpara>
|
|
||||||
|
<para>
|
||||||
|
<option>--with-system-unit-dir=DIR</option> Provide
|
||||||
|
an install path for the systemd system unit template file.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
<option>--with-user-unit-dir=DIR</option> Provide
|
||||||
|
an install path for the systemd user unit file.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>Of course the usual <application>autoconf</application> <command>configure</command>
|
||||||
|
options, like <option>--prefix</option> apply.</para>
|
||||||
|
</sect3>
|
||||||
|
|
||||||
<para>Normal procedure (for source extracted from a tar
|
<sect3 id="RCL.INSTALL.BUILDING.BUILDING.TAR">
|
||||||
distribution):</para>
|
<title>Normal procedure, for source extracted from a tar distribution)</title>
|
||||||
<screen>
|
|
||||||
<userinput>cd recoll-xxx</userinput>
|
<para>
|
||||||
<userinput>./configure</userinput>
|
<screen><userinput>cd recoll-xxx</userinput>
|
||||||
<userinput>make</userinput>
|
<userinput>./configure <replaceable>[options]</replaceable></userinput>
|
||||||
<userinput>(practices usual hardship-repelling invocations)</userinput>
|
<userinput>make</userinput>
|
||||||
</screen>
|
<userinput>(practices usual hardship-repelling invocations)</userinput></screen>
|
||||||
|
</para>
|
||||||
|
|
||||||
|
</sect3>
|
||||||
|
|
||||||
|
<sect3 id="RCL.INSTALL.BUILDING.BUILDING.GIT">
|
||||||
|
<title>Building from git code</title>
|
||||||
|
|
||||||
|
<para>When building from source cloned from the git repository,
|
||||||
|
you also need to install <application>autoconf</application>,
|
||||||
|
<application>automake</application>, and
|
||||||
|
<application>libtool</application> and you must execute
|
||||||
|
<literal>sh autogen.sh</literal> in the top source directory
|
||||||
|
before running <literal>configure</literal>.</para>
|
||||||
|
|
||||||
|
</sect3>
|
||||||
|
|
||||||
<para>When building from source cloned from the git repository,
|
|
||||||
you also need to install <application>autoconf</application>,
|
|
||||||
<application>automake</application>, and
|
|
||||||
<application>libtool</application> and you must execute
|
|
||||||
<literal>sh autogen.sh</literal> in the top source directory
|
|
||||||
before running <literal>configure</literal>.</para>
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="RCL.INSTALL.BUILDING.INSTALL">
|
<sect2 id="RCL.INSTALL.BUILDING.INSTALL">
|
||||||
|
|||||||
@ -12,8 +12,6 @@ DEFINES += BUILDING_RECOLLGUI
|
|||||||
@QMAKE_ENABLE_WEBENGINE@ DEFINES += USING_WEBENGINE
|
@QMAKE_ENABLE_WEBENGINE@ DEFINES += USING_WEBENGINE
|
||||||
|
|
||||||
QMAKE_CXXFLAGS += -std=c++11
|
QMAKE_CXXFLAGS += -std=c++11
|
||||||
QMAKE_LFLAGS_RELEASE -= -s
|
|
||||||
QMAKE_STRIP=echo
|
|
||||||
|
|
||||||
@QMAKE_ENABLE_ZEITGEIST@ QT += dbus
|
@QMAKE_ENABLE_ZEITGEIST@ QT += dbus
|
||||||
@QMAKE_ENABLE_ZEITGEIST@ QMAKE_CXXFLAGS += -DUSE_ZEITGEIST
|
@QMAKE_ENABLE_ZEITGEIST@ QMAKE_CXXFLAGS += -DUSE_ZEITGEIST
|
||||||
@ -24,7 +22,9 @@ greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport
|
|||||||
@QMAKE_ENABLE_WEBKIT@ greaterThan(QT_MAJOR_VERSION, 4): QT += webkitwidgets
|
@QMAKE_ENABLE_WEBKIT@ greaterThan(QT_MAJOR_VERSION, 4): QT += webkitwidgets
|
||||||
@QMAKE_ENABLE_WEBENGINE@ greaterThan(QT_MAJOR_VERSION, 4): QT += webenginewidgets
|
@QMAKE_ENABLE_WEBENGINE@ greaterThan(QT_MAJOR_VERSION, 4): QT += webenginewidgets
|
||||||
|
|
||||||
CONFIG += qt warn_on thread release
|
CONFIG += qt warn_on thread release
|
||||||
|
@QMAKE_ENABLE_GUIDEBUG@ CONFIG += force_debug_info
|
||||||
|
|
||||||
|
|
||||||
HEADERS += \
|
HEADERS += \
|
||||||
advsearch_w.h \
|
advsearch_w.h \
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user