SDLCXX(SDL)

Shore Programmer's Manual - 3 November 94

NAME

INTRO \- The SDL C++ Language Binding Generator

SYNOPSIS

sdlcxx module-name

DESCRIPTION

This is the SDL C++ Language Binding Generator. It connects to a Shore server and generates a language binding for the specified module. The binding is sent to standard output. In normal usage, standard output is redirected to a module-name.h.

The code generated by sdlcxx (called the language binding ) comprises several things:

REF(T): A set of classes embodied in the macro REF(T) (which are used as if they constituted a C++ template REF<T>, but you must remember to use parentheses rather than angle braces). The declaration and the implementation of REF(T) are generated by sdlcxx. See ref(oc) .
Class declarations: for each SDL interface in your module.
Class declarations and implementations: for the types of certain attributes: sets and bags, strings, and indexes.
Method implementations: of all class methods except those explicitly defined in the class's SDL interface description. You must provide C++ implementation for each method that is given in an SDL Interface. The implementation of the methods must be given in a C++ source file; it cannot be given in the SDL interface description; SDL does not cope with inline method definitions in class declarations.

IMPORTANT NOTE

The Shore Server process, shore, must already be running when sdlcxx is invoked.

VERSION

This manual page applies to Version 0.1 of theShore software.

SPONSORSHIP

The Shore project is sponsored by the Advanced Research Project Agency, ARPA order number 018 (formerly 8230), monitored by the U.S. Army Research Laboratory under contract DAAB07-91-C-Q518.