mirrors/fltk
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added instructions for Mint Linux and Fedora.

Browse Source 
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7771 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Matthias Melcher 2010-10-30 14:51:32 +00:00
parent efd349ddce
commit c18d7d5070
2 changed files with 151 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

86
README.OSX.txt
View File

@ -28,8 +28,8 @@ README.OSX.txt - 2010-10-23 - Building FLTK under Apple OS X
4 DOCUMENT HISTORY 4 DOCUMENT HISTORY
INTRODUCTION 1 INTRODUCTION
============== =================
FLTK currently supports the following development environments on the Apple OS X FLTK currently supports the following development environments on the Apple OS X
platform: platform:
@ -41,12 +41,12 @@ CAUTION: gcc command line built libraries and Xcode created Frameworks should
not be mixed! 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 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 developer environment from the Apple Inc. web site. The developer environment
@ -59,8 +59,8 @@ is located in the "Utilities" folder inside the "Applications" folder. I like to
keep the Terminal in the Dock. keep the Terminal in the Dock.
Downloading and Unpacking 2.2 Downloading and Unpacking
--------------------------- --------------------------------
Download FLTK from here: Download FLTK from here:
@ -79,8 +79,8 @@ dev directory:
cd fltk-1.3.xxxx cd fltk-1.3.xxxx
Configuring FLTK 2.3 Configuring FLTK
------------------ -----------------------
Stay in your FLTK source-code directory. Type: Stay in your FLTK source-code directory. Type:
@ -103,31 +103,28 @@ which should all have been part of your Xcode installation. Review the
Configuration Summary, maybe take some notes. 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: Now this is easy. Stay in your FLTK source-code directory and type:
make make
The entire FLTK toolkit including many test programs will be built for you. No 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. 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: After a successful build, you can test FLTK's capabilities:
test/demo test/demo
Installing FLTK 2.6 Installing FLTK
----------------- ----------------------
If you did not change any of the configuration settings, FLTK will be installed If you did not change any of the configuration settings, FLTK will be installed
in "/usr/local/include" and "/usr/local/lib" by typing in "/usr/local/include" and "/usr/local/lib" by typing
@ -139,8 +136,8 @@ installation path to a location within the user account by adding the
"--prefix=PREFIX" parameters to the "./configure" command. "--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 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 needed to build FLTK applications using the same flags that were used to build
@ -155,12 +152,12 @@ recommend that you add it to the command search path.
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 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 developer environment from the Apple Inc. web site. The developer environment
@ -169,8 +166,8 @@ can be downloaded from the Mac Dev Center for free:
http://developer.apple.com/technologies/xcode.html http://developer.apple.com/technologies/xcode.html
Downloading and Unpacking 3.2 Downloading and Unpacking
--------------------------- --------------------------------
Download FLTK from here: Download FLTK from here:
@ -184,8 +181,8 @@ Unpack FLTK by double-clicking it and copy the new folder into a convenient
location. I have set up a "dev" folder in my home folder for all my projects. 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 Launch Xcode. Open the project file in
@ -196,8 +193,8 @@ Use the "Project" pulldown menu to change "Active Build Configuration" to
desired. desired.
Building FLTK 3.4 Building FLTK
--------------- --------------------
Use the "Project" pulldown menu to set the "Active Target" to "Release". Use the 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" "Project" pulldown menu to set the "Active Target" to "Demo". Select "Build"
@ -206,15 +203,15 @@ form the "Build" menu to create all libraries and test applications.
All frameworks and apps will be loacted in "./ide/Xcode3/build/Release/". 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" Select "Build and Run" form the "Build" menu to run the Demo program. Use "Demo"
to explore all test programs. to explore all test programs.
Uninstalling previous versions of FLTK 3.6 Uninstalling previous versions of FLTK
---------------------------------------- ---------------------------------------------
Remove FLTK frameworks: Remove FLTK frameworks:
@ -225,8 +222,8 @@ Remove Fluid and other possibly utilities:
sudo rm -r /Developer/Applications/Utilities/FLTK/ 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 When distributing FLTK applications, the FLTK frameworks should be made part of
the application package. For development however, it is very convenient to have the application package. For development however, it is very convenient to have
@ -247,8 +244,8 @@ tools:
sudo cp -R ide/Xcode3/build/Release/Fluid.app /Developer/Applications/Utilities/FLTK/ sudo cp -R ide/Xcode3/build/Release/Fluid.app /Developer/Applications/Utilities/FLTK/
Installing Little Helpers 3.8 Installing Little Helpers
--------------------------- --------------------------------
- Project Templates: - Project Templates:
@ -299,8 +296,8 @@ TODO: Language Definition
TODO: Build Rules TODO: Build Rules
Creating new Projects 3.9 Creating new Projects
----------------------- ----------------------------
If the little helpers above were installed, the menu "File > New Project..." 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 will pop up a dialog that offers a User Template named Fluid. Select it and
@ -309,7 +306,8 @@ manually which is needed to create warning beeps.
DOCUMENT HISTORY 4 DOCUMENT HISTORY
================== =====================
Oct 29 2010 - matt: removed warnings
Oct 24 2010 - matt: restructured entire document and verified instructions Oct 24 2010 - matt: restructured entire document and verified instructions

