cygport/cygclass/rox.cygclass

Cygport Reference Manual

### TABLE OF CONTENTS

- rox.cygclass

- CATEGORY (rox)
- SUMMARY (rox)
- DESCRIPTION (rox)
- HOMEPAGE (rox)
- ROX_APP
- ROX_WRAPPER
- rox_autoreconf
- rox_compile
- rox_install
- src_compile (rox)
- src_install (rox)

## rox.cygclass

[ Top ] [ Cygclasses ] [ Cygclasses ]

SYNOPSIS

      inherit rox

DESCRIPTION

The ROX Desktop is based on RISC OS. The desktop revolves around the file manager and drag-and-drop is used instead of Open/Save file dialogs.

ROX applications are standalone application directories (AppDirs) which can be run from anywhere without installation. Most applications are written in Python with ROX-Lib2 and some are written in C with ROX-CLib; either way, GTK+ is used as the underlying toolkit.

This cygclass handles the building and installing of ROX packages. AppDirs are installed under /usr/lib/rox.

INHERITS

python.cygclass

## CATEGORY (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    CATEGORY="ROX"

## SUMMARY (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    SUMMARY="ROX Desktop ${ORIG_PN} component"

## DESCRIPTION (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    DESCRIPTION="ROX is a fast, user friendly desktop based on RISC OS which makes
    extensive use of drag-and-drop. The interface revolves around the file manager,
    or filer, following the traditional Unix view that 'everything is a file' rather
    than trying to hide the filesystem beneath start menus, wizards, or druids."

## HOMEPAGE (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    HOMEPAGE="http://rox.sourceforge.net/desktop/"

## ROX_APP

[ Top ] [ rox.cygclass ] [ Variables ]

DESCRIPTION

The name of the directory containing the AppRun script. This variable is required.

NOTE

Often this directory is the toplevel of the tarball, in which case SRC_DIR must be set to '.'.

## ROX_WRAPPER

[ Top ] [ rox.cygclass ] [ Variables ]

DESCRIPTION

Due to the DnD nature of the ROX desktop, most applications are not usable outside the filer. For the exceptions (e.g. OroboROX window manager) or for the filer (rox) and session manager (rox-session) which need to be launched from the command line (or in .xinitrc), define ROX_WRAPPER to the name of the wrapper script. This wrapper will be installed in /usr/bin.

## rox_autoreconf

[ Top ] [ rox.cygclass ] [ Compile Functions ]

DESCRIPTION

Runs autoconf, the only autotool which is generally used in ROX C packages, in order to pick up any patches to configure.{ac,in}.

REQUIRES

autoconf

## rox_compile

[ Top ] [ rox.cygclass ] [ Compile Functions ]

DESCRIPTION

This function builds a ROX C package through the AppRun script.

NOTE

Be aware that some AppRun scripts create the executable in a platform-specific subdir, named based on uname(1) output. Because Cygwin's `uname -s` also contains the Windows version, applications compiled on one computer will not be found on another if their underlying Windows versions differ. To avoid this, change the definition of PLATFORM in AppRun (and AppletRun, if it exists) from

        PLATFORM=`uname -s`-$ARCH

to

        PLATFORM=CYGWIN-$ARCH

This will allow the application to run on all Cygwin installations.

## rox_install

[ Top ] [ rox.cygclass ] [ Install Functions ]

DESCRIPTION

Install the (possibly compiled) AppDir into ${D}/usr/lib/rox, removes extraneous files (e.g. sources), compiles Python modules, and creates the wrapper script if ROX_WRAPPER is defined.

## src_compile (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    src_compile() {
            lndirs
            if [ -d ${S}/${ROX_APP}/src ]
            then
                    cd ${B}/${ROX_APP}/src
                    rox_autoreconf
                    cd ${B}/${ROX_APP}
                    rox_compile
            fi
    }

## src_install (rox)

[ Top ] [ rox.cygclass ] [ Overloads ]

DEFINITION

    src_install() {
            cd ${B}
            rox_install
    }