Installing Bluefish - Install from Source Code Options: Difference between revisions

From Bluefish Wiki
Jump to navigation Jump to search
mNo edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 11: Line 11:
{{toc}}
{{toc}}
This section describes all the configure options available for bluefish.
This section describes all the configure options available for bluefish.
{{note|text=This page has not been checked if it's uptodate. It is likely that all options are still being used. To test all, would take a lot of time. In case you encounter any problem with the options listed here, please contact us on the developers mailing list or via the [https://sourceforge.net/p/bluefish/tickets/ ticket system].}}


== 5.1. Standard configuration flags ==
== 5.1. Standard configuration flags ==

Latest revision as of 17:02, 22 December 2022


 

This section describes all the configure options available for bluefish.

Man2 note.gif This page has not been checked if it's uptodate. It is likely that all options are still being used. To test all, would take a lot of time. In case you encounter any problem with the options listed here, please contact us on the developers mailing list or via the ticket system.

5.1. Standard configuration flags[edit]

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:

Man2 tip.gif 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:

Man2 tip.gif 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 2 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 2 EPREFIX/lib]]

  • --includedir=DIR

C header files [[Man 2 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:


Man2 tip.png 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[edit]

Optional Features:


Man2 note.gif 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:


Man2 note.gif 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