home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 224b.lha / names.doc < prev    next >
Encoding:
Text File  |  1989-04-08  |  7.2 KB  |  237 lines
  1.  
  2. The text files in this directory can be loaded into Forth after Include.blk
  3. is loaded.  It's advisable to create vocabularies for each of the
  4. different subdirectories.  Intuition, Exec and Graphics are already
  5. declared in the kernel. Dos can be treated as one of the above also. The
  6. files for Dos are under i/libraries.
  7.  
  8. The files will not load if they have already been loaded, as long as the
  9. definitions are visible in 'context'.
  10.  
  11. At the end of this file is the amount of dictionary space required for each
  12. include file.  Total is about 84k, if you have a 1 meg machine you could
  13. load all the definitions and still have enough for a few screens, 2 meg
  14. would do better. 512K (that's me) have to be a little bit more carefull in
  15. selecting what to include.  Also make your startup allocate the 'User'
  16. dictionary for the size you expect to be using. E.g. if you need about 64k
  17. for your routines and also want to load in all the include files:
  18.             run forth 25000 open Utilities.blk ok
  19. would allocate enough for the dictionary. (The number is in hex).
  20.  
  21.  
  22. LIBRARIES:
  23. ==========
  24.  
  25. The following names and library base indices have been declared:
  26.  
  27. The first three are defined in Kernel, Forth wouldn't run without them:
  28.  
  29.         >Exec       for exec.library
  30.         >Dos        for dos.library
  31.         >Intuition  for intuition.library
  32.         >Graphics   for graphics.library
  33.  
  34.  
  35. No name words are required for these.
  36. That leaves the following libraries:
  37.  
  38.     >Layers     LAYERSNAME     layers.library     ( libraries/layers )
  39.     >Math       MATHNAME       mathffp.library    ( libraries/mathffp )
  40.     >MathTrans  MATHTRANSNAME  mathtrans.library  ( libraries/mathffp )
  41.     >Translator TRANSLATORNAME translator.library ( libraries/translator )
  42.     >Icon       ICONNAME       icon.library       ( workbench/icon )
  43.     >Diskfont   DFNAME         diskfont.library   ( libraries/diskfont )
  44.  
  45. Not implemented
  46.  
  47.     >Clist
  48.     >MathIeeeDoub
  49.     >MathIeeeSing
  50.  
  51. DEVICES.
  52. ========
  53.  
  54. The following DEVICES were also defined:
  55.  
  56.     >Con   for console.device, already opened in Kernel. Didn't name it.
  57.                                                   ( devices/conunit )
  58.     >Timer     TIMERNAME       timer.device       ( devices/timer )
  59.                TD_NAME         trackdisk.device   ( devices/trackdisk )
  60.                AUDIONAME       audio.device       ( devices/audio )
  61.                PARALLELNAME    parallel.device    ( devices/parallel )
  62.                SERIALNAME      serial.device      ( devices/serial )
  63.  
  64. RESOURCES.
  65. ==========
  66.  
  67. Resource names and base indices defined:
  68.  
  69.     >Ciaa      CIAANAME        ciaa.resource      ( resources/cia )
  70.     >Ciab      CIABNAME        ciab.resource      ( resources/cia )
  71.     >Disk      DISKNAME        disk.resource      ( resources/disk )
  72.     >Misc      MISCNAME        misc.resource      ( resources/misc )
  73.     >Potgo     POTGONAME       potgo.resource     ( resources/potgo )
  74.  
  75.  
  76. How to use them:
  77. ----------------
  78.  
  79. In the kernel an array of open bases is defined. libbases.
  80. Each base becomes an index in that array. e.g. >Exec is 0 the first
  81. entry in the array. >Dos is the second and is a constant 4.
  82. Any other constant can be defined and metacompiled.
  83.  
  84. If the array, defined in kernel, is large enough, you can make your own
  85. index to be used. E.g. to use the icon, without compiling into the
  86. kernel.
  87. Define the index constant:
  88.   libbase# @ 4* constant >Icon   1 libbase# +!
  89. Next load in the calls, from the workbench/icon file, then open the
  90. library before using them:
  91.    :.... ICONNAME  0 OpenLibrary libbases >Icon + ! ....;
  92. When finished, you can close it or let the system close it.
  93.    :.... libbases >Icon + @ CloseLibrary  libbases >Incom + off ...;
  94.  
  95. added note: have defined the following word:
  96. : libindex:   libbase# @ 4* constant 1 libbase# +!   ;
  97. it creates the next index.
  98.  
  99.  
  100. FILESIZES.
  101. ==========
  102.  
  103. Following are the dictionary requirements for each file.
  104.  
  105.      libraries
  106.      ---------
  107.        configregs       2238
  108.        configvars        528
  109.        diskfont          838 *
  110.        dos              3424 **
  111.        dosextens        3248    6672 ( subtotal dos+dosextens )
  112.        filehandler       766
  113.        layers            864
  114.        mathffp           852
  115.        translator        224
  116.                         ----
  117.                        12982
  118.  
  119.         * Name conflict in diskfont. AvailFonts is a structure and a
  120.           system call. Have renamed the system call Availfonts.
  121.         ** Name conflict in dos. DateStamp is a structure and a
  122.            system call. Have renamed the system call Datestamp.
  123.         dosextens requires dos to be loaded first.
  124.  
  125.      workbench
  126.      ---------
  127.        icon              504
  128.        startup           252
  129.        workbench         962
  130.                         ----
  131.                         1718
  132.  
  133.      exec
  134.      ----
  135.        alerts           3032
  136.        devices           296
  137.        errors            142
  138.        execbase         1336
  139.        interrupts        442
  140.        io                792
  141.        libraries         780
  142.        lists             424
  143.        memory            882
  144.        miscellaneous     144
  145.        nodes             614
  146.        ports             436
  147.        resident          534
  148.        semaphores        702
  149.        tasks            1654
  150.                        -----
  151.                        12210
  152.  
  153.      graphics
  154.      --------
  155.        clip              952
  156.        collide           150
  157.        copper            876
  158.        display           462
  159.        gels             2350
  160.        gfx               580
  161.        gfxbase           988
  162.        graphint          138
  163.        layers            630
  164.        rastport         2210
  165.        regions           486
  166.        sprite            282
  167.        text             1342
  168.        view             1262
  169.                        -----
  170.                        12708
  171.  
  172.      intuition
  173.      ---------
  174.        border            234
  175.        gadget           2580
  176.        image             250
  177.        intuimessage     1086
  178.        intuitext         298
  179.        intuitionbase     266
  180.        menu             1260
  181.        miscellaneous     362
  182.        preferences      2786
  183.        remember          188
  184.        requester         934
  185.        screen           1482
  186.        window           2530
  187.                        -----
  188.                        14256
  189.  
  190.      resources
  191.      ---------
  192.        cia               398
  193.        disk              978
  194.        misc              384
  195.        potgo             188
  196.                         ----
  197.                         1948
  198.  
  199.      hardware
  200.      --------
  201.        adkbits           998
  202.        blit             1364
  203.        cia              3118
  204.        custom           1868
  205.        dmabits           808
  206.        intbits           846
  207.                         ----
  208.                         9002
  209.  
  210.      devices
  211.      -------
  212.        audio             966
  213.        bootblock         262
  214.        clipboard         592
  215.        console          1368
  216.        conunit           938
  217.        gameport          586
  218.        input             260
  219.        inputevent       2730
  220.        keyboard          196
  221.        keymap            930
  222.        narrator         1210
  223.        parallel         1140
  224.        printer          2930
  225.        prtbase          1736
  226.        serial           2110
  227.        timer             434
  228.        trackdisk        1800
  229.                        -----
  230.                        20188
  231.  
  232.                                 ========
  233.     Grand Total                   85,012 bytes.
  234.  
  235.  
  236.  
  237.