15/09/1998 Welcome to Acorn Computers' Registered Developer site. Please read and understand the file "disclaimer" in this directory before proceeding. The current directory structure was last updated on 15/09/1998, and comprises: ChangeLog: Record of all deltas made to this system. devtools: 65host Version of the BBC Model B emulator, tweaked to run on the Risc PC. The required tweak is a relocation of the screen base address; everything else *appears* to work... allocate Application which enables you to apply for filetype, SWI chunk etc allocation. Please run this program *from floppy*, and once complete, send to Pineapple Software. codecheck Tool to check for code sequences which, owing to differences in cycles for synchronisation, are illegal for use on ARM250 drawfile Version 1.30 of the DrawFile module, complete with documentation and a sample application showing its use. The documentation and app are the important bits :-) evntwatch Source code for a prog to watch and display Wimp events. fsbash Utility to stability-test filing systems by thrashing them and logging activity. isoform Allows ISO 9660-compatible CD ROM ready images to be generated from RISC OS file hierarchies kbrds Keyboard drivers for various international keyboard layouts and character sets. Includes a useful keyboard containing almost all of the ISO-Latin char set. redraw App to help in the management of system sprite files; allows for instant update. With BASIC source. setshape Can often restore to sense hard drives which have lost their shape data (kept at 0xC00) squish BASIC V program compactor (written in BASIC V). territory The full International, Keyboard and Territory module generation suite. The Keyboard generator prog is still specific to the pre-RiscPC layout; if anyone wishes to produce a new version, please flag Developer Support. NB. Not for use by the faint-hearted non-native polyglot... toolboxhelp Toolbox documentation, as hypertext suitable for use with Guttorm Vik's !StrongHlp application. Covers more ground than the paper manuals (including things only documented in the header files...). This manual is the spare-time work of Neil Bingham (one of our software engineers), and is now in version 1.12. c5help Documents CLib5, both the ANSI and RiscOS specific bits such as kernel.h. Unless you are using RiscOSLib, this will replace Gareth Boden's 'C' manual. This manual is the spare-time work of Neil Bingham (one of our software engineers). General-purpose development tools will be uploaded to this area as they become available. Further tools for specialised development areas (eg Networking) are available by application and subsequent agreement with Acorn. Please write to Developer Support, or email isvquery@acorn.co.uk, for further details. disclaimer: The obvious file. docs: api: API and functional specs for various software things. freeway API for the Freeway module nc As much API information as possible on NC OS 1.06. nestwimp Functional spec and API for the Nested Wimp (3.86 - 3.98, pre-Ursula) plugin Functional specification and API for the browser plugin protocol (applicable to !NCFresco, !Browse, and ANT's !Fresco) textgadget Outline API and header files for the components of the TextGadgets module (Scrollbar, ScrollList and TextArea) uri Functional spec and API for the AcornURI module urlfetcher Functional spec and API for the URLFetcher module ursula Functional specs and APIs for the forthcoming iteration of RISC OS (codenamed "Ursula") to run on Phoebe. Currently contains details of CDFS, CDFSFiler, CDManager, Configure, FileCore, Filer, FilterManager, Help, the Kernel, PCI, Pinboard, SoundCtrl, Joystick, WindowManager and serial port control API. To be deleted shortly (contents of the reference/ro4 directory are to be used instead). appnotes Developer-specific Application Notes. dsnews Images of discs accompanying back issues of Developer Support News, by issue. These are now split into archives of the "original" (pre-Oct 1995) Acorn Developer News newsletters, and the more recent (1996 onwards) Developer Missives. fco Hardware Field Change Orders. See index file in fco directory. hardware Non-FCO hardware docs. Currently contains the Phoebe functional spec. misc Other documentation not categorisable in the above. Currently contains the questionnaire from the 1997 Developer Conference, Acorn's statement of Year 2000 conformity for RISC OS, a currently legally-unratified set of Y2K guidelines covering our old 8-bit hardware (y2kunrat.txt), copies of slides used at the 1998 Developer Conference, and a set of rough-and-ready guidelines on writing software for Phoebe / Ursula. The Phoebe / Ursula guidelines will be dleeted shortly (contents of the reference/ro4 directory are to be used instead). sales Developer price lists and order forms for Acorn products. egcode: filesystems Example source code for writing and interfacing to filing systems* lowlevel Example source code dealing with low level operations (vector claiming, device claiming, tickers etc)* misc Example source code not easily categorised in the below or two above options* plugin Example code for writing WWW browser plugins wimp Example source code for interfacing to the RISC OS Desktop* * see ReadMe files in the appropriate directories for further details. ReadMe: You're doing so. reference: applets Example standalone Java applets in bytecode. These are encoded as X-Files archives owing to their requirement for long filename support, and as such are denoted with the extension .xfi . The .xfi file should be downloaded and settyped appropriately ("x-file") before running the applet in situ rather than dearchiving it to HD. book+userg !Bookworm application ("file://" URL-based HTML browser) bundled with HTMLified RISC OS User Guide for reference and evaluation *only*. The whole "Manuals" directory should be copied to $ on the drive containing $.!Boot . Should you add your own HTML to this app, make sure that you do *NOT* delete any entries from the existing hotlist; it is likely that this will cause !Bookworm to break. Large! bookworm !Bookworm app, as above, but minus the bundled User Guide. Significantly smaller, for developers with modem link only. Conditions of use and notes as for "book+userg" above. bootstruct: fullj233boot Universal boot structure as shipped with the J233 system, suitable for use with RISC OS 3.10 - 3.71. dave1 Test stripped-down and heavily-compressed universal boot structure, which if verified correct will become licensable to developers for shipping (it's heavily stripped-down since, and the full structure takes up 16Mb uncompressed, products which include it would automatically have to ship on CD... this way, a floppy-based distribution remains viable). Please send all feedback on this archive to dwalker@acorn.co.uk . callaswi CallASWI module (and docs) to enable code written for RISC OS 3.7 / StrongARM to work on earlier systems cdrom CD ROM driver for the vanilla Apple CD-300 dir4player Director 4 standalone player and Shockwave browser plugin to play same, with notes. These are shipping as part of the J233 distribution. faults: Directory containing details of known faults (fixed and unfixed) with various Acorn products. Covers the Toolbox so far. hwtest Directory containing hardware test suites for all Acorn systems back to the Archimedes 300. You *must* read the ReadMe.txt for notes on use!! java072.arc Acorn's implementation of the Java 1.0.2 JAE as shipping as part of the J233 distribution. Note that JAE = JDK - source to bytecode compiler. j233distrib: Full unexpurgated copy of the disc structure as shipped on the J233 machine. nc Reference material for the Acorn NetStation; currently contains a bench-test copy of a server-side NC bootstrap sequence. This distribution must IN NO WAY be used for commercial gain (use it to boot your own NetStations on your own server internally for testing and developing apps by all means, but don't eg sell it, use it to set yourself up as a NetStation-serving ISP or otherwise let it propagate outside your company) - if you wish to use a server-side distribution in a commercial context, talk to me (dwalker@acorn.co.uk). Installation docs are now in this directory as dwbootdoc.arc and dwbootdoc.ps . Rough-cut docs on porting RISC OS software are now in this directory as porting.arc and porting.ps . risc_oslib Full source code for RISC_OSLib (StrongARM-compatible) ro35 "Disc rebuild kit" for RISC OS 3.5 systems which have lost their boot sequences or hard disc distributions; needs to be partially dearchived to two HD floppies, and installed on the casualty machine. ro36 "Disc rebuild kit" for RISC OS 3.6 systems which have lost their boot sequences or hard disc distributions; needs to be partially dearchived to two HD floppies, and installed on the casualty machine. ro4 Reference information on Phoebe / RISC OS 4. api Functional specifications and API details for modules in RISC OS 4. Currently comprises details of: CDFS CDFSFiler CDManager Joystick SoundCtrl Configure FileCore Filer Filter Manager Help Kernel PCI Pinboard Screensaver Wimp MIDI Manager devdocs Additional notes for developers. Comprises an overview of differences between Phoebe and Risc PC, and Risc OS 3.7 and 4.0, and a (currently unfinished) set of guidelines on memory management within applications. distrib Softloadable RISC OS 4 image for evaluation and testing, with installation docs, list of known bugs, and patch for the new !Boot. phoebelogos Archive of the Phoebe logo, in sprite and GIF form, with white and transparent backgrounds. strongarm Reference information on coding to maximise SA-110 compliance; includes details of the special StrongARM SWIs to be included in "RISC OS 3.70 ***INCLUDES SOFT-LOADABLE ROM AND DISC IMAGE OF RISC OS 3.7 (FORMERLY "RISC OS SA") FOR OS COMPATIBILITY TESTING*** Includes full RISC OS 3.7 API details and notes on coding / style / optimisation in the "docs" subdir. ***INCLUDES COPIES OF THE FROZEN FLOPPY DISC DISTRIBUTION WHICH WILL ACCOMPANY RISC OS 3.70. FOR USE ONLY WITH THE ROM VERSION OF THE OS*** As of 30/10/96, disc images checked against final distribution and disc1.arc updated to include patch for Acorn Advance. system The versions of !System, !Scrap and !SysMerge to ship with your applications for RISC OS 3.1-3.7. textgadget A single module comprising the Scrollbar, ScrollList and TextArea Toolbox gadgets (qv). toolbox Reference distribution of the Toolbox modules as shipped with the J233 boot structure. These modules have been tested on RISC OS 3.1 and upwards, and are the versions which developers should bundle with product. The distribution comprises: ColourDbox 0.17 ColourMenu 0.19 DCS_Quit 1.08 FileInfo 0.16 FontDbox 0.16 FontMenu 0.21 IconBar 1.18 Menu 0.32 PrintDbox 0.14 ProgInfo 0.14 SaveAs 0.15 Scale 0.13 ToolAction 0.15 Toolbox 1.41 Window 1.47 updates: c++mod New C++ wrapper, and modified C compiler, linker and stubs to enable C++ to be embedded more easily within relocatable modules colour The RISC OS 3.1x version of the Colour Picker module ddt181beta Beta version 1.81 of the DDT module (to replace the existing !Boot.Resources.!System.370.Modules.DDT) and of a !DDT with suitably-updated templates and !RunImage. This is the first build which is intended to run on Ursula. extrapdfs Beta Printer Definition Files for use with !Printers 1.53 and 1.54 filecore Soft-loadable version of the RISC OS 3.6 filecore (which allows >512Mb partitions) for RISC OS 3.5 machines hform248 Version 2.48 of hform, as shipping with RISC OS 3.71. This removes the "spurious bad sector on 2Gb boundaries" problem. hform250 Version 2.50 of hform, as shipping with the J233 system. This supersedes hform248 for use on RISC OS 3.7x, however hform248 remains recommended for use on RISC OS 3.6 systems. install Hard disc upgrade from RISC OS 3.5 disc build to RISC OS 3.55 build. internet5xx Softloadable Version 5.xx of the TCP/IP stack which ships in the RISC OS 3.70 ROM. This kit has been made available to encourage all third-party networking applications to become compatible with this new stack, and is supplied for development purposes *only* (although it may well work all the way back on RISC OS 3.10). java102074 Version 0.74 of Acorn's Java 1.0.2 JAE implementation. Only a few changes over and above the version on the J233 machine and RisCafe disc... java12102beta Beta version of the Java 1.2 JDK (JDK version 1.02). Includes source-to-bytecode compiler, etc. netbetadist WWW browser (which supports the Java VM etc (qv) as a plugin), dialler, postboxes, mail client etc. The mail client in this release *does not work*! netbetadocs HTML documentation for the above pmupdate Update to the beta ProgMan build environment and project manager, which fixes two bugs in the Developer CD release and adds another feature. redrawmanbeta Beta version of the new Toolbox redraw manager replay052 Beta version of Replay 3 (the multitasking version). Includes extensions to allow nesting of movies within movies, etc, under the Nested Wimp. replayfront Useful front-end app for Replay 3; functions as a movie launcher for up to 6 simultaneous movies. restools New versions of ResEd (0.44) and ResTest (0.72) for evaluation and testing. toolbox Collected Toolbox modules: Menu 0.33 TextGadget 0.11 ColourDbox 0.17 ColourMenu 0.19 DCS_Quit 1.08 FileDbox 1.00 FileInfo 0.17 FontDbox 0.16 FontMenu 0.21 IconBar 1.18 PrintDbox 0.14 ProgInfo 0.15 SaveAs 0.15 Scale 0.13 ToolAction 0.15 Toolbox 1.43 Window 1.54 These aren't the versions which developers should bundle with products, yet (see reference/toolbox.arc for those which are!). Please test and report back; they *should* be OK, but we want to be sure! ucmhg520 The core component of CMHG, which enables Ursula-compatible module headers to be used; see the Ursula Kernel spec for details of the modifications recommended to take advantage of the new service call handler. Additional software of interest to developers is available on the public-access ftp site ftp.acorn.co.uk and its mirrors; this software includes: /pub/riscos/releases: cupdate1.arc Spark archive of the update disc for the C/C++ suite. Comprises some extensions to ResEd and ResTest to allow for custom widgets and tools, assorted compiler patches, and a standalone version of flex(). dearchive.bas BASIC program which, when executed, builds a copy of !SparkPlug (for decompressing all the archives both on here and ftp.acorn) in your CSD. nspark.tar Does the same as dearchive.bas, only it's for UNIX and you have to compile the source. spriteextend.arc Soft-loadable copy of the SpriteExtend and SpriteUtil modules from RISC OS 3.6, which enable JPEG images to be embedded inside sprites. Documentation on ftp.acorn of interest to developers includes: /pub/documents/: ARM Datasheets from ARM Ltd detailing their RISC CPUs and support chips. Currently PostScript only; other formats coming somewhen. Includes data for ARM610, ARM710, ARM7500 and VIDC20. /pub/documents/products/: ExpSpec A document detailing the expansion card specification for all 32 bit machines. Included extensions specific to the Risc PC. PostScript and Drawfile versions. As with ftp.acorn, minor changes to the hierarchy (eg the addition of a new Application Note) will be detailed solely in /pub/ChangeLog; more major changes will be reflected here too.