diff --git a/src/Makefile.am b/src/Makefile.am
index 48d65582..8f08cd5c 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -552,11 +552,12 @@ install-data-hook:
chmod a+x rcl* ppt-dump.py xls-dump.py xlsxmltocsv.py hotrecoll.py; \
chmod 0644 msodump.zip rclexecm.py rcllatinstops.zip rclconfig.py)
+if MAKEUSERDOC
rdocdir = $(pkgdatadir)/doc
rdoc_DATA = doc/user/usermanual.html doc/user/docbook-xsl.css
-
-doc/user/usermanual.html:
+doc/user/usermanual.html: doc/user/usermanual.xml
$(MAKE) -C doc/user
+endif
dist_man1_MANS = doc/man/recoll.1 doc/man/recollq.1 doc/man/recollindex.1
dist_man5_MANS = doc/man/recoll.conf.5
diff --git a/src/configure.ac b/src/configure.ac
index 4c660e8d..e53a394b 100644
--- a/src/configure.ac
+++ b/src/configure.ac
@@ -364,9 +364,17 @@ XAPIANCXXFLAGS=`$XAPIAN_CONFIG --cxxflags`
AC_ARG_ENABLE(xadump,
AC_HELP_STRING([--enable-xadump],
[Enable building the xadump low level Xapian access program.]),
- enableQT=$enableval, enableXADUMP="no")
+ enableXADUMP=$enableval, enableXADUMP="no")
AM_CONDITIONAL(MAKEXADUMP, [test X$enableXADUMP = Xyes])
+AC_ARG_ENABLE(userdoc,
+ AC_HELP_STRING([--disable-userdoc],
+ [Disable building the user manual. (Avoids the need for docbook xml/xsl files and TeX tools.]),
+ enableUserdoc=$enableval, enableUserdoc="yes")
+AM_CONDITIONAL(MAKEUSERDOC, [test X$enableUserdoc = Xyes])
+
+
+
#### QT
# The way qt and its tools (qmake especially) are installed is very
# different between systems (and maybe qt versions)
diff --git a/src/doc/user/usermanual.xml b/src/doc/user/usermanual.xml
index 51e9c350..b382bc3b 100644
--- a/src/doc/user/usermanual.xml
+++ b/src/doc/user/usermanual.xml
@@ -4872,11 +4872,28 @@ except:
The shopping list:
+ The autoconf,
+ automake and libtool
+ triad. Only autoconf is needed up to &RCL;
+ 1.21.
+
C++ compiler. Up to &RCL; version 1.13.04,
its absence can manifest itself by strange messages
about a missing iconv_open.
+ bison command (for &RCL; 1.21
+ and later).
+
+
+ xsltproc command. For building
+ the documentation (for &RCL; 1.21
+ and later). This sometimes comes with the
+ libxslt package. And also the Docbook XML and
+ style sheet files.
+
+
+
Development files
for Xapian
core.
@@ -4907,6 +4924,11 @@ except:
zlib.
+
+ Development files for Python (or use
+ --disable-python-module).
+
+
You may also need
@@ -5009,11 +5031,17 @@ except:
Qt and
X11.
- will compile
- &RCL; with position-dependant code. This is incompatible with
- building the KIO or the Python
- or PHP extensions, but might
- yield very marginally faster code.
+
+ will avoid building the user manual. This avoids having to
+ install the Docbook XML/XSL files and the TeX toolchain used for
+ translating the manual to PDF.
+
+ (&RCL; versions up
+ to 1.21 only) will compile
+ &RCL; with position-dependant code. This is incompatible with
+ building the KIO or the Python
+ or PHP extensions, but might
+ yield very marginally faster code.Of course the usual
autoconfconfigure
@@ -5023,7 +5051,8 @@ except:
- Normal procedure:
+ Normal procedure (for source extracted from a tar
+ distribution):cd recoll-xxx./configure
@@ -5031,15 +5060,12 @@ except:
(practices usual hardship-repelling invocations)
-
- There is little auto-configuration. The
- configure script will mainly link one of
- the system-specific files in the mk
- directory to mk/sysconf. If your system
- is not known yet, it will tell you as much, and you may want
- to manually copy and modify one of the existing files (the new
- file name should be the output of uname
- ).
+ When building from source cloned from the BitBucket repository,
+ you also need to install autoconf,
+ automake, and
+ libtool and you must execute sh
+ autogen.sh in the top source directory before running
+ configure.Building on Solaris