home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / acorn / riscos / releases / oslib / changlog next >
Text File  |  1995-02-24  |  11KB  |  302 lines
  1. OSLib release 4.3
  2. ----- ------- ---
  3.  * Added dependency of "dragasprite.h" on "osspriteop.h."
  4.  
  5.  * |#Undef|fed each SWI name and SWI reason code before |#define|ing it.
  6.  
  7.  * Removed spurious ')' in comment for OS_SetPalette.
  8.  
  9.  * Changed names of arguments to Wimp_SetIconState.
  10.  
  11.  * SWI Wimp_Extend given the right number (but it's reserved anyway).
  12.  
  13.  * Added os_read_line_given_echo(), os_read_line_suppress_invalid(),
  14. os_read_line_given_echo_suppress_invalid().
  15.  
  16.  * Changed filetypes, load addrs, exec addrs and attrs to |bits| from |int|
  17. (to avoid undefined behaviour when shifting bits in and out of load and
  18. exec addrs). Affects "filecore.h," "filer.h," "fileraction.h,"
  19. "netfs.h," "osfile.h," "osfscontrol.h," "osgbpb.h," "osmodule.h,"
  20. "pdriver.h," "resourcefs.h," "squash.h," "wimp.h."
  21.  
  22.  * Corrected osfile_TYPE and osfile_TYPE_SHIFT.
  23.  
  24.  * Changed ColourPicker button types to |bits| from |int|.
  25.  
  26.  * Added OSFile attribute values.
  27.  
  28.  * Do not truncate file names at 10 characters in nested includes (as
  29. recommended in my own documentation!). Affects "pdriver.h" only.
  30.  
  31.  * Avoid C++ reserved words (asm, template in "os.h," delete in "netfs.h").
  32.  
  33.  * Remove accidentally duplicated parameter names ("dosfs.h,"
  34. "filecore.h," "font.h," "osspriteop.h," "pdriver.h," "ramfs.h,"
  35. "sharedclibrary.h") to avoid GCC errors.
  36.  
  37.  * Added flags values for osspriteop_set_pointer_shape().
  38.  
  39.  * Output argument of wimpreadsysinfo_tool_sprites() corrected (was
  40. |osspriteop_area *|, should be |osspriteop_area **|).
  41.  
  42.  * Various changes to ReadMe, including description of "abstract types."
  43.  
  44.  * Changed definition of |os_date_and_time| from 
  45.  
  46.       typdef struct {byte b [5];} os_date_and_time;
  47.  
  48. to 
  49.  
  50.       typedef byte os_date_and_time [5];
  51.  
  52. and the same for |netfs_date_and_time|. This may break code, but it is
  53. necessary to ensure that the alignment of structures that use it (e g,
  54. |osgbpb_system_info|) are correct in Norcroft C (which aligns
  55. structures, but not arrays, to word boundaries).
  56.  
  57.  * Added chip-type symbols to "osreadsysinfo.h."
  58.  
  59.  * Fixed minor typos in "devicefs.h," "netfs.h," "osfscontrol.h."
  60.  
  61.  * Added CMOS byte numbers for current year and alarm flags ("osbyte.h")
  62. and also recoded the macros in there to make it totally complete and
  63. consistent for all CMOS locations.
  64.  
  65. OSLib release 4.2
  66. ----- ------- ---
  67.  * Fixed bug in ADFS_DiscOp, FileCore_DiscOp, RamFS_DiscOp: first argument
  68. was being passed in R0, not R1.
  69.  
  70.  * Provided 3 functions for Territory_ReadSymbols, so you can call the right
  71. one for the type of result expected.
  72.  
  73.  * Changed the tag used for "abstract" typedefs so that it is different from
  74. the typedef name, for better interworking with GCC and C++ systems. Affects
  75. "buffer.h," "colourpicker.h," "devicefs.h," "dma.h," "econet.h," "os.h,"
  76. "osfscontrol.h," "osspriteop.h," "wimp.h."
  77.  
  78.  * Added wimp_CLOSE_MENU (to be used as an argument to wimp_create_menu())
  79. and wimp_NO_FONTS (to be used as an argument to wimp_load_template()) to
  80. "wimp.h."
  81.  
  82.  * Fixed bug in Filer_MessageOpenDirAt: display field was bits, not byte.
  83.  
  84. OSLib release 4.1
  85. ----- ------- ---
  86.  * Wimpreadsysinfo_wimp_mode() returns |os_mode| rather than |int|.
  87.  
  88.  * Fix bug: some byte-wide entities were being written as whole words. This
  89. affects: xcolourtrans_return_gcol(), xcolourtrans_set_gcol(), xcolourtrans_-
  90. return_gcol_for_mode(), xcolourtrans_return_opp_gcol(), xcolourtrans_set_-
  91. opp_gcol(), xcolourtrans_return_opp_gcol_for_mode(), xcolourtrans_colour_-
  92. number_to_gcol(), xcolourtrans_set_text_colour(), xcolourtrans_set_opp_-
  93. text_colour(), xfont_find_font(), xfont_current_font(), font_current_-
  94. font(), xfont_future_font(), font_future_font(), xfont_current_rgb(), xfont_-
  95. future_rgb(), xos_read_point(), os_read_point(), xos_change_redirection(),
  96. os_change_redirection(), xosfind_openin(), xosfind_openout(), xosfind_-
  97. openup(), xosspriteop_read_pixel_colour(), osspriteop_read_pixel_colour(),
  98. xpdriver_select_job(), xpdriver_current_job(), xpdriver_select_-
  99. illustration(), xwimpreadsysinfo_font(), wimpreadsysinfo_font(),
  100. xwimpspriteop_read_pixel_colour(), wimpspriteop_read_pixel_colour().
  101.  
  102.  * Add note to ReadMe file about using NULL pointers as output arguments.
  103.  
  104.  * Duplicate NOP macro deleted from Hdr.Types.
  105.  
  106.  * Added OS_VartypeLiteralString, os_VARTYPE_LITERAL_STRING to OS headers.
  107.  
  108.  * Corrected Wimp error numbers (most were 1 off), added Error_WimpBadSlot,
  109. Error_WimpBadConfFont, Error_WimpNoSprites, Error_WimpBadPalFile2,
  110. Error_WimpBadSprites from RO 3.5, and 2 now-obsolete numbers (too many
  111. windows, division by 0).
  112.  
  113. OSLib release 4
  114. ----- ------- -
  115.  * Second public release
  116.  
  117.  * Changed 'allpication' to 'application' in os.h (!).
  118.  
  119.  * Os_change_environment() now returns the old handler.
  120.  
  121.  * Error_SQUASH_BADPARAMETERS gains an underscore.
  122.  
  123.  * In osmodule.h, "context" arguments given more meaningful names
  124. (|module_no|, |instance_no|). Various osmodule_enumerate() calls return
  125. |module_no_out| as the result.
  126.  
  127.  * Added help files for StrongHelp, available on F1 in StrongEd (by
  128. default), and also in Zap C Mode if you bind MJE_HELPCONTEXT to F1 in the
  129. keys file.
  130.  
  131.  * Added OS_PlotVDU, changed argument types of OS_ChangeRedirection.
  132.  
  133.  * Fix bug: size of unions was being specified as 0 in assembler headers.
  134.  
  135.  * Added stuff about "types.h" in ReadMe.
  136.  
  137.  * Restructured: OSLib now contains only ChangeLog, ReadMe, h, Hdr and o.
  138. Separate archives contain Examples (PRM example code in C), CStrong
  139. (StrongHelp for the C interface) and CHelp (SrcEdit help for the C
  140. interface). A future release will contain AsmStrong and AsmHelp (for the
  141. assembler interface).
  142.  
  143. OSLib release 3
  144. ----- ------- -
  145.  
  146.  * Provide ReadMe and this file with the release.
  147.  
  148.  * Added descriptive text to each function.
  149.  
  150.  * "Abstract" types supported: used for Wimp_W, Wimp_T, Econet_RxCB,
  151. Econet_TxCB, etc.
  152.  
  153.  * IIC_Control, OS_Byte, OS_ClaimScreenMemory, Wimp_ClaimFreeMemory now
  154. classified as "reason codes."
  155.  
  156.  * Incorporated suggestions from Jonathan Roach for filecore.h.
  157.  
  158.  * Fix bug: bad code generated for Font_CacheAddr, Font_ReadDefn,
  159. Font_ReadScaleFactor, OSFSControl_ReadFileType, PDriver_PageSize,
  160. WimpSpriteOp_ReadPaletteSize and WimpSpriteOp_ReadSpriteSize.
  161.  
  162.  * Use |void| (instead of |byte|) for generic pointers, where appropriate.
  163.  
  164.  * Added more error numbers.
  165.  
  166.  * Renamed International as ServiceInternational.
  167.  
  168.  * Upgrade to RISC OS 3.5.
  169.  
  170.  * Added more message types to filer.h.
  171.  
  172.  * If there is a reasonable |context_out| argument, return it from the non-X
  173. form.
  174.  
  175.  * Moved "main" SWI's to their own headers (OS_Byte to osbyte.h, etc), InsV,
  176. RemV, CnpV to Buffer.
  177.  
  178.  * Sorted all OS SWI's into one of these groups: the CLI; communications;
  179. conversions; the environment; errors; input; interrupts; memory management;
  180. output; time and date; VDU drivers; vectors; and the rest of the kernel.
  181. Maybe os.h, which is somewhat monolithic, should be split up along these
  182. lines?
  183.  
  184.  * Added RemV, CnpV, but not properly yet.
  185.  
  186. OSLib release 2
  187. ----- ------- -
  188.  
  189.  * Now complete. All calls up to RISC OS 3.10 are included. (Medusa
  190. extensions will have to wait until the next release.)
  191.  
  192.  * In the header files, registers which are assigned fixed values in a
  193. function veneer (e g, reason codes) are listed in an 'Other notes'
  194. paragraph.
  195.  
  196.  * The section header (e g, for 'Constant definitions,' etc) is absent if the
  197. section is absent. The section headers are more eye-catching. (Suggested by
  198. James Bye.)
  199.  
  200.  * More SWI's return results in their non-X form.
  201.  
  202.  * Result registers are no longer in the argument list. In the previous
  203. OSLib, the prototype for |osmodule_alloc()| (which allocates memory from the
  204. R M A) was
  205.  
  206.       void osmodule_alloc (int size, byte **ptr);
  207.  
  208. now it is
  209.  
  210.       byte *osmodule_alloc (int size);
  211.  
  212. Also: OSFile functions return the object type; functions that create an
  213. object or open a file return the handle; SWI's that do a read operation
  214. return the flags, so you can write
  215.  
  216.       while ((os_bget (f, &c) & _C) == 0)
  217.       {  ... code to do something with character |c| ...;
  218.       }
  219.       ... now at end of file ...;
  220.  
  221. Econet SWI's return the control block created, or the status of the operation
  222. performed; WIMP and PDriver SWI's that are called to loop through rectangles
  223. return the continuation status, so you can write a redraw loop as
  224.  
  225.       for (more = wimp_redraw_window (&r); more;
  226.             more = wimp_get_rectangle (&r))
  227.       {  ... redraw code here ...;
  228.       }
  229.  
  230.  * More consistent terminology: SWI's that fill buffers have two arguments,
  231. usually called |buffer| and |size|, and may return one of: a pointer to the
  232. next free byte (always called |end|); a number of bytes written (called
  233. |used|); or a count of buffer bytes not used (called |spare|). More
  234. consistency could only be derived by changing the OS, or doing some bizarre
  235. things in the veneer.
  236.  
  237.  * More of the module interface described: vectors, upcalls and events
  238. added, with prefix |os_...v|, |upcall_| and |event_| respectively. Error
  239. prefix changed to |error_|. Message prefix still |message_|, service call
  240. prefix |service_|. All other symbols defined in a module begin with the
  241. module prefix. Service calls and all the above now at the end. (These are
  242. only provided from the implementor's side, as it were: functions to generate
  243. the event, call the vector, make the service call, rather than to act on the
  244. event, claim the vector, or catch the service call.)
  245.  
  246.  * In the header files, C syntax is used for hexadecimal in comments.
  247.  
  248.  * In the header files, brackets removed from pointer declarations.
  249. (Suggested by James Bye.)
  250.  
  251.  * Spurious blank lines removed from header files.
  252.  
  253.  * To get -1 into a register Rx, used to generate the stupid MOV Rx, #&FF:
  254. ORR Rx, Rx, #&FF00: ORR Rx, Rx, #&FF0000: ORR Rx, Rx, #&FF00000. Now
  255. generates MVN Rx, #0 instead, and similarly for similar constants.
  256.  
  257.  * Assumes that a non-X SWI will never be called in SVC mode. This means that
  258. LR is preserved over the SWI instruction and reduces quite a lot of veneers
  259. to 2 instructions.
  260.  
  261.  * Uses that fact that registers not corrupted or returned by the SWI are
  262. preserved, to avoid stacking output addresses where possible. This also
  263. reduces the lengths and memory accesses of a lot of veneers. (Suggested by
  264. James Bye.)
  265.  
  266.  * OSFind changed: instead of (e g) 
  267.  
  268.       xosfind_openout_path (flags, file_name, path, file);
  269.  
  270. use
  271.  
  272.       xosfind_openout (osfind_PATH | flags, file_name, path, file);
  273.  
  274. In other words, the choice between {default path, no path, given path, path
  275. variable} is moved from the function name to the flags argument. (Suggested
  276. by Ian Johnson) Sadly, this cannot be done with the OSFile SWI's, because
  277. they are not related in a systematic way.
  278.  
  279.  * One library (o.OSLib) instead of lots. (Suggested by Kevin Welton.)
  280.  
  281.  * All code examples from the PRM (except volume 4) included in C versions.
  282.  
  283. OSLib release 1
  284. ----- ------- -
  285.  
  286.  * Name changed from SWILib. DefMod written to provide an automatic
  287. translator and veneer generator from module definition files.
  288.  
  289.  * Macros changed to functions. Original macro SWILib now only used to make
  290. DefMod (without this, you would have a circular build process with nowhere to
  291. start).
  292.  
  293.  * Many extra SWI's covered.
  294.  
  295.  * Wimp_Message structures now divided into two sorts: "system messages", in
  296. the union Wimp_Message, and others which may be provided by other modules
  297. (the WIMP also provides some of these).
  298.  
  299.  * X and non-X forms provided.
  300.  
  301.  * OS_F, Font_F instead of OS_Handle, Font_Handle.
  302.