From AbiWiki

Revision as of 01:37, 18 November 2010

>If you are building from SVN, you must first create the configure program by running <code>./autogen.sh</code> in the "abiword" directory. For this to succeed, you need to have the GNU "auto-tools" toolchain installed, including as autoconf, autoheader, and automake. On Debian based Linux distributions, this is as easy as:

sudo apt-get install autoconf

AbiWord has many compile options. All options given to "autogen.sh" are passed through the to the "configure" command. A list of the available commands for configure can be obtained by typing:

./configure --help

The output of that is shown below.

`configure' configures libabiword 2.7.0 to adapt to many kinds of systems.

Usage:

../abiword/configure [OPTION]... [VAR=VALUE]...

To assign environment variables (e.g., CC, CFLAGS...), specify them as VAR=VALUE. See below for descriptions of some of the useful variables.

A particularly useful configure parameter is "--enable-dynamic". If you need to do this to enable plugins to load. An example: ../abiword/configure --enable-debug --enable-plugins="collab mathview command" --prefix=/home/msevior/abidir --enable-dynamic

Defaults for the options are specified in brackets.

Configuration:

 -h, --help              display this help and exit
     --help=short        display options specific to this package
     --help=recursive    display the short help of all the included packages
 -V, --version           display version information and exit
 -q, --quiet, --silent   do not print `checking...' messages
     --cache-file=FILE   cache test results in FILE [disabled]
 -C, --config-cache      alias for `--cache-file=config.cache'
 -n, --no-create         do not create output files
     --srcdir=DIR        find the sources in DIR [configure dir or `..']

Installation directories:

 --prefix=PREFIX         install architecture-independent files in PREFIX
                         [/usr/local]
 --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
                         [PREFIX]

By default, `make install' will install all the files in `/usr/local/bin', `/usr/local/lib' etc. You can specify an installation prefix other than `/usr/local' using `--prefix', for instance `--prefix=$HOME'.

For better control, use the options below.

Fine tuning of the installation directories:

 --bindir=DIR           user executables [EPREFIX/bin]
 --sbindir=DIR          system admin executables [EPREFIX/sbin]
 --libexecdir=DIR       program executables [EPREFIX/libexec]
 --sysconfdir=DIR       read-only single-machine data [PREFIX/etc]
 --sharedstatedir=DIR   modifiable architecture-independent data [PREFIX/com]
 --localstatedir=DIR    modifiable single-machine data [PREFIX/var]
 --libdir=DIR           object code libraries [EPREFIX/lib]
 --includedir=DIR       C header files [PREFIX/include]
 --oldincludedir=DIR    C header files for non-gcc [/usr/include]
 --datarootdir=DIR      read-only arch.-independent data root [PREFIX/share]
 --datadir=DIR          read-only architecture-independent data [DATAROOTDIR]
 --infodir=DIR          info documentation [DATAROOTDIR/info]
 --localedir=DIR        locale-dependent data [DATAROOTDIR/locale]
 --mandir=DIR           man documentation [DATAROOTDIR/man]
 --docdir=DIR           documentation root [DATAROOTDIR/doc/libabiword]
 --htmldir=DIR          html documentation [DOCDIR]
 --dvidir=DIR           dvi documentation [DOCDIR]
 --pdfdir=DIR           pdf documentation [DOCDIR]
 --psdir=DIR            ps documentation [DOCDIR]

Program names:

 --program-prefix=PREFIX            prepend PREFIX to installed program names
 --program-suffix=SUFFIX            append SUFFIX to installed program names
 --program-transform-name=PROGRAM   run sed PROGRAM on installed program names

System types:

 --build=BUILD     configure for building on BUILD [guessed]
 --host=HOST       cross-compile to build programs to run on HOST [BUILD]
 --target=TARGET   configure for building compilers for TARGET [HOST]

