Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man1top |lang=en |rev=1.0.6 |Title=5. Configure Options |prev=Man 1 ch02s04 |Subtitle=Chapter II. Installing Bluefish |next=Man 1 ch0…'

2009-08-19T13:15:38Z

Created page with '__NOTOC__ __NOEDITSECTION__ {{Man1top |lang=en |rev=1.0.6 |Title=5. Configure Options |prev=Man 1 ch02s04 |Subtitle=Chapter II. Installing Bluefish |next=Man 1 ch0…'

New page

__NOTOC__
__NOEDITSECTION__
{{Man1top
|lang=en
|rev=1.0.6
|Title=5. Configure Options
|prev=Man 1 ch02s04
|Subtitle=Chapter II. Installing Bluefish
|next=Man 1 ch02s06
}}
== 5. Configure Options ==
<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.

=== 5.1. Standard configuration flags ===
'''Configuration:'''
*<tt>-h--help</tt>
display this help and exit
*<tt>--help=short</tt>
display options specific to this package
*<tt>--help=recursive</tt>
display the short help of all the included packages
*<tt>-V--version</tt>
display version information and exit
*<tt>-q--quiet--silent</tt>
do not print "checking..." messages
*<tt>--cache-file=FILE</tt>
<nowiki>cache test results in FILE [disabled by default]</nowiki>
*<tt>-C--config-cache</tt>
alias for <tt>--cache-file=config.cache</tt>
*<tt>-n--no-create</tt>
do not create output files
*<tt>--srcdir=DIR</tt>
<nowiki>find the sources in DIR [configure dir or </nowiki>.. by default]

'''Installation directories:'''

