Welcome to the demo of StormC 1.0 In November 1995 at the COMPUTER 95 we released the first German Preview of StormC. The visitors of the exhibition were amazed at the new concepts and innovations of StormC. Some impressions of articles of the German press regarding the Preview version: (I will try to translate it as close to the original as possible) Amiga Plus 1 / 96 New concepts of development and quality assurance... The first remarkable feature is the project management... Amiga magazine 1 / 96 The project management: At last there is a tool that does not feel like a "ball and chain", but is really useful. Amiga Special 2 / 96 A fast compiler, a powerful debugger and a comfortable development system are an interesting mixture, if we talk about professional software engineering.. With the enclosed demo you can convince yourself of these statements. Restraints of the demo: ================================ The enclosed compiler will compile your large sources but he will however write a maximum of 10 KB of object code. But you can get the assurance that your large projects can be compiled too. The linker can write programs with a maximum of 20 KB of size. All parts of StormC can NOT be started from CLI. They can be used only with the integrated environment. Important: =========================== This demo is optimised for installation from CD-ROM. If you have copied the files to your hard disk already you need not to do the installation. You should then enter solely an assign to StormC into the "user-startup", so the demo programs and the pre-sets of StormC can be used unchanged. Include - Licences: ================= If you have got the demo from a mailbox or from the Aminet, only our includes and libraries are included. For programming you will soon need the complete system includes of Kickstart/Workbench 3.1. How to get these includes? ------------------------------- 1. We can send you a demo of StormC with all includes, but you have to pay a charge of 20 $ (30 DM). This amount is deducted when you purchase StormC. You have to pay in advance. 2. You will find the complete includes and libraries on the CD 1/96 of the German "Amiga Magazin". 3. If you have got our Preview of StormC you have already got these files too. You only have to add the following files: In the includes drawer the directories: datatypes devices diskfont dos exec gadgets graphics hardware intuition libraries prefs resources rexx utility workbench In the libs drawer the libraries: amiga.lib small.lib debug.lib ddebug.lib Please do not use the includes of other compilers or directly these of other compilers or our Preview. We have altered some of them, so they will only work the way we told you. Modifications and expansions to the Preview: In General ---------- The complete environment is localised now. The pre-set language is English. Should you use an English Workbench but want to use the German StormC you have to rename the locale file "StormC:StormSYS/CATALOGE/German/StormCPP.catalog". Starting the program -------------- Contrary to the description in the manual on page 12 the start-up picture does not appear if your Workbench screen has less than 64 colours. In this case a small window appears and tells you that the system is still loading. Project management (StormShell): ------------------------------- You can use multiple selection on "add file(s)". You can drop Workbench icons (Appwindow) into the project windows. The new menu item "add library(s)..." is the same as "add file(s)...". The default path of the ASL file requester is set to "#?.lib". The only problem is: multiple selections are always alphabetically sorted by the ASL requester. The relevant sequence of libraries can only be kept if you add one library after the other to your project. If you add a new file an icon will be created too (optional). The icon is taken from "ENV:STORMCPP/def_text.suffix". ".suffix" represents the suffix of the file name (e.g. c or h). So you can have different icons for different kinds of sources. The pre-sets can be saved and loaded by the StormShell. Two new option pages were added to the project defaults. Another for the optimiser of the compiler. Nearly every parameter of the shell environment can be set at the start of a program. The setting for 32 bit correct multiplication has been deleted. The compiler now decides automatically which multiplication is required. You can now select small or large code model. Hint: We do not deliver libraries that support small code model with the demo. If you select this option your program will not work. "Make" and "Compile" automatically save your sources now. The functions of the icon bar are available by function keys F1 to F10 now. The About window and the option windows can be closed with ESC too. The error window is now accessible by keys: Use "w" toggles warnings on/off. Use the cursor keys go through the error list. Use + cursor keys to go to the first or last error message. Use to indicate the error message in the editor. The project window is completely accessible by keys too. Use the cursor keys to move the cursor and the contents. / jumps to start/end of the entries / jumps to the margins executes the action the respective alternative Backspace and/or Delete deletes the entry under the cursor from the project. Debugger (StormRUN): -------------------- The debugger demo described in the manual unfortunately only works with operating system V39 and higher. If you have V37/38 you should try the Gadtools demo. The menu item "save program as..." is not available in the current demo, because we are changing some things. The values of simple number types (char - long) can be changed in all variable and inspect windows. We added a hex editor. With the Tab key you can jump between the columns. Use "Save Settings" to store the layout of the hex editor. The type output has two modes: ANSI-C or AMIGA-C (with ULONG, BYTE ...). The compiler can not save this in its debug information so we use the Amiga-C notation (more compact). Resource-Tracking is now implemented. If you end a program or "Kill" it screens, windows, memory, libraries, locks and files that were not closed or released will be shown. A double click onto the entry of the list brings you to the according function call. The new menu "Debug" got the menu item "Flush Resources" to release these resources. The resource tracking can determine the direct "caller" only. I.e. the function which contains jsr d(a6). A stub function for library calls prevents the correct indication of the call. So you should avoid stub functions and use "pragma amicall" and "tagcall". Editor: ======= Dictionary files and manual colouring ---------------------------------------- Lexikon (0001) Amiga characters 0x00ff0000 0xffffffff 2 0 0 VOID LONG... Line 1: This line identifies the file as lexicon and carries the version number of the lexicon file. Line 2: Comments Line 3: RGB colour foreground and RGB colour background (V39 and higher) foreground pen number and background pen number (V37 and V38) pen number Line 4: Initial letters on/off Line 5 - ...: Contents From operating system V39 and higher RGB colours can be used for the lexicon. The first two numbers indicate the RGB colour for font and background colour (24 bit). You can use hex numbers with "0x" as well. If you use Kickstart V37/V38 pen numbers and colour are fixed. You should run StormC on a screen with at least 8 colours to get best results. Attention: ---------- As yet there is no error message if you use a non-existing or non-proportional font. We recommand to use only fonts with characters of the same width. Courier is not such a font. Some characters are broader than the width indicated in the font. So there may be some strange effects at the margin of the text. Find&Replace are now completely accessible by keys. We integrated a simple print function which prints the whole text. Keyboard settings: ----------------- Shift-Cursor Up/Down Moves the cursor to the first/last line. Shift-Cursor Left/Right Moves the cursor to the first/last column of the current line. Alt-Cursor Up/Down Jumps to the beginning/end of the text. Alt-Cursor Left/Right Moves the cursor to the next word before or to the last behind the cursor. Shift-Delete or Shift-Backspace Deletes the line under the cursor. The line is stored in the clipboard. Alt-Delete Deletes the line from the cursor position up to the end of the line. Alt-Backspace Deletes the text between the first column up to the cursor. Help Sends the word under the cursor to the Hothelp library V3.0 (14. Feb 94). MagicMenu and SUN-Mouse-Utilities --------------------------------- If you use MagicMenu the mouse pointer freezes up to 10 seconds if you are pressing the right mouse button over an icon of the icon bar. This is because MagicMenu is not very OS compliant. The same problem can appear with other SUN mouse utilities too. If you have any questions please feel free to contact us: HAAGE & PARTNER Computer GmbH Mainzer Strasse 10 A 61191 Rosbach Germany Tel: ++49 06007 93 00 50 Fax: ++49 06007 75 43 Internet: 100654.3133@compuserve.com Compuserve: 100654,3133 Please visit our home page to get the newest information on StormC: http://home.pages.de/~haage Now we want to thank our beta testers. Thank you very much: Dietmar Augustin Olaf Barthel Michael Bergmann Holger Burkarth Thomas Bayen Bernhard Büchter Michael Donner Torsten Ebeling David Göhler Clemens Marschner Alexander Pratsch Andreas Pfohl Constantin Rack Michael Rock Jürgen Schildmann Carsten Schlote Stephan Schüerholz Thomas Wilhelmi Special thanks to Jeroen T. Vermeulen. (c) 1995/1996 HAAGE & PARTNER Computer GmbH