summaryrefslogtreecommitdiff
path: root/Makefile.defaults
diff options
context:
space:
mode:
authorDaniel Silverstone <dsilvers@netsurf-browser.org>2009-03-27 11:23:25 +0000
committerDaniel Silverstone <dsilvers@netsurf-browser.org>2009-03-27 11:23:25 +0000
commit308d2d3345950bf1768e7cf5945b3027a83995eb (patch)
tree29e2bde2b431871b5d4db0caef80c2c891923b8c /Makefile.defaults
parent38c56a9d735c105579eedcb72de8d7c057a35c28 (diff)
downloadnetsurf-308d2d3345950bf1768e7cf5945b3027a83995eb.tar.gz
netsurf-308d2d3345950bf1768e7cf5945b3027a83995eb.tar.bz2
Rename Makefile.config to Makefile.defaults and update the docs
svn path=/trunk/netsurf/; revision=6937
Diffstat (limited to 'Makefile.defaults')
-rw-r--r--Makefile.defaults241
1 files changed, 241 insertions, 0 deletions
diff --git a/Makefile.defaults b/Makefile.defaults
new file mode 100644
index 000000000..29cce88f3
--- /dev/null
+++ b/Makefile.defaults
@@ -0,0 +1,241 @@
+#
+# NetSurf default build configuration
+#
+# Some of these options support an 'AUTO' option, as well as YES and NO.
+# When an option is set to AUTO, the Makefile will attempt to detect if that
+# feature is available, enabling it if possible.
+#
+# Options marked "highly recommended" have a severe impact on NetSurf's
+# use as a web browser and should be set to YES unless there is a particularly
+# good reason not to.
+#
+# This file should be treated as INVIOLATE and only altered to alter
+# the defaults by a core developer. If you wish to configure the build
+# of NetSurf then instead please create a file called Makefile.config
+# and simply override the statements you require in that. Remember
+# that Makefile.config cannot override the TARGET. That must be set on
+# the commandline. i.e. 'make TARGET=framebuffer' However
+# Makefile.config can use the TARGET variable to control what to set
+# the configuration options to.
+#
+
+# ----------------------------------------------------------------------------
+# Options relating to all versions of NetSurf
+# ----------------------------------------------------------------------------
+
+# Enable NetSurf's use of libnsbmp for displaying BMPs and ICOs
+# Valid options: YES, NO
+NETSURF_USE_BMP := YES
+
+# Enable NetSurf's use of libnsgif for displaying GIFs
+# Valid options: YES, NO (highly recommended)
+NETSURF_USE_GIF := YES
+
+# Enable NetSurf's use of libjpeg for displaying JPEGs
+# Valid options: YES, NO (highly recommended)
+NETSURF_USE_JPEG := YES
+
+# Enable NetSurf's use of libpng for displaying PNGs. If MNG and PNG
+# are both enabled then NetSurf will choose libpng for PNGs, leaving
+# MNGs and JNGs to libmng.
+# Valid options: YES, NO (at least one of PNG/MNG highly recommended)
+NETSURF_USE_PNG := NO
+
+# Enable NetSurf's use of libmng for displaying MNGs, JNGs and PNGs
+# Valid options: YES, NO (at least one of PNG/MNG highly recommended)
+NETSURF_USE_MNG := YES
+
+# Enable NetSurf's use of libharu for PDF export and GTK printing support.
+# There is no auto-detection available for this, as it does not have a
+# pkg-config file.
+# Valid options: YES, NO
+NETSURF_USE_HARU_PDF := YES
+
+# Enable stripping the NetSurf binary
+# Valid options: YES, NO
+NETSURF_STRIP_BINARY := NO
+
+# Template used for constructing the User Agent: string. The first two
+# replacements are major/minor version, second two are OS and architecture.
+# Please don't be tempted to mention Mozilla here! Let's let that lie die.
+NETSURF_UA_FORMAT_STRING := "NetSurf/%d.%d (%s; %s)"
+
+# Default home page, if one is not defined by the user. Note that this
+# option does not apply to the RISC OS version, as it has its own local
+# home page, and it can be changed by editing the end of gui_init2() in
+# riscos/gui.c
+NETSURF_HOMEPAGE := "http://www.netsurf-browser.org/welcome/"
+
+# Force using glibc internal iconv implementation instead of external libiconv
+# Valid options: YES, NO
+NETSURF_USE_LIBICONV_PLUG := YES
+
+# Initial CFLAGS. Optimisation level etc. tend to be target specific.
+CFLAGS :=
+
+# ----------------------------------------------------------------------------
+# RISC OS-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),riscos)
+
+ # Enable NetSurf's use of Hubbub to parse HTML, rather than libxml2
+ # Valid options: YES, NO (highly recommended)
+ NETSURF_USE_HUBBUB := YES
+
+ # Enable NetSurf's use of libsvgtiny for displaying SVGs
+ # Valid options: YES, NO
+ NETSURF_USE_NSSVG := YES
+
+ # Enable NetSurf's use of pencil for Drawfile export
+ # Valid options: YES, NO
+ NETSURF_USE_DRAW := YES
+
+ # Enable NetSurf's support for displaying RISC OS Sprites
+ # Valid options: YES, NO
+ NETSURF_USE_SPRITE := YES
+
+ # Enable NetSurf's use of AWRender for displaying ArtWorks files
+ # Valid options: YES, NO
+ NETSURF_USE_ARTWORKS := YES
+
+ # Enable NetSurf's support for the Acorn plugin protocol
+ # Valid options: YES, NO
+ NETSURF_USE_PLUGINS := NO
+
+ # Optimisation levels
+ CFLAGS += -O2 -Wuninitialized
+
+endif
+
+# ----------------------------------------------------------------------------
+# GTK-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),gtk)
+
+ # Where to search for NetSurf's resources after looking in ~/.netsurf and
+ # $NETSURFRES. It must have a trailing /
+ NETSURF_GTK_RESOURCES := /usr/local/share/netsurf/
+
+ # Where to install the netsurf binary
+ NETSURF_GTK_BIN := /usr/local/bin/
+
+ # Enable NetSurf's use of Hubbub to parse HTML, rather than libxml2
+ # Valid options: YES, NO, AUTO (highly recommended)
+ NETSURF_USE_HUBBUB := AUTO
+
+ # Enable NetSurf's use of librsvg in conjunction with Cairo to display SVGs
+ # Valid options: YES, NO, AUTO
+ NETSURF_USE_RSVG := AUTO
+
+ # Enable NetSurf's use of librosprite for displaying RISC OS Sprites
+ # Valid options: YES, NO, AUTO
+ NETSURF_USE_ROSPRITE := AUTO
+
+ # Configuration overrides for Mac OS X
+ ifeq ($(HOST),macosx)
+ NETSURF_USE_LIBICONV_PLUG := NO
+ NETSURF_USE_HARU_PDF := NO
+ endif
+
+ # Optimisation levels
+ CFLAGS += -O2 -Wuninitialized
+
+endif
+
+# ----------------------------------------------------------------------------
+# BeOS-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),beos)
+
+ # Enable NetSurf's use of librosprite for displaying RISC OS Sprites
+ # Valid options: YES, NO, AUTO
+ NETSURF_USE_ROSPRITE := AUTO
+
+ # Enable NetSurf's use of libharu for PDF export.
+ # Valid options: YES, NO
+ NETSURF_USE_HARU_PDF := NO
+
+ # Force using glibc internal iconv implementation instead of external libiconv
+ # Valid options: YES, NO
+ NETSURF_USE_LIBICONV_PLUG := NO
+
+ # Optimisation levels
+ CFLAGS += -O2 -Wuninitialized
+
+endif
+
+# ----------------------------------------------------------------------------
+# Amiga-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),amiga)
+
+ # Enable NetSurf's use of librosprite for displaying RISC OS Sprites
+ # Valid options: YES, NO, AUTO
+ NETSURF_USE_ROSPRITE := YES
+
+ # Enable NetSurf's use of Hubbub to parse HTML rather, than libxml2
+ # Valid options: YES, NO, AUTO (highly recommended)
+ NETSURF_USE_HUBBUB := YES
+
+ # Enable NetSurf's use of libsvgtiny for displaying SVGs
+ # (NB: Requires NETSURF_AMIGA_USE_CAIRO)
+ # Valid options: YES, NO
+ NETSURF_USE_NSSVG := NO
+
+ # Enable NetSurf's use of libcairo for some plotter functions
+ # This will also link NetSurf with shared objects, and
+ # requires AmigaOS 4.1 or higher to run the resulting executable
+ # Valid options: YES, NO
+ NETSURF_AMIGA_USE_CAIRO := NO
+
+ # Optimisation levels
+ CFLAGS += -O2 -Wuninitialized
+
+endif
+
+# ----------------------------------------------------------------------------
+# Debug-target-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),debug)
+
+ # Optimisation levels
+ CFLAGS += -O0
+
+endif
+
+# ----------------------------------------------------------------------------
+# Framebuffer-target-specific options
+# ----------------------------------------------------------------------------
+ifeq ($(TARGET),framebuffer)
+ # Optimisation levels
+ CFLAGS += -O2 -Wuninitialized
+
+ # Framebuffer frontend.
+ # Valid values are: linux, sdl, vnc, able
+ NETSURF_FB_FRONTEND := linux
+
+ # Enable NetSurf's use of Hubbub to parse HTML rather, than libxml2
+ # Valid options: YES, NO, AUTO (highly recommended)
+ NETSURF_USE_HUBBUB := AUTO
+
+ # Use libharu to enable PDF export and GTK printing support.
+ # Valid options: YES, NO
+ NETSURF_USE_HARU_PDF := NO
+
+ # Library to use for font plotting
+ # Valid options: internal, freetype
+ NETSURF_FB_FONTLIB := internal
+
+ # Framebuffer frontends may have differing root paths for resources
+ # As such, these specify the resource path and config path.
+ NETSURF_FB_RESPATH_linux := /usr/share/netsurf/
+ NETSURF_FB_RESPATH_able := (tftpboot)/
+ NETSURF_FB_RESPATH_dummy := ./
+ NETSURF_FB_RESPATH_sdl := ./
+ NETSURF_FB_RESPATH_vnc := /usr/share/netsurf/
+
+endif
+
+# Include any local configuration
+-include Makefile.config
+