Difference between revisions of "Installing Bluefish - Install from Source Code Options"

From Bluefish Wiki
Jump to: navigation, 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…')
 
m
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 11:15, 31 December 2009

Man2 warning.png This page is a copy from Manual 1. It needs to be modified to match Bluefish version 2.0.0!
Once you have verified this page (and corrected if necessary),

please modify the status to u (updated), i.e. st=u (see Guidelines for Writing this Manual)


Man2 icon 48.png
Chapter II. Installing Bluefish
Prev 
5. Configure Options
 Next
 

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.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 --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.png 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.png 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.png 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