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

From Bluefish Wiki
Jump to navigation Jump to search
m (Created page with '__NOTOC__ __NOEDITSECTION__ {{Man2top |lang=en |rev=2.0.0 |st=d |Title=5. Configure Options |prev=Man 2 ch02s04 |Subtitle=Chapter II. Installing Bluefish |next=Man…')
 
mNo edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
__NOEDITSECTION__
{{Man2top
{{Man2top
|lang=en
|lang=en
Line 10: Line 9:
|next=Man 2 ch02s06
|next=Man 2 ch02s06
}}
}}
== 5. Configure Options ==
{{toc}}
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;">
*[[#5.1. Standard configuration flags|5.1. Standard configuration flags]]
*[[#5.2. Flags personal to bluefish|5.2. Flags personal to bluefish]]
</div>
This section describes all the configure options available for bluefish.
This section describes all the configure options available for bluefish.


=== 5.1. Standard configuration flags ===
== 5.1. Standard configuration flags ==
'''Configuration:'''
'''Configuration:'''
*<tt>-h--help</tt>  
*<tt>-h--help</tt>  
Line 40: Line 35:
'''Installation directories:'''
'''Installation directories:'''


[[File:Man2_tip.png]] 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 <tt>--prefix</tt>, for instance <tt>--prefix=$HOME</tt>.
{{tip|text=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 <tt>--prefix</tt>, for instance <tt>--prefix=$HOME</tt>}}.
*<tt>--prefix=PREFIX</tt>  
*<tt>--prefix=PREFIX</tt>  
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]
Line 48: Line 43:
'''Fine tuning of the installation directories:'''
'''Fine tuning of the installation directories:'''


[[File:Man2_tip.png]] For better control, use the options below. Defaults are shown within brackets.
{{tip|text=For better control, use the options below. Defaults are shown within brackets.}}


*<tt>--bindir=DIR</tt>  
*<tt>--bindir=DIR</tt>  
Line 105: Line 100:
C preprocessor
C preprocessor


=== 5.2. Flags personal to bluefish ===
== 5.2. Flags personal to bluefish ==
'''Optional Features:'''
'''Optional Features:'''




[[File:Man2_note.png]] These work like this: <tt>--enable-feature</tt> enables the feature, <tt>--disable-feature</tt> or <tt>--enable-feature=no</tt> disables the feature.
{{note|text=These work like this: <tt>--enable-feature</tt> enables the feature, <tt>--disable-feature</tt> or <tt>--enable-feature=no</tt> disables the feature.}}


By default, the <tt>--enable-feature</tt> option is not enabled, you should pass it if you want to get it, the <tt>--disable-xxx</tt> option is not disabled, you should pass it if you want to disable it.
By default, the <tt>--enable-feature</tt> option is not enabled, you should pass it if you want to get it, the <tt>--disable-xxx</tt> option is not disabled, you should pass it if you want to disable it.
Line 163: Line 158:




[[File:Man2_note.png]] These work like this: <tt>--with-xxx=foo</tt> enables the flag, <tt>--without-xxx</tt> disables it. When not enabled, the default is used.
{{note|text=These work like this: <tt>--with-xxx=foo</tt> enables the flag, <tt>--without-xxx</tt> disables it. When not enabled, the default is used.}}
*<tt>--without-libgnomeui</tt>  
*<tt>--without-libgnomeui</tt>  
disable libgnomeui detection
disable libgnomeui detection

Revision as of 10:15, 31 December 2009


 

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:

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

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