diff --git a/doc/funcref.sgml b/doc/funcref.sgml index 60b8360ed..cc45d9037 100644 --- a/doc/funcref.sgml +++ b/doc/funcref.sgml @@ -744,8 +744,7 @@ communication. + The function is actually a macro. + The function is actually a macro. + The function is actually a macro. + The function is actually a macro. A "regular file" means anything with data in it. This might still mean that special processing is needed, when accessing the file. Relative files of @@ -841,8 +837,7 @@ the CBM systems are classified as being "regular" files, for example. / + The minimum blocksize that can be added is 6 bytes; the function will ignore smaller blocks. @@ -870,8 +865,7 @@ ignore smaller blocks. /, / or /. - + Passing a pointer to a block that was is not the result of one of the allocation functions, or that has been free'd will give unpredicable results. @@ -921,8 +915,7 @@ be allocated from the heap using /. + This function is of less use than usually assumed, since the returned heap space may be available but not in one block. So even if this function says that several times more heap space is available than needed, / with an argument of + Since operating system specific error code are - you guessed it - operating system specific, the value in + The randomness of the seed depends on the machine hardware. + Since operating system specific error code are - you guessed it - operating system specific, the parameter and the string returned depend on the cc65 target. @@ -1028,7 +1020,7 @@ used in presence of a prototype. + The memory areas may not overlap, otherwise the results are undefined. The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1054,7 +1046,7 @@ specified in the + Bits 4 and 5 of the flags value in the The function is only available as fastcall function, so it may only be @@ -1075,7 +1067,7 @@ used in presence of a prototype. + The function is actually a macro. The inserted instruction may lead to unexpected results if no debugger is present. @@ -1099,7 +1091,7 @@ is present. + The function is actually a macro. Disabling interrupts may lead to unexpected results. @@ -1121,7 +1113,7 @@ already enabled (the default). + The function is actually a macro. This function depends highly on the platform and environment. @@ -1144,7 +1136,7 @@ and return the value read. + The function is actually a macro. This function depends highly on the platform and environment. The order in which the two bytes are read is unspecified and may @@ -1168,7 +1160,7 @@ depend of the address expression used. + The function is actually a macro. This function depends highly on the platform and environment. Careless use will cause the program to act strange or may crash the @@ -1193,7 +1185,7 @@ machine. + The function is actually a macro. This function depends highly on the platform and environment. Careless use will cause the program to act strange or may crash the @@ -1220,7 +1212,7 @@ depend of the address expression used. + The function is actually a macro. Disabling interrupts may lead to unexpected results. @@ -1261,7 +1253,7 @@ on stderr, then terminates the program with an exit code of 3. + The return value is undefined if The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1284,7 +1276,7 @@ used in presence of a prototype. + The function is actually a macro. + A maximum of 5 exit functions can be registered. There is no way to unregister an exit function. The function is only available as fastcall function, so it may only be @@ -1366,7 +1358,7 @@ atmos_save("hires", 0xa000, 0xc000); + There is no way to detect any conversion errors. The function does not check for an numerical overflow when converting. The function is only available as fastcall function, so it may only be @@ -1393,7 +1385,7 @@ used in presence of a prototype. + There is no way to detect any conversion errors. The function does not check for an numerical overflow when converting. The function is only available as fastcall function, so it may only be @@ -1421,7 +1413,7 @@ used in presence of a prototype. + Background colors are system dependent. The function may have no effect on systems where the background color cannot be changed. The function is only available as fastcall function, so it may only be @@ -1445,7 +1437,7 @@ used in presence of a prototype. + Border colors are system dependent. The function may have no effect on systems where the border color cannot be changed. The function is only available as fastcall function, so it may only @@ -1474,8 +1466,7 @@ matches the one pointed to by + The contents of the array must be sorted in ascending order according to the compare function given. If there are multiple members that match the key, the function will @@ -1500,8 +1491,7 @@ be used in presence of a prototype. + The function is non standard and therefore only available in non ANSI mode. You should use / instead. The function is only available as fastcall function, so it may only @@ -1526,7 +1516,7 @@ be used in presence of a prototype. / + The function is specific to the C128. The function will not return to the caller. @@ -1547,8 +1537,7 @@ be used in presence of a prototype. of size + Clearing the memory may not have the expected effect on all platforms: pointers in the block may not be + + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1659,7 +1648,7 @@ address as the current secondary address. If the device on the channel is a serial device, which requires a TALK command and sometimes a secondary address, function will send them over the serial bus. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1687,7 +1676,7 @@ secondary address if necessary. This routine always buffers the current character, and defers sending it until the next byte is buffered. When the UNLISTEN command is sent, the last byte will be sent with an End or Identify (EOI). - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1716,7 +1705,7 @@ file, its device as the current device, and its secondary address as the current secondary address. If the device on the channel uses the serial bus, and therefore requires a LISTEN command and possibly a secondary address, this information will be sent on the bus. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1739,7 +1728,7 @@ only be used in presence of a prototype. + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1787,7 +1776,7 @@ the screen. Also, if the current input device was formerly a serial device, the routine sends it an UNTALK command on the serial bus, and if a serial device was formerly the current output device, the routine sends it an UNLISTEN command. - + / + + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1888,7 +1877,7 @@ loaded into memory starting at the location specified by the header. Function returns the address of the highest RAM location loaded. Before this function can be called, the KERNAL SETLFS, and SETNAM routines must be called. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1914,7 +1903,7 @@ Input/Output operations. In order to specify the logical file number, the device number, and the secondary address if any, the cbm_k_setlfs() function must first be called. Likewise, in order to designate the filename, the cbm_k_setnam() function must be used first. After these two functions are called, cbm_k_open() is then called. - + / + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -1980,7 +1969,7 @@ only be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2001,7 +1990,7 @@ only be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2024,7 +2013,7 @@ only be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2050,7 +2039,7 @@ bus. Only devices previously commanded to LISTEN are affected. This function is normally used after the host computer is finished sending data to external devices. Sending the UNLISTEN commands the listening devices to get off the serial bus so it can be used for other purposes. - + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2094,7 +2083,7 @@ at a specific screen position. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2118,7 +2107,7 @@ only be used in presence of a prototype. no character available, + If the system supports a keyboard buffer, @@ -2140,7 +2129,7 @@ from this buffer and wait only if the buffer is empty. + The character used to draw the horizontal line is system dependent. If available, a line drawing character is used. Drawing a line that is partially off screen leads to undefined behaviour. @@ -2166,7 +2155,7 @@ used in presence of a prototype. + The character used to draw the horizontal line is system dependent. If available, a line drawing character is used. Drawing a line that is partially off screen leads to undefined behaviour. @@ -2192,7 +2181,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2216,7 +2205,7 @@ used in presence of a prototype. time used by the program. The time is returned in implementation defined units. It can be converted to seconds by dividing by the value of the macro + Since the machines, cc65 generated programs run on, cannot run multiple processes, the function will actually return the time since some implementation defined point in the past. @@ -2257,7 +2246,7 @@ the upper left corner. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2280,7 +2269,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2303,7 +2292,7 @@ be used in presence of a prototype. + / with The function is only available as fastcall function, so it may only @@ -2329,7 +2318,7 @@ be used in presence of a prototype. formatted according to the format string given. The resulting string is output to the console. /. --> - + Like all other @@ -2354,7 +2343,7 @@ between + Like all other The function is only available as fastcall function, so it may only @@ -2381,7 +2370,7 @@ be used in presence of a prototype. + Like all other The function is only available as fastcall function, so it may only @@ -2408,7 +2397,7 @@ be used in presence of a prototype. + Like all other The function is only available as fastcall function, so it may only @@ -2435,7 +2424,7 @@ be used in presence of a prototype. + Like all other The function is only available as fastcall function, so it may only @@ -2463,7 +2452,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2485,7 +2474,7 @@ be used in presence of a prototype. + The character used to draw the vertical line is system dependent. If available, a line drawing character is used. Drawing a line that is partially off screen leads to undefined behaviour. @@ -2511,7 +2500,7 @@ used in presence of a prototype. + The character used to draw the vertical line is system dependent. If available, a line drawing character is used. Drawing a line that is partially off screen leads to undefined behaviour. @@ -2537,8 +2526,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2562,7 +2550,7 @@ the contents of the memory window have been changed, these changes may be lost if /, /, / or / are called without calling + Calling + Calling / first, or the changes are lost. @@ -2620,7 +2608,7 @@ loaded. + Calling / first, or the changes are lost. @@ -2649,7 +2637,7 @@ loaded. + Not all drivers are able to detect if the supported hardware is really present. The function is only available as fastcall function, so it may only be @@ -2675,7 +2663,7 @@ used in presence of a prototype. + Not all drivers are able to detect if the supported hardware is really present. The function is only available as fastcall function, so it may only be @@ -2705,7 +2693,7 @@ into a buffer. If you don't need the actual contents of the page (for example because you're going to overwrite it completely), it is better to call / instead. + Calling / first, or the changes are lost. @@ -2733,7 +2721,7 @@ loaded. + The function returns zero if no extended memory driver is loaded. The function may return zero if the supported hardware was not detected. @@ -2754,7 +2742,7 @@ by the driver in 256 byte pages. + If the driver has been loaded using /, / should be used instead of + The function does nothing if no driver is loaded. /, but will not transfer data into the actual memory window in the assumption that the existing data is wrong or will get overwritten. - + Calling / first, or the changes are lost. @@ -2834,7 +2822,7 @@ output is written and any functions registered with / are called. Common values for status are /. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. It depends on the host machine if the program return code can be @@ -2863,7 +2851,7 @@ the command line specified as second argument. Instead of an empty string, a + The function is only available as fastcall function, so it may only be used in presence of a prototype. On most platforms, the function needs to copy a small stub loader to @@ -2893,7 +2881,7 @@ program, it may not be able to read it. + The function is specific to the C128. 2MHz clock will not work in 40 column mode. @@ -2916,7 +2904,7 @@ will nearly double the speed compared to slow mode. + The indicator is set only after a read past the end of a file is attempted. The function is only available as fastcall function, so it may only be @@ -2940,7 +2928,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -2963,7 +2951,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. Mixing C file I/O functions and POSIX file I/O functions for the same @@ -2991,8 +2979,7 @@ file may have unpredictable results. /, / or /. As an exception, if the passed pointer is + Passing an already free'd block to The function is only available as fastcall function, so it may only @@ -3024,7 +3011,7 @@ be used in presence of a prototype. all supported targets. If it exists, it returns a number that identifies the operating system or machine type, the program runs on. The machine dependent header files define constants that can be used to check the return code. - + The function does not exist on all platforms. The return codes are platform dependent. @@ -3047,7 +3034,7 @@ returns one of the constants - + Other, more exotic CPU types are not disinguished. matches + What exactly is stored in the environment depends on the machine the program is running on. The function is only available as fastcall function, so it may only @@ -3097,7 +3084,7 @@ preceeded by a '-'. found on the command line and + The implementation will not reorder options. A non option on the command line will terminate option processing. All remaining arguments are not recognized as options, even if the start with a '-' character. @@ -3120,7 +3107,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. Invalid values for the X position (out of screen coordinates) may @@ -3147,7 +3134,7 @@ lead to undefined behaviour. + The function is only available as fastcall function, so it may only be used in presence of a prototype. Invalid values for any of both coordinates (out of screen positions) may @@ -3174,7 +3161,7 @@ lead to undefined behaviour. + The function is only available as fastcall function, so it may only be used in presence of a prototype. Invalid values for the Y position (out of screen coordinates) may lead @@ -3201,7 +3188,7 @@ to undefined behaviour. + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + When compiling with + There are no provisions to prevent a buffer overflow. If The function is non standard, so it is not available in strict ANSI mode. @@ -3724,7 +3711,7 @@ used in presence of a prototype. + A joystick driver must be loaded using before calling this function. The function returns the number of joysticks supported by the driver. @@ -3749,7 +3736,7 @@ There's no way to check for the number of actually connected joysticks. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -3773,7 +3760,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -3797,7 +3784,7 @@ used in presence of a prototype. . - + A joystick driver must be loaded using before calling this function. The function is only available as fastcall function, so it may only be @@ -3823,7 +3810,7 @@ used in presence of a prototype. + A joystick driver must be installed using before calling this function. @@ -3847,7 +3834,7 @@ name="joy_install"> before calling this function. + A joystick driver must be loaded using before calling this function. @@ -3868,7 +3855,7 @@ name="joy_load_driver"> before calling this function. + If the system does not support a keyboard buffer (most systems do), the function is rather useless. @@ -3890,7 +3877,7 @@ do), the function is rather useless. + The return value is undefined if The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -3912,7 +3899,7 @@ used in presence of a prototype. + There are no provisions to prevent a buffer overflow. If The function is non standard, so it is not available in strict ANSI mode. @@ -3941,7 +3928,7 @@ used in presence of a prototype. + cc65 supports only the "C" locale, so even after setting a new locale using /, the structure returned will always be the same. @@ -3966,8 +3953,7 @@ data in /. Program execution continues as if the call to / has just returned the value + If the parameter The function is only available as fastcall function, so it may only @@ -3991,8 +3977,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4022,7 +4007,7 @@ be used in presence of a prototype. (converted to a char) in the block of raw memory string pointed to by + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4045,8 +4030,7 @@ be used in presence of a prototype. pointed to by + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4070,8 +4054,7 @@ be used in presence of a prototype. + The result is undefined if the memory areas do overlap. Use / to copy overlapping memory areas. The function is only available as fastcall function, so it may only @@ -4097,8 +4080,7 @@ be used in presence of a prototype. + While /. The function is only available as fastcall function, so it may only @@ -4123,8 +4105,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4148,7 +4129,7 @@ be used in presence of a prototype. / function. - + The pointer passed as parameter is the pointer to the module memory, not the pointer to the control structure. @@ -4179,7 +4160,7 @@ the module just loaded. Possible error codes are: - + The linker is needed to create relocatable o65 modules for use with this function. @@ -4199,7 +4180,7 @@ relocatable o65 modules for use with this function. / + The function does not check if the mouse cursor is currently within the given rectangle. Placing the mouse cursor within the bounding box is the responsibility of the programmer. @@ -4228,7 +4209,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4270,7 +4251,7 @@ return value. code);/ + The function will return "Unknown error" for invalid error codes. The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4315,7 +4296,7 @@ mouse. + The / instead. @@ -4346,7 +4327,7 @@ pointer. Defaults for these routines are supplied by the library, so if you can live with these defaults (which are platform specific), just pass a pointer to + Not all drivers are able to detect if the supported hardware is really present. After installing a driver, the mouse cursor is hidden. @@ -4376,7 +4357,7 @@ different IOCTL functions, and the + Calling this function is non portable, because each driver may implement different ioctl calls (or none at all). The function is only available as fastcall function, so it may only be @@ -4402,7 +4383,7 @@ function returns an error code that tells if the call has been successful. The routines needed to move or hide/show the mouse pointer. Defaults for these routines are supplied by the library, so if you can live with these defaults (which are platform specific), just pass a pointer to + The driver is loaded by name, so currently you must know the type of mouse that should be supported. There is no autodetect capability. Not all drivers are able to detect if the supported hardware is really @@ -4430,7 +4411,7 @@ used in presence of a prototype. + The function does not check if the new position is within the bounding box specified with /. The function is only available as fastcall function, so it may only be @@ -4454,7 +4435,7 @@ used in presence of a prototype. + The / instead. @@ -4498,7 +4479,7 @@ that is shared between / and + If the driver has been loaded using /, / should be used instead of + The function does nothing if no driver is loaded. + The function is actually a macro. + POSIX specifies an additional + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4611,8 +4592,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. This function may be a macro depending on the compiler options. The @@ -4642,8 +4622,7 @@ actual function is accessible by #undef'ing the macro. system bank (bank 15) of the CBM PET-II machines and returns it. Following the usual 6502 conventions, the low byte is read from + The function is only available as fastcall function, so it may only be used in presence of a prototype. The order in which the two bytes are read is undefined. @@ -4672,8 +4651,7 @@ is not / with an argument of + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4696,8 +4674,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4725,8 +4702,7 @@ be used in presence of a prototype. system bank (bank 15) of the CBM PET-II machines. Following the usual 6502 conventions, the low byte of + The function is only available as fastcall function, so it may only be used in presence of a prototype. The order in which the two bytes are written is undefined. @@ -4755,8 +4731,7 @@ size_t size, int (*compare) (const void*, const void*));/ function + If there are multiple members with the same key, the order after calling the function is undefined. The function is only available as fastcall function, so it may only @@ -4782,7 +4757,7 @@ program has installed a signal handler for the signal, this signal handler will be executed. If no handler has been installed, the default action for the raised signal will be taken. The function returns zero on success, nonzero otherwise. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -4804,7 +4779,7 @@ be used in presence of a prototype. + Without using , always the same flow of numbers is generated. On startup, the function behaves as if @@ -4831,7 +4806,7 @@ stream pointed to by + The function is only available as fastcall function, so it may only be used in presence of a prototype. The returned pointer may point to a statically allocated instance of @@ -4870,8 +4845,7 @@ by + The part of the memory block that is returned will have its contents unchanged. This function is somewhat dangerous to use. Be careful to save the @@ -4907,8 +4881,7 @@ be used in presence of a prototype. + This function is not available on all cc65 targets (depends on the availability of file I/O). The function is only available as fastcall function, so it may only @@ -4944,8 +4917,7 @@ if (remove (FILENAME) == 0) { + This function is not available on all cc65 targets (depends on the capabilities of the storage devices). The function is only available as fastcall function, so it may only @@ -4980,8 +4952,7 @@ if (rename (OLDNAME, NEWNAME) == 0) { + Since / installs an exit handler, it is not strictly necessary to call this function as part of the cleanup when the program ends. @@ -5004,8 +4975,7 @@ the program ends. / + The original IRQ vector is restored on program termination even without calling this function. @@ -5029,7 +4999,7 @@ calling this function. + The function may not be supported by the hardware, in which case the call is ignored. The function is only available as fastcall function, so it may only @@ -5052,7 +5022,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5073,7 +5043,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5099,7 +5069,7 @@ be used in presence of a prototype. /. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5153,7 +5123,7 @@ static void initialize(){ + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5180,7 +5150,7 @@ while (ser_get(&ch) == SER_ERR_NO_DATA) + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5206,7 +5176,7 @@ ser_install(lynx_comlynx); //Include the driver statically instead of loading it + The function is only available as fastcall function, so it may only be used in presence of a prototype. These functions are not easily portable to other cc65 platforms. @@ -5226,7 +5196,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5245,7 +5215,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5282,7 +5252,7 @@ static void initialize(){ + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5304,7 +5274,7 @@ ser_put('A'); / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5355,8 +5325,7 @@ be used in presence of a prototype. program code by letting the vector point to a user written C function. The runtime library installs a small stub that saves the registers into global variables that may be accessed (and changed) by the break handler. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. The stub saves the zero page registers used by the C runtime and switches @@ -5396,8 +5365,7 @@ was set up to handle a "private", "exclusive" interrupt request source it must return the value + The function is only available as fastcall function, so it may only be used in presence of a prototype. The stub saves the registers and zero page locations used by the C runtime @@ -5430,8 +5398,7 @@ of the cleanup when the program terminates. / function and returns zero. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. cc65 supports only the "C" locale, so calling this function to set a @@ -5482,7 +5448,7 @@ handler may either be a user supplied function, or one of the predefined signal handlers + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5504,7 +5470,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5523,7 +5489,7 @@ be used in presence of a prototype. + The function is specific to the C128. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5570,7 +5536,7 @@ be used in presence of a prototype. as parameters without case sensitivity. It returns a value that is less than zero if + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function is not available in strict ANSI mode. @@ -5598,7 +5564,7 @@ be used in presence of a prototype. pointed to by s2 (including the terminating null byte) to the end of the string pointed to by s1. The initial byte of s2 overwrites the null byte at the end of s1. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. If copying takes place between objects that overlap, the behaviour @@ -5625,7 +5591,7 @@ is undefined. (converted to a char) in the string pointed to by + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5649,7 +5615,7 @@ be used in presence of a prototype. parameters. It returns a value that is less than zero if + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5677,7 +5643,7 @@ parameters, according to the collating sequence set by /. It returns a value that is less than zero if + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5704,7 +5670,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. If copying takes place between objects that overlap, the behaviour @@ -5737,7 +5703,7 @@ strcpy (hello, "Hello world!\n"); not consist of characters contained in the string + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5763,7 +5729,7 @@ be used in presence of a prototype. to hold a copy of + The function is only available as fastcall function, so it may only be used in presence of a prototype. It is up to the caller to free the allocated memory block. @@ -5788,7 +5754,7 @@ be used in presence of a prototype. given error code. If an invalid error code is passed, the string "Unknown error" is returned, and + The function is only available as fastcall function, so it may only be used in presence of a prototype. While the return type of the function is a + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function is not available in strict ANSI mode. @@ -5839,7 +5805,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. When compiling with + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function prototype is unavailable when compiling in strict ANSI mode. @@ -5895,7 +5861,7 @@ See + The function is only available as fastcall function, so it may only be used in presence of a prototype. If copying takes place between objects that overlap, the behaviour @@ -5923,7 +5889,7 @@ characters of the two strings passed as parameters. It returns a value that is less than zero if the first + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -5951,7 +5917,7 @@ the array pointed to by + The function is available only as a fastcall function; so, it may be used only in the presence of a prototype. If there is no null byte in the first + The function is available only as a fastcall function; so, it may be used only in the presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6042,7 +6008,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6065,7 +6031,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6091,7 +6057,7 @@ to + The function is only available as fastcall function, so it may only be used in presence of a prototype. + If . + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function prototype is unavailable when compiling in strict ANSI mode. @@ -6183,7 +6149,7 @@ See /. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6206,7 +6172,7 @@ be used in presence of a prototype. + Text colors are system dependent. The function may have no effect on systems where the text color cannot be changed. The function is only available as fastcall function, so it may only @@ -6233,7 +6199,7 @@ unsigned char rx, unsigned char ry, unsigned sa, unsigned ea);/ radii rx/ry using the current drawing color. The arc covers the angle between sa and ea (startangle and endangle), which must be in the range 0..360. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function behaves unexpectedly or may crash if the angles are out @@ -6265,7 +6231,7 @@ color. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6287,7 +6253,7 @@ tgi_bar(10, 10, 100, 60); / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6347,7 +6313,7 @@ Will NOT uninstall or unload the driver! + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6374,7 +6340,7 @@ tgi_ellipse (50, 40, 40, 20); / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6397,7 +6363,7 @@ driver and display as an 8.8 fixed point value. It may be used to correct geometric shapes so they look correct on the display. As an example, a circle with a radius of 100 pixels may look elliptic on some driver/display combinations if the aspect ratio is not 1.00. - + The aspect ratio is encoded in the TGI driver which assumes a "standard" monitor for the given platform. The aspect ratio may be wrong if another monitor is used. @@ -6501,7 +6467,7 @@ This will also clear the error. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6597,7 +6563,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6648,7 +6614,7 @@ This is same as tgi_maxy()+1. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6668,7 +6634,7 @@ be used in presence of a prototype. + + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6722,7 +6688,7 @@ tgi_init(); //Set up the default palette and clear the screen. Install a vector font for use. More than one vector font can be loaded, but only one can be active. This function is used to tell which one. Call with a NULL pointer to uninstall the currently installed font. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6745,7 +6711,7 @@ used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. These functions are not easily portable to other cc65 platforms. @@ -6780,7 +6746,7 @@ The graphics cursor will be set to x2/y2 by this call. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6801,7 +6767,7 @@ cursor to the new end point. The graphics cursor will be updated to x2/y2. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6822,7 +6788,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6844,7 +6810,7 @@ be used in presence of a prototype. Load a vector font into memory and return it. In case of errors, NULL is returned and an error is set, which can be retrieved using tgi_geterror. To use the font, it has to be installed using tgi_install_vectorfont. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6867,7 +6833,7 @@ The graphics cursor is moved to the end of the text. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6888,7 +6854,7 @@ The graphics cursor is moved to the end of the text. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6911,7 +6877,7 @@ unsigned char rx, unsigned char ry, unsigned sa, unsigned ea);/ and radii rx/ry using the current drawing color. The pie slice covers the angle between sa and ea (startangle and endangle), which must be in the range 0..360. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. The function behaves unexpectedly or may crash if the angles are out @@ -6943,7 +6909,7 @@ driver and display. The argument is an 8.8 fixed point value. The aspect ratio may be used to correct geometric shapes so they look correct on a given display. As an example, a circle with a radius of 100 pixels may look elliptic on some driver/display combinations if the aspect ratio is not 1.00. - + The aspect ratio is encoded in the TGI driver which assumes a "standard" monitor for the given platform. The aspect ratio may be wrong if another monitor is used. @@ -6971,7 +6937,7 @@ ratio. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -6997,7 +6963,7 @@ tgi_bar(10,10,20,20); is seen immediately as it is drawn. For double buffered games you can set the drawpage to a different page than the viewpage. This lets you draw the next screen in the background and when the screen is ready you display it. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7025,7 +6991,7 @@ Palette is a pointer to as many entries as there are colors. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7043,7 +7009,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7064,7 +7030,7 @@ be used in presence of a prototype. is seen immediately as it is drawn. For double buffered games you can set the drawpage to a different page than the viewpage. This lets you draw the next screen in the background and when the screen is ready you display it. - + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7092,7 +7058,7 @@ the current text style. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7112,7 +7078,7 @@ be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7131,7 +7097,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7150,7 +7116,7 @@ be used in presence of a prototype. / + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7203,7 +7169,7 @@ Will call tgi_done if necessary. measured in seconds. If the pointer + The function is only available as fastcall function, so it may only be used in presence of a prototype. Many platforms supported by cc65 do not have a realtime clock, so the @@ -7227,7 +7193,7 @@ returned value may not be valid. + The function is specific to the C128. This function is deprecated. Please use instead! @@ -7251,7 +7217,7 @@ name="videomode"> instead! + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7274,7 +7240,7 @@ only be used in presence of a prototype. + The function is only available as fastcall function, so it may only be used in presence of a prototype. @@ -7297,7 +7263,7 @@ only be used in presence of a prototype. + There are no provisions to prevent a buffer overflow. The function is non standard, so it is not available in strict ANSI mode. You should probably use + The use of this function is discouraged. Please use / instead, which is a native ANSI C function and does the same. This function is not available on all cc65 targets (depends on the @@ -7367,7 +7332,7 @@ if (unlink (FILENAME) == 0) { + There are no provisions to prevent a buffer overflow. The function is non standard, so it is not available in strict ANSI mode. You should probably use /. --> - + Like all other The function is only available as fastcall function, so it may only be @@ -7426,7 +7391,7 @@ used in presence of a prototype. + The function is specific to the C128 and enhanced Apple //e. This function replaces .