5. Configure Options

5.1. Standard configuration flags
5.2. Flags personal to bluefish

This section describes all the configure options available for bluefish.

5.1. Standard configuration flags

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 by default]

-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 .. by default]

Installation directories:

[Tip]

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.

--prefix=PREFIX

install architecture-independent files in PREFIX [/usr/local by default]

--exec-prefix=EPREFIX

install architecture-dependent files in EPREFIX [PREFIX by default]

Fine tuning of the installation directories:

[Tip]

For better control, use the options below. Defaults are shown within brackets.

--bindir=DIR

user executables [EPREFIX/bin]

--sbindir=DIR

system admin executables [EPREFIX/sbin]

--libexecdir=DIR

program executables [EPREFIX/libexec]

--datadir=DIR

read-only architecture-independent data [PREFIX/share]

--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]

--infodir=DIR

info documentation [PREFIX/info]

--mandir=DIR

man documentation [PREFIX/man]

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]

Some influential environment variables:

[Tip]

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

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>

CPPFLAGS

C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir>

CPP

C preprocessor

5.2. Flags personal to bluefish

Optional Features:

[Note]

These work like this: --enable-feature enables the feature, --disable-feature or --enable-feature=no disables the feature.

By default, the --enable-feature option is not enabled, you should pass it if you want to get it, the --disable-xxx option is not disabled, you should pass it if you want to disable it.

--enable-auto-optimization

Optimizes the build process for a given architecture if possible. It works only on a selected set of x86 platforms.

How: rely on the result of:

  1. uname -p or grep "model name" /proc/cpuinfo | cut -d: -f2 to detect the architecture

  2. the version of gcc to pass the arguments

Tested gcc versions: 3.2.*, 3.0.*, 2.95.*

Machines: Intel(R) Pentium(R) 4CPU, Pentium III, AMD-K6 (tm) 3D, Pentium 75 - 200, Pentium II, AMD Athlon(TM) XP

Other machines are ignored

--enable-gcc3-optimization=type

optimizes the build process for a given architecture if possible

Machines: i386, i486, pentium, pentium-mmx, pentiumpro, pentium2, pentium3, pentium4, k6, k6-2, k6-3, athlon, athlon-tbird, athlon-4, athlon-xp, athlon-mp, winchip-c6, winchip2, c3

Other machines are ignored

--enable-gcc2-optimization=type

optimizes the build process for a given architecture if possible

Machines: i386, i486, pentium, pentiumpro, k6

Other machines are ignored

--enable-debugging-output

turns debugging output on (this option impacts performance)

--disable-splash-screen

suppresses the display of the splash screen at launch time (Bluefish launches faster)

--enable-highlight-profiling

outputs statistics on where the program spends most of its time when highlighting patterns

Usage: for debugging highlight patterns or trying to optimize the program

--enable-development

enables development checks (slows down the program)

--enable-gprof-profiling

outputs statistics on where the program spends most of its time by generating extra code to write profile information suitable for the analysis (slows down the program)

--enable-gcoc-coverage

Purpose: to be able to collect statistics on how many times each branch is executed and how long it has lasted. Creates data files for the gcov code-coverage utility (slows down the program)

--disable-update-databases

do not run the update-desktop-database or update-mime-database utilities after installation (mostly useful for package maintainers)

--disable-nls

disables the Native Language Support (might speed up the program)

Optional Packages:

[Note]

These work like this: --with-xxx=foo enables the flag, --without-xxx disables it. When not enabled, the default is used.

--without-libgnomeui

disable libgnomeui detection

--with-gnome1-menu

customized path for the gnome1 menu (disabled by default)

Usage: --with-gnome1-menu=customizedpath or --without-gnome1-menu

disabled by default

--with-freedesktop_org-menu

customized path for the freedesktop.org (gnome and kde) menu

Usage: --with-freedesktop_org-menu=customizedpath or --without-freedesktop_org-menu

defaults to auto-detection, which tries:

  • /usr/share/applications

  • PREFIX/share/applications

  • /usr/X11R6/share/gnome/applications

  • PREFIX/share/gnome/applications

--with-freedesktop_org-mime

customized path for the freedesktop.org (gnome and kde) mime

Usage: --with-freedesktop_org-mime=customizedpath or --without-freedesktop_org-mime

defaults to auto-detection, which tries:

  • /usr/share/mime

  • PREFIX/share/mime

  • /usr/X11R6/share/gnome/mime

  • PREFIX/share/gnome/mime

--with-gnome2_4-mime

customized path for the gnome 2.4 mime

Usage: --with-gnome2_4-mime=customizedpath or --without-gnome2_4-mime

defaults to auto-detection, which tries:

  • /usr/share/mime-info

  • PREFIX/share/mime-info

  • /usr/X11R6/share/gnome/mime-info

  • PREFIX/share/gnome/mime-info

--with-gnome2_4-appreg

customized path for the gnome 2.4 application registry

Usage: --with-gnome2_4-appreg=customizedpath or --without-gnome2_4-appreg

defaults to auto-detection, which tries:

  • /usr/share/application-registry

  • PREFIX/share/application-registry

  • /usr/X11R6/share/gnome/application-registry

  • PREFIX/share/gnome/application-registry

--with-icon-path

customized path for the icon.

Usage: --with-icon-path=customizedpath or --without-icon-path

defaults to auto-detection, which tries:

  • /usr/share/pixmaps

  • PREFIX/share/pixmaps

  • /usr/X11R6/share/gnome/pixmaps

  • PREFIX/share/gnome/pixmaps

--with-libiconv-prefix

customized path for libiconv top level installation.

Usage: --with-libiconv-prefix=customizeddir

Effect: searches for libiconv in customizeddir/include and customizeddir/lib

--with-included-gettext

use the GNU gettext library included in the package

Features specific to the CVS version:

--enable-unstable-install

enable the installation of a bluefish development version with independent directories and files. Use this for CVS snapshots

--enable-scanner

use the BfTextView scanner for editor widget

--disable-python

do not build the python plugin

--with-theme-path

customized path for the theme icons.

Usage: --with-theme-path=customizedpath or --without-theme-path

defaults to auto-detection, which tries:

  • /usr/share/icons/hicolor

  • PREFIX/share/icons/hicolor

  • /usr/X11R6/share/gnome/icons/hicolor

  • PREFIX/share/gnome/icons/hicolor