SCE-MI #include file name proposal


Subject: SCE-MI #include file name proposal
From: Bojsen, Per (bojsen@zaiqtech.com)
Date: Fri Sep 26 2003 - 11:03:12 PDT


Hi,

at yesterday's ITC meeting I received the action to send out a modified
proposal regarding the #include file name. Here it is:

  The C++ and C APIs shall be defined in a header file with the name

    scemi.h

  Note, name is all-lowercase.

  It is up to the implementation whether there are two distinct header
  files for C++ and C APIs or one merged file. When there are two
  distinct files, they must have the same name (hence they will appear
  in separate directories).

  Usage note for C++:

    #include <cstdlib>
    #include <scemi.h>

    int
    main(int argc, char *argv[])
    {
      SceMiParameters *parms = new SceMiParameters("ParameterFile");
      SceMi *sceMi = SceMi::Init(SCEMI_VERSION_STRING, parms);

      // etc.
    }

  Usage note for C:

    #include <stdlib.h>
    #include <scemi.h>

    int
    main(int argc, char *argv[])
    {
      SceMiParameters *parms = SceMiParametersNew("ParameterFile");
      SceMi *sceMi = SceMiInit(SCEMI_VERSION_STRING, parms);

      // etc.
    }

Additionally, I thought of the following which we did not discuss but
that I would like to amend to the proposal:

  An implementation is free to introduce other implementation-specific
  include files. However, any filename matching the shell glob scemi*.h
  is reserved for future use by SCE-MI.

Per

-- 
Per Bojsen                                Email: <bojsen@zaiqtech.com>
Zaiq Technologies, Inc.                   WWW:   http://www.zaiqtech.com
78 Dragon Ct.                             Tel:   781 721 8229
Woburn, MA 01801                          Fax:   781 932 7488



This archive was generated by hypermail 2b28 : Fri Sep 26 2003 - 11:00:39 PDT