Optional Features:

 --disable-FEATURE       do not include FEATURE (same as --enable-FEATURE=no)
 --enable-FEATURE[=ARG]  include FEATURE [ARG=yes]
 --disable-dependency-tracking  speeds up one-time build
 --enable-dependency-tracking   do not reject slow dependency extractors
 --enable-shared[=PKGS]  build shared libraries [default=yes]
 --enable-static[=PKGS]  build static libraries [default=yes]
 --enable-fast-install[=PKGS]
                         optimize for fast installation [default=yes]
 --disable-libtool-lock  avoid locking (might break parallel builds)
 --disable-default-plugins
                         do not build any plugins by default
 --enable-plugins        ="foo bar baz", list of plugins to build
 --enable-menubutton     (gtk only) menu-button instead of menu-bar
 --disable-print         (gtk only) do not include printing support
 --disable-spell         (gtk only) do not include spell checking support
 --disable-statusbar     (gtk only) do not include status bar
 --enable-embedded       =generic|hildon|poky, (gtk only), build for embedded
                         platform
 --enable-debug          Enable debugging functionality, verbose terminal
                         output
 --enable-collab-backend-fake
                         Fake backend for debugging purposes only (default:
                         off)
 --enable-collab-backend-xmpp
                         Jabber backend (default: auto)
 --enable-collab-backend-tcp
                         TCP backend (default: auto)
 --enable-collab-backend-sugar
                         Sugar/OLPC backend (default: auto)
 --enable-collab-backend-service
                         collaborate.abisource.com backend (default: off)
 --enable-collab-record-always
                         Always record AbiCollab sessions (default: off)

Optional Packages:

 --with-PACKAGE[=ARG]    use PACKAGE [ARG=yes]
 --without-PACKAGE       do not use PACKAGE (same as --with-PACKAGE=no)
 --with-gnu-ld           assume the C compiler uses GNU ld [default=no]
 --with-pic              try to use only PIC/non-PIC objects [default=use
                         both]
 --with-tags[=TAGS]      include additional configurations [automatic]
 --with-gnomeui          (gtk only) use libgnomeui library
 --with-gnomevfs         (gtk only) use gnome-vfs library
 --with-goffice          (gtk only) use goffice library
 --with-gucharmap        (gtk only) use gucharmap library
 --with-inter7eps        MHT plugin: support multipart html using the inter7
                         EPS library
 --with-libtidy          MHT plugin: clean up HTML before importing using
                         libtidy
 --with-boost[=DIR]      use boost (default is yes) - it is possible to
                         specify the root directory for boost (optional)
 --with-boost-thread[=special-lib]
                         use the Thread library from boost - it is possible
                         to specify a certain library for the linker e.g.
                         --with-boost-thread=boost_thread-gcc-mt
 --with-psiconv-config=DIR
                         use psiconv-config in DIR
 --with-libwmf-config=DIR
                         use libwmf-config in DIR

