Documentation fixes.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3-porting@11862 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Albrecht Schlosser 2016-08-01 12:50:15 +00:00
parent 6b0e38942f
commit fe0c247dbb
2 changed files with 46 additions and 22 deletions

View File

@ -58,7 +58,7 @@ More information on CMake can be found on its web site http://www.cmake.org.
---------------
The prerequisites for building FLTK with CMake are staightforward:
CMake 2.6 or later and a recent FLTK 1.3 release, snapshot, or subversion
CMake 2.6.3 or later and a recent FLTK 1.3 release, snapshot, or subversion
download (working copy). Installation of CMake is covered on its web site.
This howto will cover building FLTK with the default options using cmake
@ -85,7 +85,7 @@ CMAKE_BUILD_TYPE
by CMake depending on this value.
CMAKE_INSTALL_PREFIX
Where everything will go on install. Defaults are /usr/local for unix
Where everything will go on install. Defaults are /usr/local for Unix
and C:\Program Files\FLTK for Windows.
The following are the FLTK specific options. Platform specific options
@ -136,7 +136,19 @@ OPTION_USE_SYSTEM_LIBPNG - default ON
OPTION_USE_XINERAMA - default ON
OPTION_USE_XFT - default ON
OPTION_USE_XDBE - default ON
OPTION_USE_XCURSOR - default ON
OPTION_USE_XRENDER - default ON
These are X11 extended libraries.
OPTION_ABI_VERSION - default EMPTY
Use a numeric value corresponding to the FLTK ABI version you want to
build in the form 1xxyy for FLTK 1.x.y (xx and yy with leading zeroes).
The default ABI version is 1xx00 (the stable ABI throughout all patch
releases of one minor FLTK version). The highest ABI version you may
choose is 1xxyy for FLTK 1.x.y (again with leading zeroes).
Please see README.abi-version.txt for more information about which
ABI version to select.
OPTION_PRINT_SUPPORT - default ON
When turned off, the Fl_Printer class does nothing and the
Fl_PostScript_File_Device class cannot be used, but the FLTK library
@ -153,7 +165,7 @@ the following.
cd build
cmake ..
make
sudo make install
sudo make install (optional)
This will build and install a default configuration FLTK.
@ -163,6 +175,18 @@ Some flags can be changed during the 'make' command, such as:
..which builds in verbose mode, so you can see all the compile/link commands.
Hint: if you intend to build several different versions of FLTK, e.g. a Debug
and a Release version, or multiple libraries with different ABI versions,
then use subdirectories in the build directory, like this:
mkdir build
cd build
mkdir Debug
cd Debug
cmake ../..
make
sudo make install (optional)
CROSSCOMPILING
----------------
@ -228,7 +252,7 @@ Here is a basic CMakeLists.txt file using FLTK.
------
cmake_minimum_required(VERSION 2.6)
cmake_minimum_required(VERSION 2.6.3)
project(hello)
@ -269,7 +293,7 @@ a gui app. It is ignored on other platforms.
LIBRARY NAMES
---------------
When you use the target_link_libraries command, CMake uses it's own
When you use the target_link_libraries command, CMake uses its own
internal names for libraries. The fltk library names are:
fltk fltk_forms fltk_images fltk_gl
@ -295,11 +319,11 @@ Here is a sample CMakeLists.txt which compiles the CubeView example from
a directory you've copied the test/Cube* files to.
---
cmake_minimum_required(VERSION 2.6)
cmake_minimum_required(VERSION 2.6.3)
project(CubeView)
# change this to your fltk buid directory
# change this to your fltk build directory
set(FLTK_DIR /home/msurette/build/fltk-release/)
find_package(FLTK REQUIRED NO_MODULE)
@ -313,7 +337,7 @@ add_custom_command(
include_directories(${CMAKE_BINARY_DIR})
include_directories(${CMAKE_SOURCE_DIR})
add_executable(CubeView WIN32 CubeMain.cxx CubeView.cxx CubeViewUI.cxx)
add_executable(CubeView WIN32 CubeMain.cxx CubeView.cxx CubeViewUI.cxx)
target_link_libraries(CubeView fltk fltk_gl)
---

View File

@ -38,7 +38,7 @@ README.Unix.txt - 2010-11-14 - Building FLTK on Unix
1 INTRODUCTION
=================
FLTK currently supports the following development environments on vmost Unix
FLTK currently supports the following development environments on most Unix
platforms:
- gcc command line tools
@ -305,13 +305,13 @@ Now configure your FLTK installation:
./configure
ADVANCED: type "./configure --help" to get a complete list of optional
configurations parameters. These should be pretty self-explanatory. Some
configuration parameters. These should be pretty self-explanatory. Some
more details can be found in README.
:END_ADVANCED
The configuration script will check your machine for the required resources
which you should have installed as described in the Prerequisites chapter. Review
the Configuration Summary, maybe take some notes.
which you should have installed as described in the Prerequisites chapter.
Review the Configuration Summary, maybe take some notes.
3.3 Building FLTK
@ -325,8 +325,8 @@ The entire FLTK toolkit including many test programs will be built for you. No
warnings should appear. If some do, please let the FLTK developer team know via
the mailing list or the bug reporting template at www.fltk.org .
Actually, as of Oct 28 2010, quite a bunch of warnings will show, mostly about
suggested parenthesis. Please ignore them until we can fix them.
Actually, as of Apr 13 2016, one or two warnings will show, mostly about
deprecated declarations. Please ignore them.
3.4 Testing FLTK
@ -359,11 +359,11 @@ installation path to a location within the user account by adding the
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
the library itself. Running "fltk-config" without arguments will print a list
options. The easiest call to compile an FLTK application from a single source
file is:
of options. The easiest call to compile an FLTK application from a single
source file is:
fltk-config --compile myProgram.cxx
@ -390,20 +390,20 @@ version 10.05:
Start Code::Blocks. Select File > New > Project. In the "New from template"
dialog box, click on "FLTK project" and follow the instructions.
The default project support basic fltk. If you would like to add support for
The default project supports basic fltk. If you would like to add support for
images, OpenGL, GLUT, or Forms, add the corresponding flags --use-images,
--use-gl, --use-glut, and --use-forms respectively.
The flags are located in the "Project Build Options" dialog. To change the
The flags are located in the "Project Build Options" dialog. To change the
compiler flags, select your project in the tree view, then select the
"Compiler Settings" tab, then "Other Options" and add the flags to
`fltk-config --cxxflags` in front of the second "`".
"Compiler Settings" tab, then "Other Options" and add the flags to
`fltk-config --cxxflags` in front of the second "`".
The linker flags are located in the "Linker Settings" tab under "Other Linker
Options". Add the flags to `fltk-config --ldstaticflags` in front of the
second "`".
CodeBlocks can be set up to use fluid to manage modules..
CodeBlocks can be set up to use fluid to manage modules.
The following info is from mingodad@gmail.com posted on fltk.general 06/17/2013:
"""