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 autoconf configure @@ -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