Man 1 ch02s05
Please consider to edit the Manual 2!
How To edit the Wiki Manual5. Configure Options
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:
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:
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 [[Man 1 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 [[Man 1 EPREFIX/lib]]
- --includedir=DIR
C header files [[Man 1 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:
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:
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:
- uname -p or grep "model name" /proc/cpuinfo | cut -d: -f2 to detect the architecture
- 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:
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