Skip to content

Commit

Permalink
Give correct instructions for Windows
Browse files Browse the repository at this point in the history
It needs to be much more clear that X11 is for Linux and GDI is for Windows.  I don't know what Mac or other platforms would use here

Also the better way to compile with the Text IDE is to load the appropriate fpgui_toolkit.pas file
which will compile ALL units, not just what may be used in a particular project, then all the newly
created units can be used for various projects, and you won't run into a problem if your original
project didn't use one of the units.

The instructions for compiling with the IDE have been modified to show usage for Linux and Windows
and further explain how to compile fpgui_toolkit.pas to compile all units
  • Loading branch information
Zaaphod committed Nov 30, 2024
1 parent b0a9f3d commit 3288620
Showing 1 changed file with 36 additions and 13 deletions.
49 changes: 36 additions & 13 deletions docs/INSTALL.txt
Original file line number Diff line number Diff line change
Expand Up @@ -80,35 +80,58 @@ so doesn't read the standard fpc.cfg file.
* Navigate the menus to: Options|Directories and select the 'Units'
tab.
* Now enter the following directories replacing the relevant parts with
your actual paths. The example below is valid on my system only.
I was using FPC 2.2.0 under Linux and the X11 corelib backend.

/opt/fpc_2.2.0/lib/fpc/2.2.0/units/i386-linux/*
/opt/fpc_2.2.0/lib/fpc/2.2.0/units/i386-linux/rtl
/home/graemeg/programming/fpGUI/src/corelib
/home/graemeg/programming/fpGUI/src/corelib/x11
/home/graemeg/programming/fpGUI/src/gui
your actual full paths for fpGUI.

For Linux:
full_path_to/fpGUI/src/corelib
full_path_to/fpGUI/src/corelib/x11 \\for linux
full_path_to/fpGUI/src/gui
full_path_to/fpGUI/src/gui/db
full_path_to/fpGUI/src/3rdparty/regex

For Windows:
full_path_to\fpGUI\src\corelib
full_path_to\fpGUI\src\corelib\gdi \\for windows
full_path_to\fpGUI\src\gui
full_path_to\fpGUI\src\gui\db
full_path_to\fpGUI\src\3rdparty\regex

* Now select the 'Include files' tab and enter the following paths.
Again change the paths to point to your actual directories and
X11 or GDI corelib backend.

/home/graemeg/programming/fpGUI/src/corelib
/home/graemeg/programming/fpGUI/src/corelib/x11
For Linux:
full_path_to/fpGUI/src/corelib
full_path_to/fpGUI/src/corelib/x11 \\for linux

For Windows:
full_path_to\fpGUI\src\corelib

* Now changes to 'Miscellaneous' tab, PPU output directory. Type in
the edit box: units
the edit box: full_path_to\units

NOTE:
This will place all the compiled *.ppu and *.o files into a 'units'
directory inside you current directory. So make sure you create it
before you try to compile for the first time. FPC doesn't create
directories for you!

* Now you are ready to open your projects main program unit (F3) and
* To create all the units for fpGUI,
compile one of the following:
full_path_to/fpGUI/src/corelib/x11/fpgui_toolkit.pas //for linux
full_path_to\fpGUI\src\corelib\gdi\fpgui_toolkit.pas //for windows

* Now you can restore your freepascal configuration by:
remove all the directories added in the Units Tab
remove the directories added in Include Files Tab
remove units from the Miscellaneous tab

* Add the directory to the newly created units in the units tab
full_path_to\units

you are ready to open your projects main program unit (F3) and
compiling it by pressing (F9).


Compiling any of the examples from the Command Line
═══════════════════════════════════════════════════

Expand Down

0 comments on commit 3288620

Please sign in to comment.