1Installation 2------------ 3To compile the sources and install on your machine you may proceed 4with the quite usual sequence: 5 6 ./configure --with-cairo 7 make 8 make install 9 10Detailed installation instructions are available inside the file INSTALL 11in this same directory. The '--with-cairo' flag enables detection and 12usage of the Cairo 2D graphic library. Be sure to have this library 13installed on your system: this is not mandatory, but will give you some 14more features (see later section). 15If you want a local installation, you may proceed as follows: 16 17 ./configure --prefix=/home/yourusername/local --with-cairo 18 make 19 make install 20 21Your system won't know where to find the Box executable. 22Therefore you may put a line such as 23 24 export PATH=$PATH:~/local/bin 25 26at the end of your bashrc file (which is a hidden file in your home 27directory: ~/.bashrc). This last modification is not needed. It just 28makes life easier. 29 30Test 31---- 32After installation, you may run some tests to see if the compilation 33suceeded. Just type: 34 35 make check 36 37You should get a final message such as: 38 39 0 errors found. 40 All tests performed led to success. 41 ... 42 43Cairo library 44------------- 45You can now compile Box with support for the Cairo 2D graphic library. 46Cairo gives support for some more output terminals (PDF, SVG, PNG, PS) 47and is going to be well exploited in the next Box releases, giving it 48many cool features. Be sure to compile Box with the '--with-cairo' flag ;-) 49 50Documentation 51------------- 52You may find the documentation on the website http://boxc.sourceforge.net/ 53The documentation is still incomplete. You may start to learn by looking 54at the examples on the examples directory. 55If you need help or found some bugs, just use the Sourceforge support request 56or send a mail to: fnch@users.sourceforge.net 57 58 59