Initial revision

BlackLog

+***************************************************************************
+*                                                                         *
+*  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