***************************************************************************
* *
* Project: RiscOS *
* *
* Module: RISC_OSLib *
* *
* Created: Wed 24-Oct-90 By: Ran Mokady *
* *
* First version: 4.16 *
* *
* Copyright: (C) 1990, Acorn Computers Ltd., Cambridge, England. *
* *
***************************************************************************
Purpose:
========
C application support library for Risc OS.
***************************************************************************
Change Log:
===========
---------------------------------------------------------------------------
Version: 4.16 Wed 24-Oct-90 Ran Mokady
---------------------------------------------------------------------------
Version: 4.17 Wed 07-Nov-90 Jonathan Roach
* Add wimp_spritearea #define to wimp.h
* Add dragasprite (dragasprit.h and dragasprit.c)
* Use dragasprite for xfersend
* Improve generation of save dbox icon to set ptr_hand over it
---------------------------------------------------------------------------
Version: 4.18 Wed 16-Jan-91 enevill
* Stack extension / event interaction bug fixed
* 4.18 needed for DDE
* C library sources now under source control (DDE 3.69)
---------------------------------------------------------------------------
Version: 4.19 Fri 01-Mar-91 philip colmer
* longjmp in SVC mode fixed
* IDJs edit bug fixes
---------------------------------------------------------------------------
Version: 4.20 Mon 11-Mar-91 Philip Colmer
* support for BASIC tokenising/detokenising added to txtedit, txtfile
and saveas
---------------------------------------------------------------------------
Version: 4.21 Sun 17-Mar-91 Ran Mokady
(Log entries by RM)
Philip Colmer :- Fixed bug, old versions of !Edit confused by new BASIC code.
Ran Mokady :- Fixed stubs, and changed font.c to initialise zero data.
---------------------------------------------------------------------------
Version: 4.22 Mon 18-Mar-91 Ian Johnson
* bug fix in c.dbox, dbox_fillin_fixedcaret and dbox_fillin
---------------------------------------------------------------------------
Version: 4.23 Thu 11-Apr-91 Philip Colmer
* bug fix in c.txtfind, c.font
* removed BASIC support from c.saveas, changed BASIC support in c.txtedit,
added support for new font menu in c.txtoptmenu
---------------------------------------------------------------------------
Version: 4.24 Fri 12-Apr-91 ENevill
* Text extraction & message lookup in C library
---------------------------------------------------------------------------
Version: 4.25 Sat 13-Apr-91 ENevill
* C locale stuff + lookup for RISC_OSLib messages file
---------------------------------------------------------------------------
Version: 4.26 Sat 13-Apr-91 Jonathan Coxhead
* New arguments to wimp_taskinit are expected if (and only if)
*version >= 300, new header:
os_error *wimp_taskinit (char *name, int *version /*inout*/,
wimp_t *t /*out*/, ...);
/* Name is the name of the program. Used instead of wimp_initialise,
returns your task handle. *Version should be at least 200 on entry,
and will return the current wimp version number. If *version >=
300, a wimp_MCLOSEDOWN-terminated list of message numbers must be
given.*/
* A new function wimpt_messages, as follows:
/* ------------------------ wimpt_messages --------------------------
* Description: Tell wimpt which WIMP messages you understand.
*
* Parameters: action, ... - a list of message numbers, terminated
* by wimp_MCLOSEDOWN (which every task must respond
* to)
*
* Returns: void.
*
* Other Info: Call this routine before calling wimpt_init, if you
* know about the message-masking feature of the WIMP
* present in version 3.00+. This list will be passed
* to SWI Wimp_Initialise. If you call this function
* without calling wimpt_version(), wimpt_init() will
* assume you know about WIMP 3.00.
*/
void wimpt_messages (wimp_msgaction, ...);
---------------------------------------------------------------------------
Version: 4.28 Wed 01-May-91 ENevill
* Improved error handling in C library kernel
---------------------------------------------------------------------------
Version: 4.29 Fri 21-Jun-91 ENevill
* _kernel_raise_error now unwinds stack and returns error to original caller
if called from SVC mode.
* Now complains when trying to get a message from its message file and you
have overloaded an old version (< 3.80).
* Calls TaskWindow_TaskInfo in _postmortem to see if this is a 'command'
task.
---------------------------------------------------------------------------
Version: 4.30 Tue 02-Jul-91 Ian Johnson
* fixed wimpt_messages to not ignore first message
* added three entries back in for Draw and paint
* added help handlers for dboxtcol and magnifier
* removed window limit
* most other fixes detiled in version 1.31 of Edit
---------------------------------------------------------------------------
Version: 4.31 Fri 19-Jul-91 Ian Johnson
* new messages file
* fileicon now supports directory and application icons
* txtfile.c fixed for large BASIC file saving
* new cl.messages
* stop looking up error token twice
* remove arguments to _armsys_libinit
* replaced quick sort with shell sort
---------------------------------------------------------------------------
Version: 4.32 Mon 05-Aug-91 Ian Johnson
* new functions dboxquery_close and dboxquery_quit to implement style
guide behaviour for quit and close
* new rl_spare and rl_entries for above changes
* new s.bastxt, c.txtedit, c.txtfile, h.verintern.messages for changes
listed in Edit change list
* new messages file
---------------------------------------------------------------------------
Version: 4.33 Tue 27-Aug-91 ENevill
* RISC OS 2.18 release
---------------------------------------------------------------------------
Version: 4.34 Wed 04-Sep-91 ENevill
* Fixed out by 1 buffer size problem in system()
* Use &FF0 as workspace pointer so loading grungy old clib works.
---------------------------------------------------------------------------
Version: 4.35 Mon 16-Sep-91 ENevill
* Generate zero init stubs$$data in ROMStubs and ROMCStubs
---------------------------------------------------------------------------
Version: 4.36 Mon 23-Sep-91 ENevill
* Fix RMA memory leakage bug.
---------------------------------------------------------------------------
Version: 4.37 Thu 26-Sep-91 RISC OS Build
* Return to 4.35 version for Amber RISC OS.
---------------------------------------------------------------------------
Version: 4.38 Tue 05-Nov-91 RISC OS Build
* Change wimpt_messages so it takes a pointer to a block of messages
rather than a variadic argument list. Much neater.
---------------------------------------------------------------------------
Version: 4.39 Tue 19-Nov-91 ENevill
* RP-0367: Tidied up edit menus.
* Added new SWI veneers
Jonathan Coxhead
* Threw away msgs_, now uses MessageTrans
* Added msgtrans_ (new module, header file only!)
---------------------------------------------------------------------------
Version: 4.40 Mon 25-Nov-91 ENevill
* New swis.h. Removed SWI defs from c files
---------------------------------------------------------------------------
Version: 4.41 Tue 03-Dec-91 ENevill
* Fixed bug in os_read_var_val which caused bytes to be chopped off the
end of system variables
---------------------------------------------------------------------------
Version: 4.42 Mon 20-Jan-92 ENevill
RP-0484: 3.92 - Resets __icnt in __filbuf in case ESC happens in read
- Allow malloc(0)
G-RO-8405: - Fixed sscanf("123", "%d %d %d", ...)
- Changed ROMStubs so they call ROM SWI directly for
applications as well as modules so !Configure works with
an overloaded C library.
- Separated stubs into module stubs and application stubs
so a module or application need only link with the
appropriate stubs thus saving space.
RP-0750: - Changed txtedit so click on save opens save dbox with
untitled file.
- Added Cancel icon to "not tokenised BASIC" error
---------------------------------------------------------------------------
Version: 4.43 Mon 17-Feb-92 ENevill
Bug fix: fopen now closes the file if it gets an error trying to set the
file extent when opening a locked file for writing.
Performance: template loading speeded up be using Wimp_LoadTemplate to find
the buffer size required for indirected data instead of reading
the file and determining this itself.
Performance: Sprite file loading. If the sprite file is held in ResourceFS
the file is not loaded. A direct pointer to the file data is
used instead.
---------------------------------------------------------------------------
Version: 4.44 Thu 20-Feb-92 ENevill
Bug fix: _kernel_RMAextend previously freed the block it had just
extended by falling through to _kernel_RMAfree.
Bug fix: wording for error messages changed.
---------------------------------------------------------------------------
Version: 4.45 Thu 20-Feb-92 ENevill
Bug fix: More error messages changed.
---------------------------------------------------------------------------
Version: 4.46 Thu 12-Mar-92 ENevill
* Added SIGOSERROR to signals intercepted by wimpt_init.
Prevents Postmortems being generated from RISCOS_Lib Apps
* Return error from _kernel_moduleentry if error claiming workspace.
Allows DOSFS initialisation to fail gracefully
* Generate UpCall NewApplication in modulewrap before changing exit handler.
Allows Obey module to free its workspace correctly
---------------------------------------------------------------------------
Version: 4.47 Fri 13-Mar-92 Owen Smith
* Added resspr_readfile() function - same as resspr_init() but you pass
in the pathname of the Sprites file eg. "Configure:Sprites". This allows
the ROM apps to have their directories split in half, which fixes
RP-0716.
* New module_wrap from Edward - it was missing an instruction or something.
---------------------------------------------------------------------------
Version: 4.48 Thu 02-Apr-92 ENevill
* Module wrap now kills all instantiations but one on soft reset
* Module wrap preserves error after *WimpSlot for FilerAct
* New call wimpt_install_signal_handlers prevents postmortems before wimpt_init
* Read "Width" string from messages file in !Edits menu
---------------------------------------------------------------------------
Version: 4.48 Fri 03-Apr-92 Jonathan Coxhead
* New argument added to xfersend_print(). Not implemented yet though.
---------------------------------------------------------------------------
Version: 4.49 Mon 06-Apr-92 Jonathan Coxhead
* Implemented as follows, in two parts: (j) if the Message_PrintSave is not
acknowledged by a Message_PrintFile, xfersend_print() calls the printing
argument. (Then, if there is a printer driver module loaded, printing will
happen; otherwise, a call to PDriver_Info at some point in the printing
code will cause a 'Printer driver not loaded' error to be reported to the
user.) (ij) If Printers replies with Message_PrintTypeOdd, the same
happens and xfersend_print() replies with Message_PrintTypeKnown. If a
printing argument of NULL is supplied, Printers will try again with a
Message_DataSaveAck and then the saving argument or sending argument will
be used.
* Also, xfersend() does the same. Neither of these functions now responds to
Message_PrintFile under any circumstances.
---------------------------------------------------------------------------
Version: 4.49 Thu 23-Apr-92 ENevill
RP-2240 Don't print "Internal error (<error>) for SIGOSERROR, just print
<error>
A-RO-7016c Fixed wimpt1 message lookup.
Check return code from dbox_new in magnify
RP-2385 Fix gmtime - subtract timezone and DST from local time
RP-2483 Return errors from _kernel_oswrch so printf returns an error if
OS_WriteC fails.
---------------------------------------------------------------------------
Version: 4.49 Fri 24-Apr-92 JRoach
RP-2621 Don't address exception, but return error instead in ModuleWrap
if module was entered, but wasn't enough RMA to get workspace.
---------------------------------------------------------------------------
Version: 4.50 Fri 30-Jul-93 ENevill
* Fix timezone bug, where negative timezones went wrong.
* Support use of characters other than '.' as decimal point in scanf, printf etc
* Support indirected menu titles when title is longer than 12 chars
* Extend fixed size text buffers in txtedit from 20 to 40
* Look up word "Selection"
* Removed assumptions about alphabetic chars in dbox
---------------------------------------------------------------------------
Version: 4.51 Thu 26-Aug-93 Owen Love
* Improvement in the wording of the error messages stored in the message
file as part of the Libra project.
---------------------------------------------------------------------------
Version: 4.52 Thu 02-Sep-93 Steve Cormie
* No longer assumes the size of application space or the position/size
of the RMA.
---------------------------------------------------------------------------
Version: 4.53 Tue 21-Sep-93 ENevill
* Changed fclose so it allows fclose(0), returning -1 to indicate an error
---------------------------------------------------------------------------
Version: 4.54 Mon 04-Oct-93 ENevill
* Fixed prehistoric register corruption bug in _kernel_unwind
---------------------------------------------------------------------------
Version: 4.55 Thu 11-Nov-93 Jonathan Roach
* MED-00925: with just the right amount of free memory, !Edit will fail to
convert a BASIC proggy when it's shift-double-clicked, but open an empty
window with the file's name - not safe! Bug was in txtfile.
---------------------------------------------------------------------------
Version: 4.56 Thu 11-Nov-93 Jonathan Roach
MED-01175: No error message when printer status Inactive. RISC_OSLib was
failing to respond to PrintError messages in xfer_send.
MED-01173: Corrupt error message from !Edit when printer status inactive.
The txt part of RISC_OSLib was respoinding to PrintError messages, but
indexing to the wrong position to print the error.
MED-02078: as MED-01173.
---------------------------------------------------------------------------
Version: 4.56 Wed 19-Jan-94 Jonathan Roach
Bring SharedCLibrary version up to SrcFiler version.
---------------------------------------------------------------------------
Version: 4.57 Fri 21-Jan-94 JCoxhead
dboxtcol.c - make colour model persistent
menu.c - various bugs fixed courtesy of Lionel Haines
wimp.c - pass TRUE to Wimp_ReadPalette, do not scale by 17/16
xfersend.c - only report a printer error if one is provided
---------------------------------------------------------------------------
Version: 4.58 Thu 10-Feb-94 William Stoye
txtar.c,wimpt.c - bug fix so that Edit notices EVERY mode change,
not just the ones that happen when it has windows open.
***************************************************************************
MEDUSA - RISC OS 3.50 build
***************************************************************************
* *
* Project: Black *
* *
* Module: RISC_OSLib *
* *
* Created: Mon 01-Aug-94 By: Aideen McConville *
* *
* First version: 4.58 *
* *
* Copyright: (C) 1994, Acorn Computers Ltd., Cambridge, England. *
* *
***************************************************************************
Purpose:
========
***************************************************************************
Change Log:
===========
---------------------------------------------------------------------------
Version: 4.58 Mon 01-Aug-94 Aideen McConville
Moved to new source tree.
---------------------------------------------------------------------------
Version: 4.59 Fri 19-Aug-94 Alan Glover
Fix bug MED-03572 (c.txtedit) Quitting edit from the task window whilst
there's a modified file causes the whole desktop to shut down when the
file is discarded
---------------------------------------------------------------------------
Version: 4.60 Tue 30-Aug-94 Alan Glover
Fix bug MED-03067 (c.txtedit, again). Was framing an error block and
not bothering to fill in an error number. Result was that spurious
fatal program errors sometimes occurred.
(AMcC) (30-Sep-94) also small change to c.txtfile (error reporting)
---------------------------------------------------------------------------
Version: 4.61 Tue 06-Sep-94 Aideen McConville
* Makefile: added rom_link rule (needed for final stage of ROM Image build).
* s.version: updated to 4.61
---------------------------------------------------------------------------
Version: 4.62 Mon 26-Sep-94 Steve Cormie
* Fixed MED-03708:
s.initmodule: Messages "Stub data size = " and
"Library data size = " now looked up in
Messages file.
clib.Resources.UK.Messages: Above messages added as C67, C68.
kernel.s.k_body: Sorted out _kernel_getmessage (could return
error pointer with no V set, also works for
:DEF:DEFAULT_TEXT now).
"registers at:" message only required for
:DEF:DEFAULT_TEXT.
clib.s.cl_body: "Postmortem" message only required for
:DEF:DEFAULT_TEXT.
rlib.c.txtar: Debugging error removed.
Makefile: Now builds lib.Clib (SharedCLibrary RAM module)
correctly.
---------------------------------------------------------------------------
Version: 4.63 Fri 28-Oct-94 Aideen McConville
* Updated generation of swis.h (for Aquarius)
hdr.SharedCLib: (new) contains SWI definitions (now included in swis.h)
s.makeswis: Generates SWI name defs for all SWIs listed in 3.50 PRM
Generates swis.h suitable for Aquarius
* s.modulewrap: Looks for ResFiles in directory 's'.
* Makefile: Exports hdr.SharedCLib (SWI defs)
Exports some files from rlib.h.EditIntern (needed by !Edit)
Generates o.c_abssym (c symbols only) as well as o.abssym -
some RISC_OSLib symbols clashed with symbols used by modules
that don't normally link with RISC_OSLib (e.g. RemPrnSpt).
---------------------------------------------------------------------------
Version: 4.64 Fri 28-Oct-94 Aideen McConville
* Reinstated the following in the ROM library (needed by !Paint)
- rlib.c.colourtran (colourtran_return_colourformode)
- rlib.c.sprite (sprite_get_given_rp)
- rlib.c.wimp (wimp_ploticon, wimp_which_icon)
- rlib.c.win (win_read_eventhandler)
- rlib.s.rl_entries (reinstated above symbols)
---------------------------------------------------------------------------
Version: 4.65 Mon 31-Oct-94 Steve Cormie
* s.modulewrap: Make Filer_Action look up help/syntax in its own message file.
* Messages: Added directed comments for message tokenisation.
---------------------------------------------------------------------------
Version: 4.66 Fri 25-Nov-94 Steve Cormie
* s.modulewrap: Other apps using modulewrap need to look up help and syntax
for *Desktop_<AppName>.
---------------------------------------------------------------------------
Version: 4.67 Fri 25-Nov-94 Aideen McConville
* Compatibility changes for 500 Series compiler:
__rt_ symbols defined and exported as needed
Changed files:
clib.s.cl_body
clib.s.cl_data
clib.s.cl_entries
kernel.s.k_body
kernel.s.k_entries
s.h_modmacro
s.h_stubs
---------------------------------------------------------------------------
Version: 4.68 Fri 25-Nov-94 Aideen McConville
* Create a 'special' Entries file (syms.A_Entries) that doesn't include
swi and swix entries. This is necessary for ROM components that define
their own versions of swi and swix (e.g. ShareFS)
Changed files:
syms.A_Entries (new)
Makefile
---------------------------------------------------------------------------
Version: 4.69 Wed 30-Nov-94 Aideen McConville
* Updated some CLib.h files in line with Aquarius versions:
clib.h.ctype
clib.h.kernel
clib.h.math
clib.h.stdio
* s.makeswis: Added Hdr:DragAnObj
* Makefile: Now exports ansilib
Fixed typo: (o.rl.swi: --> o_rl.swi) to ensure that the correct
definitions are copied to asmdefs before assembling swi
---------------------------------------------------------------------------
Version: 4.70 Mon 05-Dec-94 Steve Cormie
* Fixed MED-03597: s.modulewrap used ANDNV instructions as NOPs.
---------------------------------------------------------------------------
Version: 4.71 Fri 09-Dec-94 Steve Cormie
* Fixed MED-03777: s.initmodule and kernel.s.k_body used banked registers
after a processor mode change.
---------------------------------------------------------------------------
Version: 4.72 Tue 03-Jan-95 Aideen McConville
* s.makeswis: Added CDROM and SCSI SWIs (as requested by SPalmer)
---------------------------------------------------------------------------
Version: 4.73 Mon 09-Jan-95 Aideen McConville
* s.makeswis: Added #defines for INR(..) and OUTR(..) and Usage comment
(for Aquarius)
---------------------------------------------------------------------------
Version: 4.74 Wed 11-Jan-95 Steve Cormie
* s.initmodule, kernel.s.k_body: Fixed fixes made in version 4.71.
* clib.s.cl_body: Fixed MED-04254, pow(0,0) should have returned 1.
* c.stdio: Fixed MED-04294, setvbuf followed by getc failed to allocate a
system buffer and hence crashed the machine.
---------------------------------------------------------------------------
Version: 4.75 Wed 18-Jan-95 Aideen McConville
* MED-03784 - part of Fix (for !Edit) - look up Version/Date in Messages
file and use to fill in ProgInfo template. Change in rlib.c.txtedit - part of
RISC_OSLib but used only by !Edit (IJ).
* Moved rlib.h.EditIntern.editv to !Edit (not required by RISC_OSLib)
* Makefile: uptodate list of dynamic dependencies
no longer exports rlib.h.EditIntern.editv
---------------------------------------------------------------------------
Version: 4.76 Wed 15-Feb-95 Steve Cormie
* h.hostsys, s.h_workspc, kernel.s.k_body, c.stdio - Fixed MED-04611:
Function tmpnam() now uses byte in zero page as a counter and checks
that the file name generated is not that of an existing file.
-----
Same version: Fri 17-Feb-95 AMcC - s.makeswis - changed Hdr:CDROMFS to Hdr:CDFS
---------------------------------------------------------------------------
Version: 4.77 Mon 27-Feb-95 Steve Cormie
* kernel.s.k_body - Fix made in version 4.76 prevented ansilib from being built.
---------------------------------------------------------------------------
Version: 4.78 Tue 28-Feb-95 JCoxhead
* Fixed typo in dbox.c. (MED-04747)
AMcC: 29-Feb-95: Updated s.Version
---------------------------------------------------------------------------
Version: 4.79 Wed 01-Mar-95 Aideen McConville
* Reinstated the following in the ROM library (needed by !Draw)
- rlib.c.bbc (bbc_gwindow)
- rlib.s.rl_entries (reinstated above symbol)
- s.Version
AMcConville (04-Apr-95): No new version
* Makefile - export rule divided into two phases: export_hdrs, export_libs
swis.h is created during the second phase (export_libs)
This ensures that all components have exported their hdr files
before any attempt is made to create swis.h