home *** CD-ROM | disk | FTP | other *** search
/ Micro R&D 1 / MicroRD-CD-ROM-Vol1-1994.iso / os20 / util / sslexamp.lha / README < prev    next >
Text File  |  1993-11-06  |  6KB  |  195 lines
  1.  
  2.                           SS.Library Example Programs
  3.  
  4.                 Written by Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    This directory contains some useful utilities, which use the ss.library.
  13. Assembly source files (#?.asm) are included.
  14.  
  15.    All files in this archive may be freely distributed and modified without
  16. any restrictions.
  17.  
  18.    All the utilities require kickstart 2.04 or higher and the ss.library.
  19.  
  20.  
  21. Inf
  22. ===
  23.  
  24.    This small utility is similar to the standard Info command, but displays
  25. much more information about the devices followed by short description of
  26. available memory.
  27.  
  28. Inf output is divided to nine columns:
  29.  
  30. Device - name of DOS device (for example DF0:)
  31.   Size - disk size
  32.   Free - free space
  33.   Free - free space in percents of total capacity
  34.   Stat - status - R/W=Read/Write,VAL=Validating,R/O=Read Only
  35.    Err - number of errors detected during disk access
  36.   Type - filesystem type (OFS,FFS,OFSI=OFS INTL,FFSI=FFS INTL,OFSC=OFS DIRC
  37.                           FFSC=FFS DIRC,MSD=MSDOS,MSDD=MSDOS DD)
  38.  Block - block size
  39. Volume - volume name
  40.  
  41. The device information is followed by summary of Chip, Fast and Slow (C0-RAM)
  42. memory: <RAM name> : <free space> (<largest>) of <total size>.
  43.  
  44.  
  45. DVIType
  46. =======
  47.  
  48.    Analyser of TeX Device Independent output files.
  49.  
  50. Usage: DVIType <DVI File>
  51.  
  52. Output syntax: <address> <command> [<parameters>]
  53.  
  54. For command summary see source text of TeX.
  55.  
  56.  
  57. AddModule
  58. =========
  59.  
  60.    AddModule is able to install resident modules to KickTag and KickMem lists,
  61. which makes them reset-proof.
  62.  
  63. Syntax: AddModule <ModuleName> [CLASS <class>] [PRI <pri>] [INIT]
  64.  
  65. ModuleName - name of resident module you want to install
  66.      class - module class 0-127 (see exec/resident.i). The seventh bit cannot
  67.              be overriden
  68.        pri - module priority -128-127
  69.  
  70.    You may also try to install usual libraries and devices as resident modules.
  71. In this case, specify CLASS 4 and PRI -128. If some library uses some other,
  72. try to arrange the priorities in appropriate order. The ss.library can be
  73. installed by this way.
  74.  
  75.  
  76. NewAlertHook
  77. ============
  78.  
  79.    This is a resident module (must be installed by AddModule) replacing
  80. standard alert display mechanism by slightly improved routine, which is
  81. able to show error text and name of process causing the error. The module
  82. itself doesn't require the ss.library.
  83.  
  84.    Thanks to Brian Gontowski for inspiration (InstallNewAlert). This one
  85. is only 3K long.
  86.  
  87.    Currently includes all alerts up to those generated by kickstart 3.0.
  88.  
  89.  
  90. TwoWindows
  91. ==========
  92.  
  93.    An useless example of asynchronous file I/O. Opens two console windows
  94. labeled "First Window" and "Second Window". Any text written to the first
  95. one is copied to the second one and vice versa. To abort the program,
  96. enter CTRL-\ (EOF) in both windows.
  97.  
  98.  
  99. AsmCheck
  100. ========
  101.  
  102.    Some assembly language compilers don't allow spaces inside expression
  103. and treat them as line termination. This tiny utility checks the source files
  104. for occurence of such spaces and writes message about each suspicious line.
  105.  
  106. Syntax: AsmCheck <file> (wildcards may be specified)
  107.  
  108.  
  109. KeyRes
  110. ======
  111.  
  112.    KeyRes is a keymap analyser. It takes a keymap file and disassembles it
  113. to special source file.
  114.  
  115. Syntax: KeyRes <from> [<to>]
  116.  
  117.   from - name of keymap to be disassembled. It can be stored in RAM or on
  118.          a disk.
  119.     to - name of file to store the output to. Default is <from>.kms.
  120.  
  121. Keymap source file is a sequence of key definition blocks, which have the
  122. following syntax:
  123.  
  124. [<KEY TYPE>] KEY <NAME> [{<QUAL>}] [CAPS]
  125. <followed by several lines of key meanings>
  126.  
  127.   Key type - can be DEAD, STRING or empty
  128.       Name - key name (described below)
  129.       Qual - qualifiers affecting processing of this key (SHIFT, ALT, CTRL)
  130.       CAPS - set if CAPS LOCK act as SHIFT
  131.  
  132. Key names:
  133.  
  134. TILDE, ONE, TWO, THREE, FOUR, FIVE, SIX, SEVEN, EIGHT, NINE, ZERO, MINUS,
  135. EQUAL, BACKSLASH, K0, Q, W, E, R, T, Y, U, I, O, P, LBRACK, RBRACK, K1, K2,
  136. K3, A, S, D, F, G, H, J, K, L, SEMICOLON, APOSTROPHE, HASH, K4, K5, K6,
  137. LESS, Z, X, C, V, B, N, M, COMMA, DOT, SLASH, KDOT, K7, K8, K9, SPACE,
  138. BACKSPACE, TAB, KENTER, ENTER, ESC, DEL, KMINUS, UP, DOWN, RIGHT, LEFT, F1,
  139. F2, F3, F4, F5, F6, F7, F8, F9, F10, KLBRACK, KRBRACK, KSLASH, KASTERISK,
  140. KPLUS, HELP, LSHIFT, RSHIFT, CAPSLOCK, CONTROL, LALT, RALT, LAMIGA, RAMIGA.
  141.  
  142. Key meaning:
  143.  
  144. Normal keys        [<QUAL>] '<character>' | <character code>
  145.                |        |
  146.                |        *--- character generated by this key
  147.                |
  148.                *-- qualifiers of this meaning (SHIFT,ALT,CTRL)
  149.                |
  150. String keys        [<QUAL>] "<string>"
  151.                |         |
  152.                |         *--- string generated by this key
  153.                |            use "" or \" for double quotes
  154.                |            use \cc for hex. char. code
  155.                |
  156.                |
  157. Dead keys        [<QUAL>] '<character>' | <character code>
  158.                |        |
  159.                |        *-- code of meaning not affected
  160.                |            by prefix (dead) keys
  161.             [<QUAL>] PREFIX <num>
  162.                |          |
  163.                |          *-- # of prefix generated by this key
  164.             [<QUAL>] PREFIX <p1>,<p2>
  165.                |   used if prefix has to be pressed twice to get
  166.                |   some other meaning. In this case, the final
  167.                |   prefix code is <p1_of_first_prefix> *
  168.                |   <p2_of_second_prefix> + <p1_of_second_prefix>.
  169.             [<QUAL>] MOD { '<char>' | <code> , ... }
  170.                     |
  171.                     *-- meaning modified by dead keys
  172.                         contains list of characters -
  173.                         - for each prefix code one char.
  174.  
  175.  
  176. KeyComp
  177. =======
  178.  
  179.    Keymap compiler - does reverse process to KeyRes. Useful for creating
  180. of keymaps in non-interactive way.
  181.  
  182. Syntax: KeyComp <source> [<dest>]
  183.  
  184.    source - source file (.kms is appended if there's no extension in it)
  185.      dest - destination file (if omitted, source file name without extension
  186.         is substituted)
  187.  
  188.  
  189.  
  190. Final words
  191. ===========
  192.  
  193.    Send bug reports and suggestions to mjsoft@k332.feld.cvut.cz.
  194.  
  195.