1. Open 'side4linux' and click on 'Project>Open Project' in the Main Menu.
2. Double click on the 'DEMOS' Product Area,
3. Double click on the 'SIDEdemos' Product,
4. In the file dialog double click the 'CLC' folder, this takes you to where 'C' command line projects are kept.
5. Double click on 'Testlibs', this opens the 'Testlibs' project folder.
6. Notice that project names are set to be an upper case letter followed by lower case letters (easier on the IDE's Project management routines).
7. Double click on 'testlibs.prf', this opens the 'Testlibs' project file.
8. Notice that the left bottom status bar window says 'Project: Testlibs' which is the Project Name
9. Notice that the next window says 'Ptype: CLC' which is the Project Type.
10. Click on the 'Open' toolbar button, observe the two files 'main.c', 'main.h'
    
11. and double click on 'main.c' to open it.
12. Click on the 'I-Libs' tab to the left of the Notebook and notice that there is a static library called 'internalExample'.
13. Notice the 'main.c' file in the 'Notebook' has at line-23,   #include "libinternalExample/hello.h".
14. Notice the 'main.c' file in the 'Notebook' has at line-27,   sayHello();   the function to call from the static library.
15. Now click on the 'Build' toolbar button the Output Window should end with  +++ Successful Make command! +++
16. and you should see something like this in the following screen shot,

From the screen shot above you can see that the 'Output window' has the output from the 'C' compiler and the
'Status bar' says 'Pbuild: OK!'

Now let us run the compiled binary by opening a terminal in the 'src' directory as follows,

Using 'Nautilus' change to the --SIDE/CLC/Testlibs/src directory




If you have loaded the 'Open with terminal' option from Synaptic Program Manager right click on the Nautilus window and left click on the 'Open with Terminal' option which will open a terminal, then type './testlibs' in the terminal window and press the 'Enter' key.
This should result in the following text to appear on the terminal window (or something similar containing the line 'Hello World!',

db@wks1:~/Data/Projects/SIDE/CLC/Testlibs/src$ ./testlibs

Hello World!
db@wks1:~/Data/Projects/SIDE/CLC/Testlibs/src$

The './' at the start of the program name means 'to launch the copy of the program in the current folder'

Leave this copy of side4linux open so that you can refer back to this demo example.

Now change to another workspace where you will build a new command line 'C' project.
You will use this new project to continue this Demo.

---

Step-2 Creating a static library.

Let us start by making a new 'C' command line program called 'trystaticlib'

1. Open 'side4linux' and click on 'Project>New Project' in the Main Menu.
2. Select 'Command Line 'C' Program' and click on 'NEXT' in the 'Select New Project Type' Dialog Box.
   
3. Select the 'PRODUCTS' Product Area in the Product Selection Dialog and click on 'OK',
4. Select 'MC-1' from the Product Area selection Combo Box and click on the 'Next' button,
5. In the New Project dialog enter the name of 'trystaticlib' and click on 'Build'.
6. Once the Project is 'Built', close and then re-open it to let things settle into place.
   
7. 'Project>Close Project'
8. 'Project>Open Project'
   
9. Double click on the 'PRODUCTS' Product Area,
10. Double click on the 'MC1' Product,
11. In the file dialog double click the  'CLC' folder, this takes you to where command line 'C' language projects are kept.
12. Double click on 'Trystaticlib', this opens the 'Trystaticlib' project folder.
    
13. Double click on 'trystaticlib.prf', this opens the 'Trystaticlib' project file.
14. Left click the tabs on the left hand side of the 'Notebook' and notice the file tree results, this is the 'Project File Tree Explorer'
    
1. Visual  ( nothing here )
2. Files    ( main )
3. D-Libs ( m ) = maths  'libm.so' dynamic library added automatically by the new project process.
4. I-Libs  ( Internal Static libraries, but nothing here, yet. )

• Let us create our new library in --/SIDE/PRODUCTS/MC1/CLC/Trystaticlib/src,
• Using Nautilus, change to our new project's 'src' folder and create a new folder called 'libStatic'.
• Change to the 'libStatic' folder and create the following files in this folder with a text editor such as 'gedit' as follows,

Filename	Contents
Makefile.am	noinst_LIBRARIES = libStatic.a libStatic_a_SOURCES = hello.c
hello.c	#include <stdio.h>   void sayHello(void) {   printf("Hello World! \n"); }
hello.h	void sayHello(void);

Hint: Make sure that there is a blank line above and below your source code in case the compiler you are using complains!
         ( a completed copy of this project is stored in -/SIDE/PRODUCTS/MC1/CLC/HelpStaticLib for your reference in case of trouble )
Note: Notice that filenames mentioned here are 'case sensitive' so 'Makefile.am' is not the same as 'makefile.am' !!!!!     

• Let us now add the new library to the 'Trystaticlib' project,
• In the side4linux IDE, click on 'Project>Libraries>Add Library>Add Internal'
• In the dialog box that opens type in 'Static' ( note leave off the 'lib' as it is presumed to already exist! ).
• Click on 'OK' in the dialog and click on 'OK' in the next dialog to re-build the project.
• Click on the 'Build' button and notice the following line in the 'Output Window',
• make[3]: Entering directory `/home/db/Data/Projects/SIDE/PRODUCTS/MC1/CLC/Trystaticlib/src'
  /bin/bash ../libtool --tag=CC   --mode=link gcc -Wall -g -g -O2   -o trystaticlib main.o -lm -LlibStatic -lStatic 
• Notice the part  ' -lm -LlibStatic -lStatic ' this says you have dynamically linked in the maths library ' libm.so ' and statically linked in ' libStatic.a '

• Let us now 'call' the ' sayHello ' function in our new statically linked library
• Click on the 'TXT' button in the IDE and open 'main.c' and edit it as follows,

Filename	Contents
main.c	#include <stdarg.h> #include "libStatic/hello.h"                     // from "libStatic" our example of an internal statically linked library for side4linux int main(int argc, char *argv[]) {   sayHello();                                             // calling a function from our new library   return(0); }

• Now click on the 'Build' button in the IDE and check that the 'Output Window' ends with  +++ Successful Make command! +++

db@wks1:~/Data/Projects/SIDE/PRODUCTS/MC1/CLC/Trystaticlib/src$ ./trystaticlib
Hello World!
db@wks1:~/Data/Projects/SIDE/PRODUCTS/MC1/CLC/Trystaticlib/src$