ROX libraries

There are two libraries available:

• ROX-CLib 1.0, for GTK+ 1.2
• ROX-CLib 2.0 for GTK+ 2.0

ROX-CLib 2

This is a release of ROX-CLib updated to work with GTK+ 2. In addition it contains code for options similar to that in ROX-Filer.

If you install this you should update the programs which use the library at the same time.

More information, including the downloads, is available at the ROX-CLib page.

If you use Archive to extract it from the downloaded archive then make sure you rename it to ROX-CLib.

ROX-CLib

This version is now obselete and should only be used if you cannot run GTK+ 2. Use Version 2.0 instead.

This is a library implemented using the application directory system.

ROX-CLib uses a variant of the standard AppRun file. It supports automatic compilation, but this is intended to produce a library. It does generate an executable, one that behaves like the gtk-config program in GTK+: it echos the options to add for compiling or linking with the library.

Versions up to 0.1.12 only support static libraries. Shared libraries are supported from 0.2.0 onwards.

To use this, first compile the library using ROX-CLib/AppRun --compile, then ensure that the run_rox program is in your PATH.

In your AppRun file you will need:

  if [ -z "$LD_LIBRARY_PATH" ]; then
    LD_LIBRARY_PATH=`rox_run ROX-CLib --runtime`
  else
    LD_LIBRARY_PATH=`rox_run ROX-CLib --runtime`:$LD_LIBRARY_PATH
  fi
  export LD_LIBRARY_PATH

My C apps and applets all use this.

Here is the recently added HTML help file.

If you have any questions or comments about this, please email me.

Requires

If you are using packages such as rpm or dev then you need the -devel versions.

• GTK 1.2.x (where x>=8), gtk-devel if using packages.
• libxml2, libxml2-devel if using packages.

Updated

• Tue 01st May 2001
• Wed 09th May 2001, added test program which links to the test library.
• 0.1.0 Tue 17th July 2001, first release of the re-named ROX-CLib.
• 0.1.1 Mon 23rd July 2001, better install (?), some documentation added.
• 0.1.2 Mon 20th August 2001, some minor fixes.
• 0.1.3 Wed 29th August 2001, fix a drag and drop bug where the files would be passed twice.
• 0.1.4 Change to compilation system: each app should have its own rox_run.
• 0.1.5 Mon 05th November 2001, added an internaltionalized resources system.
• Really 0.1.5 Thu 29th November 2001 fixed the internaltionalized resources system.
• 0.1.6 Wed 05th December 2001, added SOAP routines to talk to the filer.
• 0.1.7 Fri 07th December 2001, more work on rox_soap trying to get rox_filer_file_type() to work
• 0.1.8 Mon 07th January 2002, updated SOAP namespaces for 1.1.10 filer, added rox_filer_version(), added rox_pinboard.c as example of SOAP use.
• 0.1.9 Thu 10th January 2002, added support for positioning of applet menus (needs 1.1.11 filer or later).
• 0.1.10 Wed 13th February 2002, better way of accessing web site (by running a URI file), improvement to language checking in rox_resources.c, visit by the const fairy in choices.h, updated pkg program to check for libxml2, added rox.c to access ROX-CLib's version number.
• 0.1.11 fixed typo in rox_filer_pinboard().
• 0.1.12 Mon 25th February 2002, fix problem with XML config.
• 0.2.0 Mon 04th March 2002, now builds a shared library.
• 0.2.1 Wed 20th March 2002, added SOAP server.
• 0.2.2 Mon 29th April 2002, changed the applet positioning code (replaced two functions with 1).
• 0.2.3 Mon 12th August 2002, fix problems including the libxml file.
• 1.0.0 Sat 7th December 2002. Stable release.

Downloads

• Download the 143K library (1.0.0, with shared library support).

Stephen Watson webmaster@kerofin.demon.co.uk
Comments?

Last modified: Sat May 21 12:08:28 BST 2005