Man 1 ch02s05

From Bluefish Wiki
Jump to navigation Jump to search


Please consider to upgrade to Bluefish 2!

Please consider to edit the Manual 2!

How To edit the Wiki Manual
{{#if:5. Configure Options|
5. Configure Options
}}
Prev }}
Chapter II. Installing Bluefish
}}
 Next
}}

5. 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:

  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:


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


Prev }}
Up
}}
 Next
}}
4. Installing a Bluefish Source Distribution}}
Home | ToC
 6. Installing a Binary Distribution
}}