Installing the complete side4linux package. Version 0.1.3 ========================================================== On decompressing the TAR file you will have some text files such as this one and a complete 'SIDE' directory structure which needs to be placed into the correct directory which you are about to make with the following instructions. If you do not agree with our recommendations that is fine, alter the setup and the 'sideproject.cfg' file to suit! 1. Create the 'SIDE base directory' as '/home/yourusername/Data/Projects' then copy the 'SIDE' directory structure there.... Remember that there needs to be a 'side4linux' config file in every users home directory on this computer configured to their own SIDE directory and that every user also requires their own SIDE directory structure. This paradigm allows multiple invocations of 'side4linux' with separate project space for each user on the same machine. So if your username was 'fred' the correct'SIDE base directory' for you is, '/home/fred/Data/Projects/SIDE' Using your file browser navigate to.. '/home/fred/Data/Projects/SIDE/TOOLS/SIDEtools/GNOMEC/side4linux' We must now copy the configuration folder to your 'home' directory and alter the 'sideproject.config' file within to point to your new side4linux setup. Set your file browser ( e.g. Nautilus ) to see the '.side-dir-config' folder View>Show Hidden Files Now copy this folder to your 'home' directory and open the folder, you will find the 'sideproject.config' file to alter here. contents on first opening ( user = db ) might be.. SIDEPROJECTCONFIG,EOL PROJECTHOME,/home/db/Data/Projects/SIDE,EOL PDELAY,8,EOL EDITORFONT,FreeMono Medium 14,EOL EOP,EOL and altered to suit user 'fred' would then be saved as... SIDEPROJECTCONFIG,EOL PROJECTHOME,/home/fred/Data/Projects/SIDE,EOL PDELAY,8,EOL EDITORFONT,FreeMono Medium 14,EOL EOP,EOL Save the config file and reset your file browser to hide 'hidden' files and you are done with configuration for now. Next we will build and install the IDE into the directory /opt/Side. 2. Read the 'README-FIRST.txt' file before you read on if there is one! 3. Open a super user 'root' terminal program in the directory, /home/yourusername/Data/Projects/SIDE and run the build/install program as follows, 'sh Build.sh' This is good as it will test your system to see if you have the full compliment of libraries needed. If not then check your distribution's repository or download and install from source code via the Internet. Or do the two exercises provided, 'setup C build environment.txt' & 'setup GNOME build environment.txt'. 4. If you are really new to Linux then get a late copy of the 'side4linux DVD' from Adelaide Aeromotive Pty Ltd, who can then provide more specialised email support. (email me, David Burke via the sourceforge side4linux website ). 5. Late model GNOME friendly distributions should work very well with this IDE but KDE distributions such as Mandrake may mean looking for some additional RPM's or downloading source code for GNOME, GLADE2 and GTK+, do a search on the Internet for their respective websites if that is the case. 6. Installing 'Help Packages'. As time goes by there will be a need to install additional packages such as help files e.g. to install the GNOMEC help package 'GNOMEChelp-2008-2.tar'.gz, i/ Go to the project download area and download 'GNOMEChelp-2008-2.tar.gz'. ii/ Put the TAR in a temporary folder and unpack there using Nautilus, Right click on the file and left click on 'Extract Here'. iii/ Change to the unpacked TAR top directory. iv/ Open a terminal as super user 'root' and enter the following command ( note you must be user 'root', sudo will not do here! ) sh Install.sh iv/ and your done! 7. Installing 'Support Packages'. Keep in mind that support packages call the 'xterm' program which you should already have loaded as part of the requirements to run side4linux. As time goes by there will be a need to install additional packages such as support files e.g. to install the PCBS support package, 'PCBSsupport-2008-2.tar.gz', i/ Go to the project download area and download 'PCBSsupport-2008-2.tar.gz'. ii/ Put the TAR in a temporary folder and unpack there using Nautilus, right click on the TAR file and left click on 'Extract Here'. iii/ Change to the unpacked TAR top directory. iv/ Open a terminal as super user 'root' and enter the following command ( note you must be user 'root', sudo will not do here! ) sh Build.sh iv/ and your done! v/ If you strike errors installing 'Support Packages' you may not have loaded all of the required libraries which for the current PCBS Package is, Scheme scripting library - GUILE V1.6.7 or later. Stroke gesture library - libstroke V0.5.1 or later. PNG library - libpng V1.2.1 or later. Compression library - zlib V1.1.4 or later. GD graphics library - libgd2-xpm-dev 2.0.33 or later. or get the source from Homepage: http://www.libgd.org On Ubuntu based systems 'guile' amounts to the following (or something fairly close), guile-1.6_1.6.7-1ubuntu3_i386.deb guile-common_1%3a1.4-26_all.deb guile-1.6-dev_1.6.7-1ubuntu3_i386.deb guile-g-wrap_1.9.6-2ubuntu2_i386.deb guile-1.6-libs_1.6.7-1ubuntu3_i386.deb guile-library_0.1.2-1_all.deb guile-1.6-slib_1.6.7-1ubuntu3_all.deb On Debian 4.0 based systems 'guile' amounts to the following (or something fairly close), guile-1.6_1.6.8-6_i386.deb guile-1.6-dev_1.6.8-6_i386.deb guile-g-wrap_1.9.6-3.1_i386.deb guile-1.6-libs_1.6.8-6_i386.deb guile-library_0.1.2-1_all.deb guile-1.6-slib_1.6.8-6_all.deb plus we are building Gnome programs so you need the full Gnome build environment including the following on your system, autotools - autoheader, automake, autoconf, aclocal libglibc2-dev cairo-dev pango-1-dev glib2-dev gtk2-dev freetype2 gawk ( or mawk ) flex bison xterm tk8.4-dev - TK toolkit including tcl8.4 If you cannot get Debs or RPMs to suit you can always download the source and compile and install the libraries yourself. Should you get stuck at a lack of a 'guile' library (e.g. during compiling libGEDA) then open a 'root' terminal in that affected directory and issue the './configure' command which will shorten the build process down to where the error is generated while you figure out what library you are missing (saves having to wait while re-installing non-critical stuff like symbol libraries and programs that have already been successfully loaded etc.). Notice the 'dev' packages. By selecting these with your package manager you will be getting all of the header or 'h' files and it will pull in any libraries associated. If you are unfortunate in not getting the pcb and gEDA programs to work then start the IDE in a terminal and look for error messages for missing files or libraries. 8. 'side4linux' does not do something that you want? Make a comment in the general Forum on the Sourceforge side4linux project site and please forgive us as our mind reading efforts have diminished with advancing age ;) DB. Adelaide, South Australia, 2009 Note: What would really make this file great is your feedback on it's suitability and accuracy, so if something is done wrong or is misleading then we must know as soon as possible!! To this end then you are encouraged to leave a message in the 'Help' forum on the 'side4linux' project page. Never think that someone else will do it or that you are not experienced enough to say something. It could be said that 'uber code cutters' will get by even without any documentation at all but the less experienced will benefit from your generous gift.