Author: matt Date: 2010-10-30 07:51:32 -0700 (Sat, 30 Oct 2010) New Revision: 7771 Log: Added instructions for Mint Linux and Fedora.
Modified: branches/branch-1.3/README.OSX.txt branches/branch-1.3/README.Unix.txt Modified: branches/branch-1.3/README.OSX.txt =================================================================== --- branches/branch-1.3/README.OSX.txt 2010-10-29 22:14:59 UTC (rev 7770) +++ branches/branch-1.3/README.OSX.txt 2010-10-30 14:51:32 UTC (rev 7771) @@ -28,8 +28,8 @@ 4 DOCUMENT HISTORY - INTRODUCTION -============== + 1 INTRODUCTION +================= FLTK currently supports the following development environments on the Apple OS X platform: @@ -41,12 +41,12 @@ not be mixed! - HOW TO BUILD FLTK USING GCC -============================= + 2 HOW TO BUILD FLTK USING GCC +================================ - Prerequisites ---------------- + 2.1 Prerequisites +-------------------- In order to build FLTK from the command line, you need to install the Xcode developer environment from the Apple Inc. web site. The developer environment @@ -59,8 +59,8 @@ keep the Terminal in the Dock. - Downloading and Unpacking ---------------------------- + 2.2 Downloading and Unpacking +-------------------------------- Download FLTK from here: @@ -79,8 +79,8 @@ cd fltk-1.3.xxxx - Configuring FLTK ------------------- + 2.3 Configuring FLTK +----------------------- Stay in your FLTK source-code directory. Type: @@ -103,31 +103,28 @@ Configuration Summary, maybe take some notes. - Building FLTK ---------------- + 2.4 Building FLTK +-------------------- Now this is easy. Stay in your FLTK source-code directory and type: make The entire FLTK toolkit including many test programs will be built for you. No -warnings should appear, but "ranlib" will complain about a few modules having no +warnings should appear, but "ranlib" may complain about a few modules having no symbols. This is normal and can safely be ignored. -(actually, as of Oct 23 2010, a handful of warnings related to string literals -may appear, this is normal and will be fixed) + 2.5 Testing FLTK +------------------- - Testing FLTK --------------- - After a successful build, you can test FLTK's capabilities: test/demo - Installing FLTK ------------------ + 2.6 Installing FLTK +---------------------- If you did not change any of the configuration settings, FLTK will be installed in "/usr/local/include" and "/usr/local/lib" by typing @@ -139,8 +136,8 @@ "--prefix=PREFIX" parameters to the "./configure" command. - Creating new Projects ------------------------ + 2.7 Creating new Projects +---------------------------- FLTK provides a neat script named "fltk-config" that can provide all the flags needed to build FLTK applications using the same flags that were used to build @@ -155,12 +152,12 @@ - HOW TO BUILD FLTK USING XCODE3 -================================ + 3 HOW TO BUILD FLTK USING XCODE3 +=================================== - Prerequisites ---------------- + 3.1 Prerequisites +-------------------- In order to build FLTK from within Xcode, you need to install the Xcode developer environment from the Apple Inc. web site. The developer environment @@ -169,8 +166,8 @@ http://developer.apple.com/technologies/xcode.html - Downloading and Unpacking ---------------------------- + 3.2 Downloading and Unpacking +-------------------------------- Download FLTK from here: @@ -184,8 +181,8 @@ location. I have set up a "dev" folder in my home folder for all my projects. - Configuring FLTK ------------------- + 3.3 Configuring FLTK +----------------------- Launch Xcode. Open the project file in @@ -196,8 +193,8 @@ desired. - Building FLTK ---------------- + 3.4 Building FLTK +-------------------- Use the "Project" pulldown menu to set the "Active Target" to "Release". Use the "Project" pulldown menu to set the "Active Target" to "Demo". Select "Build" @@ -206,15 +203,15 @@ All frameworks and apps will be loacted in "./ide/Xcode3/build/Release/". - Testing FLTK --------------- + 3.5 Testing FLTK +------------------- Select "Build and Run" form the "Build" menu to run the Demo program. Use "Demo" to explore all test programs. - Uninstalling previous versions of FLTK ----------------------------------------- + 3.6 Uninstalling previous versions of FLTK +--------------------------------------------- Remove FLTK frameworks: @@ -225,8 +222,8 @@ sudo rm -r /Developer/Applications/Utilities/FLTK/ - Installing FLTK ------------------ + 3.7 Installing FLTK +---------------------- When distributing FLTK applications, the FLTK frameworks should be made part of the application package. For development however, it is very convenient to have @@ -247,8 +244,8 @@ sudo cp -R ide/Xcode3/build/Release/Fluid.app /Developer/Applications/Utilities/FLTK/ - Installing Little Helpers ---------------------------- + 3.8 Installing Little Helpers +-------------------------------- - Project Templates: @@ -299,8 +296,8 @@ TODO: Build Rules - Creating new Projects ------------------------ + 3.9 Creating new Projects +---------------------------- If the little helpers above were installed, the menu "File > New Project..." will pop up a dialog that offers a User Template named Fluid. Select it and @@ -309,7 +306,8 @@ - DOCUMENT HISTORY -================== + 4 DOCUMENT HISTORY +===================== +Oct 29 2010 - matt: removed warnings Oct 24 2010 - matt: restructured entire document and verified instructions Modified: branches/branch-1.3/README.Unix.txt =================================================================== --- branches/branch-1.3/README.Unix.txt 2010-10-29 22:14:59 UTC (rev 7770) +++ branches/branch-1.3/README.Unix.txt 2010-10-30 14:51:32 UTC (rev 7771) @@ -9,8 +9,8 @@ 1 INTRODUCTION 2 PREREQUISITES 2.1 Ubuntu 10 - 2.2 * http://www.linuxmint.com/about.php - 2.3 * http://fedoraproject.org/ + 2.2 Linux Mint 9 + 2.3 Fedora 13 2.4 * http://www2.mandriva.com/ 2.5 * http://www.opensuse.org/en/ 2.6 * http://www.debian.org/ @@ -27,12 +27,14 @@ 3.6 Installing FLTK 3.7 Creating new Projects 4 * CODE::BLOCKS - 4 DOCUMENT HISTORY + 5 DOCUMENT HISTORY +* TODO: we still need to write these chapters - INTRODUCTION -============== + 1 INTRODUCTION +================= + FLTK currently supports the following development environments on vmost Unix platforms: @@ -41,16 +43,16 @@ - ... - PREREQUISITES -=============== + 2 PREREQUISITES +================== - Ubuntu 10 ------------ + 2.1 Ubuntu 10 +---------------- Ubuntu Linux can be downloaded here: - www.ubuntu.com + http://www.ubuntu.com/ If you have not done so yet, download and install Ubuntu. @@ -62,6 +64,9 @@ sudo apt-get install autoconf sudo apt-get install libx11-dev sudo apt-get install libglu1-mesa-dev + +These two are optional, but highly recommended: + sudo apt-get install libasound2-dev sudo apt-get install libxft-dev @@ -80,14 +85,87 @@ FIXME: no FL_SYMBOL font (-*-symbol-*), font 15 (Zapf-Dingbats) + 2.2 Linux Mint 9 +------------------- - HOW TO BUILD FLTK USING GCC -============================= +Linux Mint 9 can be downloaded here: + http://www.linuxmint.com/ + +If you have not done so yet, download and install Linux Mint. - Downloading and Unpacking ---------------------------- +Open a shell and install some software: + sudo apt-get install g++ + sudo apt-get install gdb + sudo apt-get install subversion + sudo apt-get install autoconf + sudo apt-get install libx11-dev + sudo apt-get install libglu1-mesa-dev + +These two are optional, but highly recommended: + + sudo apt-get install libasound2-dev + sudo apt-get install libxft-dev + +If you are planning to use the Code::Blocks IDE, also install this + + sudo apt-get install codeblocks + +I like to use subversion to install the latest FLTK-1.3.release: + + svn co http://svn.easysw.com/public/fltk/fltk/branches/branch-1.3/ fltk-1.3 + +To update to the latest version, just go into the fltk-1.3 directory and type + + svn update + +FIXME: no FL_SYMBOL font (-*-symbol-*), font 15 (Zapf-Dingbats) + + + 2.3 Fedora 13 +------------------- + +Fedora 13 Linux can be downloaded here: + + http://fedoraproject.org/ + +If you have not done so yet, download and install Fedora. + +Open a terminal window and install some software. In Fedora, the default user +has no permission to call "sudo", so we will change user a few times: + + su root + yum groupinstall "Development Tools" + yum groupinstall "X Software Development" + +If you are planning to use the Code::Blocks IDE, also install this + + yum install codeblocks.i686 (for 64 bit machines) + +Don't forget to leave root status (Ctrl-D) before loading FLTK. To install FLTK +for every user, you either have to set root user again, or use "visudo" to add +yourself to the "sudo" list. + +I like to use subversion to install the latest FLTK-1.3.release: + + svn co http://svn.easysw.com/public/fltk/fltk/branches/branch-1.3/ fltk-1.3 + +To update to the latest version, just go into the fltk-1.3 directory and type + + svn update + +FIXME: no FL_SYMBOL font (-*-symbol-*), font 15 (Zapf-Dingbats) + + + + 3 HOW TO BUILD FLTK USING GCC +================================ + + + 3.1 Downloading and Unpacking +-------------------------------- + Download FLTK from here: http://www.fltk.org/software.php @@ -105,8 +183,8 @@ cd fltk-1.3.xxxx - Configuring FLTK ------------------- + 3.2 Configuring FLTK +----------------------- Stay in your FLTK source-code directory. Type: @@ -126,8 +204,8 @@ the Configuration Summary, maybe take some notes. - Building FLTK ---------------- + 3.3 Building FLTK +-------------------- Now this is easy. Stay in your FLTK source-code directory and type: @@ -141,16 +219,16 @@ suggested parenthesis. Please ignore them until we can fix them. - Testing FLTK --------------- + 3.4 Testing FLTK +------------------- After a successful build, you can test FLTK's capabilities: test/demo - Installing FLTK ------------------ + 3.5 Installing FLTK +---------------------- If you did not change any of the configuration settings, FLTK will be installed in "/usr/local/include" and "/usr/local/lib" by typing @@ -162,8 +240,8 @@ "--prefix=PREFIX" parameters to the "./configure" command. - Creating new Projects ------------------------ + 3.6 Creating new Projects +---------------------------- FLTK provides a neat script named "fltk-config" that can provide all the flags needed to build FLTK applications using the same flags that were used to build @@ -178,7 +256,12 @@ - DOCUMENT HISTORY -================== + 4 CODE::BLOCKS +================= + + + 5 DOCUMENT HISTORY +===================== + Oct 28 2010 - matt: restructured entire document and verified instructions _______________________________________________ fltk-commit mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-commit
