Geneva begins by checking to see if the help display program is already in memory. If it is not, then it is loaded from disk by way of the SHOWHELP environmental variable, as set in GEM.CNF.

  Once the program is in memory, it is sent a message containing the values passed in the x_help function call. The user is then either shown the help text, or an error message saying that the topic was not found.

  The topic parameter points to a NUL-terminated string containing the help topic to search for. If sensitive is non-zero, then the case (upper/lower) of the topic must exactly match what is stored in the help file. If, however, sensitive is zero, both the case-sensitive and case-insensitive sections of the help file are searched for the topic.

  filename points to a NUL-terminated string describing the path and file name of the default help file to search for the topic. If no path information is used, then the PATH environmental variable is searched (by way of shel_find) for the file. If this file is not found, or the topic is not found in the file, the user receives an error message. If filename is NULL (0L), then the topic is only searched for in GENEVA.HLP.

int16_t x_help( int8_t *topic, int8_t *helpfile, int16_t
sensitive )
{
   int_in[0] = sensitive
   addr_in[0] = topic;
   addr_in[1] = helpfile;

   crys_if(29061);

   return ( int_out[0] );
}

  If no memory could be allocated, the addr is set to NULL (0L).

  Unlike the GEMDOS Malloc function, this function does not accept the "size" -1L.

void x_malloc( void **addr, int32_t size )
{
   (int32_t)int_in[0] = size;

   addr_in[0] = addr;

   crys_if(29062);

   return;
}
}

int16_t x_mfree( void *addr )
{
   addr_in[0] = addr;

   crys_if(29063);

   return ( int_out[0] );
}

int16_t x_mshrink( void *addr, int32_t newsize )
{
   int_in[0-1] = newsize;    /* int_in[0] MSW of the size */
                             /* int_in[1] LSW of the size (lower 16 bits) */
   addr_in[0] = addr;

   crys_if(29064);

   return ( int_out[0] );
}

int16_t x_realloc( void **addr, int32_t newsize )
{
   int_in[0-1] = newsize;    /* int_in[0] MSW of the size */
                             /* int_in[1] LSW of the size (lower 16 bits) */
   addr_in[0] = addr;

   crys_if(29065);

   return ( int_out[0] );
}

  Example:

SETTINGS set;
x_settings ( 0, sizeof(set), &set );

  Example: Temporarily disable pulldowns:

SETTINGS set;
x_settings ( 0, sizeof(set), &set ); /* get current        */
set.pulldown = 0;
x_settings ( 1, sizeof(set), &set ); /* turn off           */
...                                  /* do some stuff here */
set.pulldown = 1;
x_settings ( 1, sizeof(set), &set ); /* turn back on       */

int16_t x_settings ( int16_t getset, int16_t length, SETTINGS
*user )
{
   int_in[0] = getset;
   int_in[1] = length;
   addr_in[0] = user;

   crys_if(29056);

   return ( int_out[0] );
}

Example:                                   Result:
x_sprintf( str, "%04x", 0xFE );            00FE
x_sprintf( str, "%-06s", "Hi!" );          Hi!000
x_sprintf( str, "%6s", "Hi!" );            Hi!
x_sprintf( str, "%b %v", 2, 0x502 );       T 5.02
x_sprintf( str, "%S %s", "a b", "c d" );   {a b} c d
KEYCODE key = { 1, 0, 'X' };
x_sprintf( str, "key=%k", &key );          keyd 1 00 58

void x_sprintf( int8_t *buf, int8_t *fmt, ... )
{
   addr_in[0] = buf;
   addr_in[1] = fmt;
   addr_in[2] = &...;

   crys_if(29059);

   return;
}

Example:                                   Result:
int i;
char str[10], str2[10], bool;
KEYCODE key;
x_sscanf( "FE", "%x", &i );                i = 0xFE
x_sscanf( "Hi!", "%s", str );              str = "Hi!"
x_sscanf( "T 5.02", "%b %v", &bool, &i );  bool = 1, i = 0x502
x_sscanf( "{a b} c", "%S %s", str, str2 ); str = "a b", str2 = "c"
x_sprintf( "01 00 58", "%k", &key );       key = { 1, 0, 58 };

void x_sscanf( int8_t *buf, int8_t *fmt, ... )
{
   addr_in[0] = buf;
   addr_in[1] = fmt;
   addr_in[2] = &...;

   crys_if(29060);

   return;
}