From f47c0f16e270a90319649b0bba7c70797783961e Mon Sep 17 00:00:00 2001 From: Sven Weidauer Date: Thu, 13 Jan 2011 07:47:07 +0000 Subject: Adding build instructions for Cocoa and building with system-provided libpng by default. svn path=/trunk/netsurf/; revision=11307 --- Docs/BUILDING-Cocoa | 89 +++++++++++++++++++++++++++++++++++++++++++ cocoa/config/NetSurf.xcconfig | 4 +- 2 files changed, 91 insertions(+), 2 deletions(-) create mode 100644 Docs/BUILDING-Cocoa diff --git a/Docs/BUILDING-Cocoa b/Docs/BUILDING-Cocoa new file mode 100644 index 000000000..18c27f556 --- /dev/null +++ b/Docs/BUILDING-Cocoa @@ -0,0 +1,89 @@ +-------------------------------------------------------------------------------- + Build Instructions for Cocoa NetSurf 13 January 2011 +-------------------------------------------------------------------------------- + + This document provides instructions for building the Cocoa version of NetSurf + and provides guidance on obtaining NetSurf's build dependencies. + + Cocoa NetSurf has been tested on Mac OS X 10.6 on Intel and on Mac OS X 10.5 + on ppc. + + Building and executing NetSurf +================================ + + After installing the dependencies NetSurf can be built in Xcode using the provided + project file "NetSurf.xcodeproj". This builds a version using only the minimal set + of dependencies (LibParserUtils, LibWapcaplet, Hubbub, LibCSS) and libraries provided + by Mac OS X. + + To build a more complete version a local configuration file has to be created. To + do this open a Terminal and change to the "cocoa/config" folder and run this command: + + $ sh detect.sh --with-jpeg= --with-mng= + + You can leave out the options for the JPEG and MNG libraries if you don't have them + installed. + + This script uses the "pkg-config" program to find the required libraries and generates + the file "local.xcconfig". After that NetSurf can be built using Xcode. + + Obtaining NetSurf's build dependencies +======================================== + + Many of NetSurf's dependencies are packaged on various operating systems. + The remainder must be installed manually. Currently, some of the libraries + developed as part of the NetSurf project have not had official releases. + Hopefully they will soon be released with downloadable tarballs and packaged + in common distros. For now, you'll have to make do with svn checkouts. + + Package installation +---------------------- + + For building the other NetSurf libraries and for configuring NetSurf the + "pkg-config" tool is required. It can be installed either via fink, macports + or homebrew or from source. + + OpenSSL, LibXML2, LibPNG, curl, iconv and zlib are provided by Mac OS X. + + LibJPEG and LibMNG can be installed from source or using one of the mentioned + package managers. + + + The NetSurf project's libraries +--------------------------------- + + The NetSurf project has developed several libraries which are required by + the browser. These are: + + LibParserUtils -- Parser building utility functions + LibWapcaplet -- String internment + Hubbub -- HTML5 compliant HTML parser + LibCSS -- CSS parser and selection engine + LibNSGIF -- GIF format image decoder + LibNSBMP -- BMP and ICO format image decoder + LibROSprite -- RISC OS Sprite format image decoder + + To fetch each of these libraries, run the following commands: + + $ svn co svn://svn.netsurf-browser.org/trunk/libparserutils + $ svn co svn://svn.netsurf-browser.org/trunk/libwapcaplet + $ svn co svn://svn.netsurf-browser.org/trunk/hubbub + $ svn co svn://svn.netsurf-browser.org/trunk/libcss + $ svn co svn://svn.netsurf-browser.org/trunk/libnsgif + $ svn co svn://svn.netsurf-browser.org/trunk/libnsbmp + $ svn co svn://svn.netsurf-browser.org/trunk/librosprite + + To build and install these libraries, simply enter each of their directories + and run: + + $ sudo make install + + | Note: We advise enabling ivonv() support in libparserutils, which vastly + | increases the number of supported character sets. To do this, + | create a file called Makefile.config.override in the libparserutils + | directory, containing the following line: + | + | CFLAGS += -DWITH_ICONV_FILTER + | + | For more information, consult the libparserutils README file. + diff --git a/cocoa/config/NetSurf.xcconfig b/cocoa/config/NetSurf.xcconfig index 144c8d74a..cdb1f82c9 100644 --- a/cocoa/config/NetSurf.xcconfig +++ b/cocoa/config/NetSurf.xcconfig @@ -6,8 +6,8 @@ GCC_MODEL_TUNING = G5 ALWAYS_SEARCH_USER_PATHS = NO PRODUCT_NAME = NetSurf -LOCAL_CONFIG_CFLAGS = -I/usr/local/include -I/usr/include/libxml2 -LOCAL_CONFIG_LDFLAGS = -L/usr/local/lib -lxml2 -lz -lpthread -licucore -lm -lssl -lhubbub -lcss -lcrypto -lparserutils -lwapcaplet -liconv -lcurl +LOCAL_CONFIG_CFLAGS = -I/usr/local/include -I/usr/include/libxml2 -I/usr/X11/include -DWITH_PNG +LOCAL_CONFIG_LDFLAGS = -L/usr/local/lib -lxml2 -lz -lpthread -licucore -lm -lssl -lhubbub -lcss -lcrypto -lparserutils -lwapcaplet -liconv -lcurl -L/usr/X11/lib -lpng #include "local.xcconfig" -- cgit v1.2.3