https://bfwiki.tellefsen.net//index.php?title=Man_1_ch02s05&feed=atom&action=historyMan 1 ch02s05 - Revision history2024-03-29T15:12:19ZRevision history for this page on the wikiMediaWiki 1.38.2https://bfwiki.tellefsen.net//index.php?title=Man_1_ch02s05&diff=138&oldid=prevFal7i: 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<p>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…'</p>
<p><b>New page</b></p><div>__NOTOC__<br />
__NOEDITSECTION__<br />
{{Man1top<br />
|lang=en<br />
|rev=1.0.6<br />
|Title=5.&nbsp;Configure Options<br />
|prev=Man 1 ch02s04<br />
|Subtitle=Chapter&nbsp;II.&nbsp;Installing Bluefish<br />
|next=Man 1 ch02s06<br />
}}<br />
== 5. Configure Options ==<br />
<div style="float:right; background-color:#E5ECF9;border:1px solid #3061C2;"><br />
*[[#5.1. Standard configuration flags|5.1. Standard configuration flags]] <br />
*[[#5.2. Flags personal to bluefish|5.2. Flags personal to bluefish]] <br />
</div><br />
This section describes all the configure options available for bluefish.<br />
<br />
=== 5.1. Standard configuration flags ===<br />
'''Configuration:'''<br />
*<tt>-h--help</tt> <br />
display this help and exit<br />
*<tt>--help=short</tt> <br />
display options specific to this package<br />
*<tt>--help=recursive</tt> <br />
display the short help of all the included packages<br />
*<tt>-V--version</tt> <br />
display version information and exit<br />
*<tt>-q--quiet--silent</tt> <br />
do not print "checking..." messages<br />
*<tt>--cache-file=FILE</tt> <br />
<nowiki>cache test results in FILE [disabled by default]</nowiki><br />
*<tt>-C--config-cache</tt> <br />
alias for <tt>--cache-file=config.cache</tt><br />
*<tt>-n--no-create</tt> <br />
do not create output files<br />
*<tt>--srcdir=DIR</tt> <br />
<nowiki>find the sources in DIR [configure dir or </nowiki>.. by default]<br />
<br />
'''Installation directories:'''<br />
<br />
[[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>.<br />
*<tt>--prefix=PREFIX</tt> <br />
<nowiki>install architecture-independent files in PREFIX [</nowiki>/usr/local by default]<br />
*<tt>--exec-prefix=EPREFIX</tt> <br />
<nowiki>install architecture-dependent files in EPREFIX [</nowiki>PREFIX by default]<br />
<br />
'''Fine tuning of the installation directories:'''<br />
<br />
[[File:Man1_tip.png]] For better control, use the options below. Defaults are shown within brackets.<br />
<br />
*<tt>--bindir=DIR</tt> <br />
<nowiki>user executables [</nowiki>EPREFIX/bin]<br />
*<tt>--sbindir=DIR</tt> <br />
<nowiki>system admin executables [</nowiki>EPREFIX/sbin]<br />
*<tt>--libexecdir=DIR</tt> <br />
<nowiki>program executables [[Man 1 </nowiki>EPREFIX/libexec]]<br />
*<tt>--datadir=DIR</tt> <br />
<nowiki>read-only architecture-independent data [</nowiki>PREFIX/share]<br />
*<tt>--sysconfdir=DIR</tt> <br />
<nowiki>read-only single-machine data [</nowiki>PREFIX/etc]<br />
*<tt>--sharedstatedir=DIR</tt> <br />
<nowiki>modifiable architecture-independent data [</nowiki>PREFIX/com]<br />
*<tt>--localstatedir=DIR</tt> <br />
<nowiki>modifiable single-machine data [</nowiki>PREFIX/var]<br />
*<tt>--libdir=DIR</tt> <br />
<nowiki>object code libraries [[Man 1 </nowiki>EPREFIX/lib]]<br />
*<tt>--includedir=DIR</tt> <br />
<nowiki>C header files [[Man 1 </nowiki>PREFIX/include]]<br />
*<tt>--oldincludedir=DIR</tt> <br />
<nowiki>C header files for non-gcc [</nowiki>/usr/include]<br />
*<tt>--infodir=DIR</tt> <br />
<nowiki>info documentation [</nowiki>PREFIX/info]<br />
*<tt>--mandir=DIR</tt> <br />
<nowiki>man documentation [</nowiki>PREFIX/man]<br />
<br />
'''Program names:'''<br />
*<tt>--program-prefix=PREFIX</tt> <br />
prepend PREFIX to installed program names<br />
*<tt>--program-suffix=SUFFIX</tt> <br />
append SUFFIX to installed program names<br />
*<tt>--program-transform-name=PROGRAM</tt> <br />
run sed PROGRAM on installed program names<br />
<br />
'''System types:'''<br />
*<tt>--build=BUILD</tt> <br />
<nowiki>configure for building on BUILD [guessed]</nowiki><br />
*<tt>--host=HOST</tt> <br />
<nowiki>cross-compile to build programs to run on HOST [BUILD]</nowiki><br />
<br />
'''Some influential environment variables:'''<br />
<br />
<br />
[[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.<br />
<br />
*<tt>CC</tt> <br />
C compiler command<br />
*<tt>CFLAGS</tt> <br />
C compiler flags<br />
*<tt>LDFLAGS</tt> <br />
<nowiki>linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir></nowiki><br />
*<tt>CPPFLAGS</tt> <br />
<nowiki>C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir></nowiki><br />
*<tt>CPP</tt> <br />
C preprocessor<br />
<br />
=== 5.2. Flags personal to bluefish ===<br />
'''Optional Features:'''<br />
<br />
<br />
[[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.<br />
<br />
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.<br />
<br />
*<tt>--enable-auto-optimization</tt> <br />
Optimizes the build process for a given architecture if possible. It works only on a selected set of x86 platforms.<br />
<br />
How: rely on the result of:<br />
<br />
# '''uname -p''' or '''grep "model name" /proc/cpuinfo | cut -d: -f2''' to detect the architecture<br />
# the version of gcc to pass the arguments<br />
<br />
Tested gcc versions: 3.2.*, 3.0.*, 2.95.*<br />
<br />
Machines: Intel(R) Pentium(R) 4CPU, Pentium III, AMD-K6 (tm) 3D, Pentium 75 - 200, Pentium II, AMD Athlon(TM) XP<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc3-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
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<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-gcc2-optimization=type</tt> <br />
optimizes the build process for a given architecture if possible<br />
<br />
Machines: i386, i486, pentium, pentiumpro, k6<br />
<br />
Other machines are ignored<br />
<br />
*<tt>--enable-debugging-output</tt> <br />
turns debugging output on (this option impacts performance)<br />
*<tt>--disable-splash-screen</tt> <br />
suppresses the display of the splash screen at launch time (Bluefish launches faster)<br />
*<tt>--enable-highlight-profiling</tt> <br />
outputs statistics on where the program spends most of its time when highlighting patterns<br />
<br />
Usage: for debugging highlight patterns or trying to optimize the program<br />
*<tt>--enable-development</tt> <br />
enables development checks (slows down the program)<br />
*<tt>--enable-gprof-profiling</tt> <br />
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)<br />
*<tt>--enable-gcoc-coverage</tt> <br />
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)<br />
*<tt>--disable-update-databases</tt> <br />
do not run the update-desktop-database or update-mime-database utilities after installation (mostly useful for package maintainers)<br />
*<tt>--disable-nls</tt> <br />
disables the Native Language Support (might speed up the program)<br />
<br />
'''Optional Packages:'''<br />
<br />
<br />
[[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.<br />
*<tt>--without-libgnomeui</tt> <br />
disable libgnomeui detection<br />
*<tt>--with-gnome1-menu</tt> <br />
customized path for the gnome1 menu (disabled by default)<br />
<br />
Usage: <tt>--with-gnome1-menu=customizedpath</tt> or <tt>--without-gnome1-menu</tt> <br />
disabled by default<br />
*<tt>--with-freedesktop_org-menu</tt> <br />
customized path for the freedesktop.org (gnome and kde) menu<br />
<br />
Usage: <tt>--with-freedesktop_org-menu=customizedpath</tt> or <tt>--without-freedesktop_org-menu</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/applications<br />
* PREFIX/share/applications<br />
* /usr/X11R6/share/gnome/applications<br />
* PREFIX/share/gnome/applications<br />
<br />
*<tt>--with-freedesktop_org-mime</tt> <br />
customized path for the freedesktop.org (gnome and kde) mime<br />
<br />
Usage: <tt>--with-freedesktop_org-mime=customizedpath</tt> or <tt>--without-freedesktop_org-mime</tt> <br />
<br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime<br />
* PREFIX/share/mime<br />
* /usr/X11R6/share/gnome/mime<br />
* PREFIX/share/gnome/mime<br />
<br />
*<tt>--with-gnome2_4-mime</tt> <br />
customized path for the gnome 2.4 mime<br />
<br />
Usage: <tt>--with-gnome2_4-mime=customizedpath</tt> or <tt>--without-gnome2_4-mime</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/mime-info<br />
* PREFIX/share/mime-info<br />
* /usr/X11R6/share/gnome/mime-info<br />
* PREFIX/share/gnome/mime-info<br />
<br />
*<tt>--with-gnome2_4-appreg</tt> <br />
customized path for the gnome 2.4 application registry<br />
<br />
Usage: <tt>--with-gnome2_4-appreg=customizedpath</tt> or <tt>--without-gnome2_4-appreg</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/application-registry<br />
* PREFIX/share/application-registry<br />
* /usr/X11R6/share/gnome/application-registry<br />
* PREFIX/share/gnome/application-registry<br />
<br />
*<tt>--with-icon-path</tt> <br />
customized path for the icon.<br />
<br />
Usage: <tt>--with-icon-path=customizedpath</tt> or <tt>--without-icon-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/pixmaps<br />
* PREFIX/share/pixmaps<br />
* /usr/X11R6/share/gnome/pixmaps<br />
* PREFIX/share/gnome/pixmaps<br />
<br />
*<tt>--with-libiconv-prefix</tt> <br />
customized path for libiconv top level installation.<br />
<br />
Usage: <tt>--with-libiconv-prefix=customizeddir</tt><br />
<br />
Effect: searches for libiconv in customizeddir/include and customizeddir/lib<br />
*<tt>--with-included-gettext</tt> <br />
<br />
use the GNU gettext library included in the package<br />
<br />
'''Features specific to the CVS version:'''<br />
*<tt>--enable-unstable-install</tt> <br />
enable the installation of a bluefish development version with independent directories and files. Use this for CVS snapshots<br />
*<tt>--enable-scanner</tt> <br />
use the BfTextView scanner for editor widget<br />
*<tt>--disable-python</tt> <br />
do not build the python plugin<br />
*<tt>--with-theme-path</tt> <br />
customized path for the theme icons.<br />
<br />
Usage: <tt>--with-theme-path=customizedpath</tt> or <tt>--without-theme-path</tt> <br />
defaults to auto-detection, which tries:<br />
<br />
* /usr/share/icons/hicolor<br />
* PREFIX/share/icons/hicolor<br />
* /usr/X11R6/share/gnome/icons/hicolor<br />
* PREFIX/share/gnome/icons/hicolor<br />
<br />
<br />
{{Man1bottom<br />
|prev=Man 1 ch02s04<br />
|up=Man 1 ch02<br />
|next=Man 1 ch02s06<br />
|prevname= 4.&nbsp;Installing a Bluefish Source Distribution<br />
|nextname=6.&nbsp;Installing a Binary Distribution<br />
}}</div>Fal7i