Some influential environment variables:

 CC          C compiler command
 CFLAGS      C compiler flags
 LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
             nonstandard directory <lib dir>
 LIBS        libraries to pass to the linker, e.g. -l<library>
 CPPFLAGS    C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
             you have headers in a nonstandard directory <include dir>
 CXX         C++ compiler command
 CXXFLAGS    C++ compiler flags
 OBJC        Objective C compiler command
 OBJCFLAGS   Objective C compiler flags
 CPP         C preprocessor
 CXXCPP      C++ preprocessor
 F77         Fortran 77 compiler command
 FFLAGS      Fortran 77 compiler flags
 PKG_CONFIG  path to pkg-config utility
 DEPS_CFLAGS C compiler flags for DEPS, overriding pkg-config
 DEPS_LIBS   linker flags for DEPS, overriding pkg-config
 PLUGIN_CFLAGS
             C compiler flags for PLUGIN, overriding pkg-config
 PLUGIN_LIBS linker flags for PLUGIN, overriding pkg-config
 MHT_CFLAGS  C compiler flags for MHT, overriding pkg-config
 MHT_LIBS    linker flags for MHT, overriding pkg-config
 T602_CFLAGS C compiler flags for T602, overriding pkg-config
 T602_LIBS   linker flags for T602, overriding pkg-config
 XSLFO_CFLAGS
             C compiler flags for XSLFO, overriding pkg-config
 XSLFO_LIBS  linker flags for XSLFO, overriding pkg-config
 HANCOM_CFLAGS
             C compiler flags for HANCOM, overriding pkg-config
 HANCOM_LIBS linker flags for HANCOM, overriding pkg-config
 OPENWRITER_CFLAGS
             C compiler flags for OPENWRITER, overriding pkg-config
 OPENWRITER_LIBS
             linker flags for OPENWRITER, overriding pkg-config
 OPENXML_CFLAGS
             C compiler flags for OPENXML, overriding pkg-config
 OPENXML_LIBS
             linker flags for OPENXML, overriding pkg-config
 DOCBOOK_CFLAGS
             C compiler flags for DOCBOOK, overriding pkg-config
 DOCBOOK_LIBS
             linker flags for DOCBOOK, overriding pkg-config
 RSVG_CFLAGS C compiler flags for RSVG, overriding pkg-config
 RSVG_LIBS   linker flags for RSVG, overriding pkg-config
 PDB_CFLAGS  C compiler flags for PDB, overriding pkg-config
 PDB_LIBS    linker flags for PDB, overriding pkg-config
 KWORD_CFLAGS
             C compiler flags for KWORD, overriding pkg-config
 KWORD_LIBS  linker flags for KWORD, overriding pkg-config
 WORDPERFECT_CFLAGS
             C compiler flags for WORDPERFECT, overriding pkg-config
 WORDPERFECT_LIBS
             linker flags for WORDPERFECT, overriding pkg-config
 COLLAB_CFLAGS
             C compiler flags for COLLAB, overriding pkg-config
 COLLAB_LIBS linker flags for COLLAB, overriding pkg-config
 COMMAND_CFLAGS
             C compiler flags for COMMAND, overriding pkg-config
 COMMAND_LIBS
             linker flags for COMMAND, overriding pkg-config
 AIKSAURUS_CFLAGS
             C compiler flags for AIKSAURUS, overriding pkg-config
 AIKSAURUS_LIBS
             linker flags for AIKSAURUS, overriding pkg-config
 AIKSAURUS_GTK_CFLAGS
             C compiler flags for AIKSAURUS_GTK, overriding pkg-config
 AIKSAURUS_GTK_LIBS
             linker flags for AIKSAURUS_GTK, overriding pkg-config
 OTS_CFLAGS  C compiler flags for OTS, overriding pkg-config
 OTS_LIBS    linker flags for OTS, overriding pkg-config
 WML_CFLAGS  C compiler flags for WML, overriding pkg-config
 WML_LIBS    linker flags for WML, overriding pkg-config
 OPENDOCUMENT_CFLAGS
             C compiler flags for OPENDOCUMENT, overriding pkg-config
 OPENDOCUMENT_LIBS
             linker flags for OPENDOCUMENT, overriding pkg-config
 CLARISWORKS_CFLAGS
             C compiler flags for CLARISWORKS, overriding pkg-config
 CLARISWORKS_LIBS
             linker flags for CLARISWORKS, overriding pkg-config
 SDW_CFLAGS  C compiler flags for SDW, overriding pkg-config
 SDW_LIBS    linker flags for SDW, overriding pkg-config
 LOADBINDINGS_CFLAGS
             C compiler flags for LOADBINDINGS, overriding pkg-config
 LOADBINDINGS_LIBS
             linker flags for LOADBINDINGS, overriding pkg-config
 APPLIX_CFLAGS
             C compiler flags for APPLIX, overriding pkg-config
 APPLIX_LIBS linker flags for APPLIX, overriding pkg-config
 GOFFICE_CFLAGS
             C compiler flags for GOFFICE, overriding pkg-config
 GOFFICE_LIBS
             linker flags for GOFFICE, overriding pkg-config
 GDA_CFLAGS  C compiler flags for GDA, overriding pkg-config
 GDA_LIBS    linker flags for GDA, overriding pkg-config
 MSWRITE_CFLAGS
             C compiler flags for MSWRITE, overriding pkg-config
 MSWRITE_LIBS
             linker flags for MSWRITE, overriding pkg-config
 WPGGFX_CFLAGS
             C compiler flags for WPGGFX, overriding pkg-config
 WPGGFX_LIBS linker flags for WPGGFX, overriding pkg-config
 YACC        The `Yet Another C Compiler' implementation to use. Defaults to
             the first program found out of: `bison -y', `byacc', `yacc'.
 YFLAGS      The list of arguments that will be passed by default to $YACC.
             This script will default YFLAGS to the empty string to avoid a
             default value of `-d' given by some make applications.
 MATHVIEW_CFLAGS
             C compiler flags for MATHVIEW, overriding pkg-config
 MATHVIEW_LIBS
             linker flags for MATHVIEW, overriding pkg-config
 PRESENTATION_CFLAGS
             C compiler flags for PRESENTATION, overriding pkg-config
 PRESENTATION_LIBS
             linker flags for PRESENTATION, overriding pkg-config
 PDF_CFLAGS  C compiler flags for PDF, overriding pkg-config
 PDF_LIBS    linker flags for PDF, overriding pkg-config
 GRAMMAR_CFLAGS
             C compiler flags for GRAMMAR, overriding pkg-config
 GRAMMAR_LIBS
             linker flags for GRAMMAR, overriding pkg-config

Use these variables to override the choices made by `configure' or to help it to find libraries and programs with nonstandard names/locations.

Report bugs to <http://bugzilla.abisource.com/>