135
README.Unix.txt
View File

@ -9,8 +9,8 @@ README.Unix.txt - 2010-10-28 - Building FLTK on Unix
1 INTRODUCTION 1 INTRODUCTION
2 PREREQUISITES 2 PREREQUISITES
2.1 Ubuntu 10 2.1 Ubuntu 10
2.2 * http://www.linuxmint.com/about.php 2.2 Linux Mint 9
2.3 * http://fedoraproject.org/ 2.3 Fedora 13
2.4 * http://www2.mandriva.com/ 2.4 * http://www2.mandriva.com/
2.5 * http://www.opensuse.org/en/ 2.5 * http://www.opensuse.org/en/
2.6 * http://www.debian.org/ 2.6 * http://www.debian.org/
@ -27,11 +27,13 @@ README.Unix.txt - 2010-10-28 - Building FLTK on Unix
3.6 Installing FLTK 3.6 Installing FLTK
3.7 Creating new Projects 3.7 Creating new Projects
4 * CODE::BLOCKS 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 FLTK currently supports the following development environments on vmost Unix
platforms: platforms:
@ -41,16 +43,16 @@ platforms:
- ... - ...
PREREQUISITES 2 PREREQUISITES
=============== ==================
Ubuntu 10 2.1 Ubuntu 10
----------- ----------------
Ubuntu Linux can be downloaded here: Ubuntu Linux can be downloaded here:
www.ubuntu.com http://www.ubuntu.com/
If you have not done so yet, download and install Ubuntu. If you have not done so yet, download and install Ubuntu.
@ -62,6 +64,9 @@ Open a shell and install some software:
sudo apt-get install autoconf sudo apt-get install autoconf
sudo apt-get install libx11-dev sudo apt-get install libx11-dev
sudo apt-get install libglu1-mesa-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 libasound2-dev
sudo apt-get install libxft-dev sudo apt-get install libxft-dev
@ -80,13 +85,86 @@ To update to the latest version, just go into the fltk-1.3 directory and type
FIXME: no FL_SYMBOL font (-*-symbol-*), font 15 (Zapf-Dingbats) 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.
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)
Downloading and Unpacking 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: Download FLTK from here:
@ -105,8 +183,8 @@ dev directory:
cd fltk-1.3.xxxx cd fltk-1.3.xxxx
Configuring FLTK 3.2 Configuring FLTK
------------------ -----------------------
Stay in your FLTK source-code directory. Type: Stay in your FLTK source-code directory. Type:
@ -126,8 +204,8 @@ which you should have installed as described in the Perequisites chapter. Review
the Configuration Summary, maybe take some notes. 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: Now this is easy. Stay in your FLTK source-code directory and type:
@ -141,16 +219,16 @@ Actually, as of Oct 28 2010, quite a bunch of warnigns will show, mostly about
suggested parenthesis. Please ignore them until we can fix them. 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: After a successful build, you can test FLTK's capabilities:
test/demo test/demo
Installing FLTK 3.5 Installing FLTK
----------------- ----------------------
If you did not change any of the configuration settings, FLTK will be installed If you did not change any of the configuration settings, FLTK will be installed
in "/usr/local/include" and "/usr/local/lib" by typing in "/usr/local/include" and "/usr/local/lib" by typing
@ -162,8 +240,8 @@ installation path to a location within the user account by adding the
"--prefix=PREFIX" parameters to the "./configure" command. "--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 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 needed to build FLTK applications using the same flags that were used to build
@ -178,7 +256,12 @@ recommend that you add it to the command search path.
DOCUMENT HISTORY 4 CODE::BLOCKS
================== =================
5 DOCUMENT HISTORY
=====================
Oct 28 2010 - matt: restructured entire document and verified instructions Oct 28 2010 - matt: restructured entire document and verified instructions