side4linux, a
simple integrated development environment!
Suggested Directory
Usage and 'side4linux' Install Guide
If you are
installing from the 'DVD' then please follow the Manual provided with
the disc.
If you are installing from the 'Sourceforge' site then please read all
of that which is presented below.
While building the IDE you should use the following recommended
procedures,
- If your username were 'fred' you need to create the
directory '/home/fred/Data/Projects'
- Unpack the source TAR file into the '/home/fred/Data/Projects'
directory to create '/home/fred/Data/Projects/SIDE'
- Ensure
you follow the instructions on how to set the 'side4linux' config
file '/home/fred/.side-dir-config/sideproject.cfg'
- Read the files that are unpacked next to the 'SIDE'
directory structure particularly Instal
Instructions.txt
- Also read the file PackageContents.txt
to see what extras you are getting.
- If you have the full set of GNOME libraries installed and
Glade-2/Glade-3 then, (or refer
to point 9 if you are not sure)
- then add a 'launcher' to your desktop pointed
at /opt/Side/bin/side4linux M
- and your done!
- If you are not sure about having the minimum libraries
needed for 'side4linux' or this is your first go at GNOME,
- do the 'C' practical setup C build
environment.txt which needs the 'avra' TAR package available from
the avra website
- then do the 'GNOME' practical setup GNOME build
environment.txt which will install 'side4linux' and GNOME libraries
for you manually.
- If you are upgrading to a newer version
then follow the upgrade instructions in Upgrading Instructions.txt
- If
some of your 'Tools' are not working and we have provided them then
change to each 'Tool' Project
using the IDE and
- 'Build>Autogen Project' ,
- 'Build>Configure Project' ,
- 'Build>Make
Clean'
After install the 'side4linux' IDE
directories would be (if your username was 'fred') in the
following directory as..
/home/fred/Data/Projects/SIDE
This will set the IDE's 'BASE' directory and will then be broken down
into the Product and Project directories as follows,
- /ANCA
; directory for ANCA style G-code CAM/CNC projects
- /AVRA
; directory for Atmel AVR microprocessor assembly code projects
- /AVRC
; directory for Atmel AVR microprocessor 'C' language
projects
- /ARMC
; directory
for ARM7TDMI microprocessor 'C' language
projects ( dvd version only )
- /CLC
; directory for LINUX command line 'C' language projects such as
'compileanca'
- /GNOMEC ; directory
for LINUX 'C' language GNOME visual projects such
as 'side4linux'
- /GNOMECGL ; directory for LINUX 2d/3d 'C' language GNOME visual projects with
Open GL extensions such as 'Bdesign3d'
- /GTKC
; directory
for LINUX 'C' language GTK+ visual projects using
GTKBUILDER
- /PCBS
;
directory for PCB and gEDA printed circuit board projects such as our
machine controllers.
So the 'side4linux' project
directory would then be /home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux
and the 'side4linux'
source directory would then be /home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src
The 'TREE' would now look something like
this ( Product = 'SIDEtools' in the 'TOOLS' Product Area folder ),
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/ANCA
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/AVRA
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/AVRC
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/CLC
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src/ReservedWords
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src/Help
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src/Doc
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux/src/side4linux
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMECGL
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GTKC
/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/PCBS
The IDE builds new projects with this tree in mind from the 'BASE'
directory '/home/fred/Data/Projects/SIDE'
but you may assign the base directory something else,
e.g. /home/fred
which will make /home/fred/SIDE/.... but be sure to alter the 'side4linux' config file' to suit! Some
people will just want to 'cherry pick' certain elements from the entire
project and coble them together their way which is OK provided you
follow the conditions laid out in the GPL but DO
NOT BOTHER US with
resulting Bug Reports !!!
Your System Administrator may not like you
either because we have made it easy to know where your files are stored
so that automatic backup to the Main Server will be easier. This could
be of use to you if your workstation crashes!
Do not forget to modify the
'side4linux' config file
'/home/fred/.side-dir-config/sideproject.cfg' during the first
installation and remember that there needs to be a 'side4linux'
config file in every user's home directory on this computer
configured to their
home directory!
You may have multiple IDE's open, one for the Help, one
to just look at Glade visuals, one to do the editing, one to look at
files in another Project etc. etc. but do not fall for the old
one of saving or building the same files from different invocations!
Please
Note: We aim to please,
if something in these pages appears wrong, poorly explained or is not
covered then,
provide
us with some Feedback !!