[[File:Man1_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>.
*<tt>--prefix=PREFIX</tt>
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]
*<tt>--exec-prefix=EPREFIX</tt>
<nowiki>install architecture-dependent files in EPREFIX [</nowiki>PREFIX by default]

'''Fine tuning of the installation directories:'''

[[File:Man1_tip.png]] For better control, use the options below. Defaults are shown within brackets.

*<tt>--bindir=DIR</tt>
<nowiki>user executables [</nowiki>EPREFIX/bin]
*<tt>--sbindir=DIR</tt>
<nowiki>system admin executables [</nowiki>EPREFIX/sbin]
*<tt>--libexecdir=DIR</tt>
<nowiki>program executables [[Man 1 </nowiki>EPREFIX/libexec]]
*<tt>--datadir=DIR</tt>
<nowiki>read-only architecture-independent data [</nowiki>PREFIX/share]
*<tt>--sysconfdir=DIR</tt>
<nowiki>read-only single-machine data [</nowiki>PREFIX/etc]
*<tt>--sharedstatedir=DIR</tt>
<nowiki>modifiable architecture-independent data [</nowiki>PREFIX/com]
*<tt>--localstatedir=DIR</tt>
<nowiki>modifiable single-machine data [</nowiki>PREFIX/var]
*<tt>--libdir=DIR</tt>
<nowiki>object code libraries [[Man 1 </nowiki>EPREFIX/lib]]
*<tt>--includedir=DIR</tt>
<nowiki>C header files [[Man 1 </nowiki>PREFIX/include]]
*<tt>--oldincludedir=DIR</tt>
<nowiki>C header files for non-gcc [</nowiki>/usr/include]
*<tt>--infodir=DIR</tt>
<nowiki>info documentation [</nowiki>PREFIX/info]
*<tt>--mandir=DIR</tt>
<nowiki>man documentation [</nowiki>PREFIX/man]

'''Program names:'''
*<tt>--program-prefix=PREFIX</tt>
prepend PREFIX to installed program names
*<tt>--program-suffix=SUFFIX</tt>
append SUFFIX to installed program names
*<tt>--program-transform-name=PROGRAM</tt>
run sed PROGRAM on installed program names

'''System types:'''
*<tt>--build=BUILD</tt>
<nowiki>configure for building on BUILD [guessed]</nowiki>
*<tt>--host=HOST</tt>
<nowiki>cross-compile to build programs to run on HOST [BUILD]</nowiki>

'''Some influential environment variables:'''

[[File:Man1_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.

*<tt>CC</tt>
C compiler command
*<tt>CFLAGS</tt>
C compiler flags
*<tt>LDFLAGS</tt>
<nowiki>linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir></nowiki>
*<tt>CPPFLAGS</tt>
<nowiki>C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir></nowiki>
*<tt>CPP</tt>
C preprocessor

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

[[File:Man1_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.

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.

*<tt>--enable-auto-optimization</tt>
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

*<tt>--enable-gcc3-optimization=type</tt>
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

*<tt>--enable-gcc2-optimization=type</tt>
optimizes the build process for a given architecture if possible

Machines: i386, i486, pentium, pentiumpro, k6

Other machines are ignored

*<tt>--enable-debugging-output</tt>
turns debugging output on (this option impacts performance)
*<tt>--disable-splash-screen</tt>
suppresses the display of the splash screen at launch time (Bluefish launches faster)
*<tt>--enable-highlight-profiling</tt>
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
*<tt>--enable-development</tt>
enables development checks (slows down the program)
*<tt>--enable-gprof-profiling</tt>
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)
*<tt>--enable-gcoc-coverage</tt>
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)
*<tt>--disable-update-databases</tt>
do not run the update-desktop-database or update-mime-database utilities after installation (mostly useful for package maintainers)
*<tt>--disable-nls</tt>
disables the Native Language Support (might speed up the program)

'''Optional Packages:'''

[[File:Man1_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.
*<tt>--without-libgnomeui</tt>
disable libgnomeui detection
*<tt>--with-gnome1-menu</tt>
customized path for the gnome1 menu (disabled by default)

Usage: <tt>--with-gnome1-menu=customizedpath</tt> or <tt>--without-gnome1-menu</tt>
disabled by default
*<tt>--with-freedesktop_org-menu</tt>
customized path for the freedesktop.org (gnome and kde) menu

Usage: <tt>--with-freedesktop_org-menu=customizedpath</tt> or <tt>--without-freedesktop_org-menu</tt>
defaults to auto-detection, which tries:

* /usr/share/applications
* PREFIX/share/applications
* /usr/X11R6/share/gnome/applications
* PREFIX/share/gnome/applications

*<tt>--with-freedesktop_org-mime</tt>
customized path for the freedesktop.org (gnome and kde) mime

Usage: <tt>--with-freedesktop_org-mime=customizedpath</tt> or <tt>--without-freedesktop_org-mime</tt>

defaults to auto-detection, which tries:

* /usr/share/mime
* PREFIX/share/mime
* /usr/X11R6/share/gnome/mime
* PREFIX/share/gnome/mime

*<tt>--with-gnome2_4-mime</tt>
customized path for the gnome 2.4 mime

Usage: <tt>--with-gnome2_4-mime=customizedpath</tt> or <tt>--without-gnome2_4-mime</tt>
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

*<tt>--with-gnome2_4-appreg</tt>
customized path for the gnome 2.4 application registry

Usage: <tt>--with-gnome2_4-appreg=customizedpath</tt> or <tt>--without-gnome2_4-appreg</tt>
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

*<tt>--with-icon-path</tt>
customized path for the icon.

Usage: <tt>--with-icon-path=customizedpath</tt> or <tt>--without-icon-path</tt>
defaults to auto-detection, which tries:

* /usr/share/pixmaps
* PREFIX/share/pixmaps
* /usr/X11R6/share/gnome/pixmaps
* PREFIX/share/gnome/pixmaps

*<tt>--with-libiconv-prefix</tt>
customized path for libiconv top level installation.

Usage: <tt>--with-libiconv-prefix=customizeddir</tt>

Effect: searches for libiconv in customizeddir/include and customizeddir/lib
*<tt>--with-included-gettext</tt>

use the GNU gettext library included in the package

'''Features specific to the CVS version:'''
*<tt>--enable-unstable-install</tt>
enable the installation of a bluefish development version with independent directories and files. Use this for CVS snapshots
*<tt>--enable-scanner</tt>
use the BfTextView scanner for editor widget
*<tt>--disable-python</tt>
do not build the python plugin
*<tt>--with-theme-path</tt>
customized path for the theme icons.

Usage: <tt>--with-theme-path=customizedpath</tt> or <tt>--without-theme-path</tt>
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

{{Man1bottom
|prev=Man 1 ch02s04
|up=Man 1 ch02
|next=Man 1 ch02s06
|prevname= 4. Installing a Bluefish Source Distribution
|nextname=6. Installing a Binary Distribution
}}

Man 1 ch02s05 - Revision history

Fal7i: Created page with '__NOTOC__ __NOEDITSECTION__ {{Man1top |lang=en |rev=1.0.6 |Title=5. Configure Options |prev=Man 1 ch02s04 |Subtitle=Chapter II. Installing Bluefish |next=Man 1 ch0…'

Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man1top |lang=en |rev=1.0.6 |Title=5. Configure Options |prev=Man 1 ch02s04 |Subtitle=Chapter II. Installing Bluefish |next=Man 1 ch0…'