Added instructions for Mint Linux and Fedora.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7771 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

2 files changed, 151 insertions, 70 deletions

diff --git a/README.OSX.txt b/README.OSX.txt
index 899834ecb..7b1e5e8e5 100644
--- a/README.OSX.txt
+++ b/README.OSX.txt
@@ -28,8 +28,8 @@ README.OSX.txt - 2010-10-23 - Building FLTK under Apple OS X
   4   DOCUMENT HISTORY
 
 
- INTRODUCTION
-==============
+ 1  INTRODUCTION
+=================
 
 FLTK currently supports the following development environments on the Apple OS X
 platform:
@@ -41,12 +41,12 @@ CAUTION: gcc command line built libraries and Xcode created Frameworks should
 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 @@ is located in the "Utilities" folder inside the "Applications" folder. I like to
 keep the Terminal in the Dock.
 
 
- Downloading and Unpacking
----------------------------
+ 2.2  Downloading and Unpacking
+--------------------------------
 
 Download FLTK from here:
 
@@ -79,8 +79,8 @@ dev directory:
   cd fltk-1.3.xxxx
   
 
- Configuring FLTK
-------------------
+ 2.3  Configuring FLTK
+-----------------------
 
 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.
 
 
- 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)
 
-
- Testing FLTK
---------------
+ 2.5  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 @@ installation path to a location within the user account by adding the
 "--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 @@ 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
 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
   
 
- Downloading and Unpacking
----------------------------
+ 3.2  Downloading and Unpacking
+--------------------------------
 
 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.
 
 
- Configuring FLTK
-------------------
+ 3.3  Configuring FLTK
+-----------------------
 
 Launch Xcode. Open the project file in 
 
@@ -196,8 +193,8 @@ Use the "Project" pulldown menu to change "Active Build Configuration" to
 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 @@ form the "Build" menu to create all libraries and test applications.
 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 @@ Remove Fluid and other possibly utilities:
   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 @@ tools:
   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: Language Definition
 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 @@ 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
diff --git a/README.Unix.txt b/README.Unix.txt
index e2579f3fc..2ffe12543 100644
--- a/README.Unix.txt
+++ b/README.Unix.txt
@@ -9,8 +9,8 @@ README.Unix.txt - 2010-10-28 - Building FLTK on Unix
   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,11 +27,13 @@ README.Unix.txt - 2010-10-28 - Building FLTK on Unix
     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 @@ platforms:
     - ...
     
 
- 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 @@ Open a shell and install some software:
   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,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)
 
 
+ 2.2  Linux Mint 9
+-------------------
+
+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
 
- HOW TO BUILD FLTK USING GCC
-=============================
+  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:
 
@@ -105,8 +183,8 @@ dev directory:
   cd fltk-1.3.xxxx
   
 
- Configuring FLTK
-------------------
+ 3.2  Configuring FLTK
+-----------------------
 
 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.
 
 
- Building FLTK
----------------
+ 3.3  Building FLTK
+--------------------
 
 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.
 
 
- 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 @@ installation path to a location within the user account by adding the
 "--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 @@ 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