⟦d79a457d5⟧

TextFile

~comment( 

   File: Keymap_Pcbasic_User_Defs  
   Date: August 26, 1991
   Type: Source file for Compose-generated Keymap Overlay
   Implementation: Pcbasic terminal type for RWI

   This file contains the Compose source to generate a keymap
   overlay for the Pcbasic terminal type for RWI.

   Users can either: 
   
      * copy this file with another name, and then modify
        the copy to create printed keymap overlays of custom
        keybindings that are based on the Pcbasic terminal type.
      
      * Run Compose on this file as is, and then print the 
        resulting Keymap_Pcbasic_User_Defs_Ps PostScript file.

   The recommended naming convention for the copied file is:
   
      Keymap_<Pcbasic>_User_Defs
      
   Where <Pcbasic> is replaced with a unique name related to the
   actual key binding. For example, four keymap overlays are 
   distributed with RWI:
                                        
      Keymap_Pcbasic_User_Defs
      Keymap_Pc101_User_Defs
      Keymap_Pc91_User_Defs
      Keymap_Pc86_User_Defs
   
   Two other files are included by Keymap_Template_User_Defs
   
      Keymap_Template_Macros
      Keymap_Template_Tables
      
   In most cases, users will not modify these two files--the files
   are simply included by Keymap_<Pcbasic>_User_Defs)
   
~comment(=================== Building Your Keymap =====================)

   ~comment(
   To build your keymap:
   
      1. Make your custom changes to a renamed copy of this file, as
         instructed in each section below.
         
      2. Run Compose on the modified Keymap_Pcbasic_User_Defs file
         (or your renamed copy), and correct any errors.
      
      3. After Compose runs without errors, print the generated
         PostScript output file, Keymap_<Pcbasic>_User_Defs_Ps. )
               

~comment(==================== Text Entry Notes ========================)

~comment(
   All text entries are entered as parameters to macros.  Any text entry
   can be enclosed in formatting macros, such as ~bold(text) and
   ~italic(text) if desired.  If the length of a text entry exceeds the
   available table column width, the column entry will wrap to the next
   line.  In most cases, this is undesirable, so experiment with
   abbreviations and alternative words until each column entry is
   printed on one line. )

~comment(============ Include Structure Definition Macros =============)

   ~comment(
   This file contains definitions for the macros used in
   Keymap_Template_User_Defs and Keymap_Template_Driver. 
   In most cases, you can ignore the Keymap_Template_Macros file.)

   ~include(Keymap_Template_Macros)


~comment(================ Modifiable Keymap Title =====================)

   ~comment(Change the ~keymap_title text argument to suit your
            application. )

   ~keymap_title(Rational Environment Keymap for PCbasic)


~comment(==== Modifiable Headings for each Column of Function Keys ====)

   ~comment(
   Provide heading text as arguments to the following macros.  For
   example, if you want the heading HELP to appear over the column for
   the F1 key, then use ~Heading_F1(HELP). )

   ~Heading_F1(F1)
   ~Heading_F2(F2)
   ~Heading_F3(F3)
   ~Heading_F4(F4)
   ~Heading_F5(F5)
   ~Heading_F6(F6)
   ~Heading_F7(F7)
   ~Heading_F8(F8)
   ~Heading_F9(F9)
   ~Heading_F10(F10)
   ~Heading_F11(F11)
   ~Heading_F12(F12)


~comment(================= Turning Modifier Rows OFF ==================)


   ~comment(
   Each row in the keymap table represents the bindings for each
   function key in a specific modifier state, such as [Shift].  By
   default, all eight rows are printed.  If you want to turn one or more
   rows off, so that they are not printed, add one or more of the
   following macros after this comment:
   
       ~Turn_OFF_CMS_row
       ~Turn_OFF_MS_row
       ~Turn_OFF_CM_row
       ~Turn_OFF_CS_row
       ~Turn_OFF_M_row
       ~Turn_OFF_C_row
       ~Turn_OFF_S_row
       ~Turn_OFF_BASE_row

    For example, if you want to exclude the CMS, MS, CM, and CS modifier
    rows, you add the following macros after this comment:

       ~Turn_OFF_CMS_row
       ~Turn_OFF_MS_row
       ~Turn_OFF_CM_row and
       ~Turn_OFF_CS_row
       
    Then the printed keymap contains only the M, C, S, and BASE rows.
    [END OF COMMENT] )
    
                     
~Turn_OFF_CMS_row
~Turn_OFF_MS_row
~Turn_OFF_CM_row
~Turn_OFF_CS_row
~comment(This is the beginning PCBASIC keymap. To create the
         advanced PCBASIC keymap, comment out the following three switches:) 
~Turn_OFF_M_row
~Turn_OFF_C_row
~Turn_OFF_S_row
                                                                       
    
~comment(=============== Defining the Keymap Entries ===================)

   ~comment(
   The following 13 macro groups are associated with the 12 function keys
   and the modifier keys: Modifiers, F1, F2, F3, F4, F5, F6, F7, F8, F9,
   F10, F11, F12.
   
   Each macro group accepts text arguments to be printed on
   the keymap. 
   
      * The macros in the Modifier group label each row of the keymap:
        these rows are associated with the eight modifier key combinations
        possible with each function key.
   
      * The F1 through F12 macro groups specify the actual
        keybindings in each column of the keymap: each column is
        associated with one of twelve function keys. Each of these
        columns can contain up to eight keybindings--one for each
        modifier-combination of a given function key.

   You can modify your keymap overlay by replacing the text arguments in
   specific macros. For example, if you want the keymap entry for
   [Shift] [F1] to read "Help On Cmd", then:
   
      1. Find the ---- F1 ---- group of macros representing
         all modified states of F1.
         
      2. Change the ~S_F1() macro to: ~S_F1(Help On Cmd)
      

~comment(---- Modifiers ----)
                              


   The standard modifier abbreviations are predefined in the "Modifiers"
   group. The modifier abbreviations name each row of the keymap
   overlay that is associated with a given modifier key combination, for
   example, [Control-Shift].
   
   You can change these if desired. For example, if you wanted to use
   'A' instead of 'M' for the Alt/Meta key, you would change ~M(M) to be
   ~M(A), and likewise for the other modifiers containing 'M'. )

   ~CMS(CMS) ~comment(Control-Meta-Shift)
   ~MS(MS)   ~comment(Meta-Shift)
   ~CM(CM)   ~comment(Control-Meta)
   ~CS(CS)   ~comment(Control-Shift)
   ~M(M)     ~comment(Meta)
   ~C(C)     ~comment(Control)
   ~S(S)     ~comment(Shift)
   ~BASE()   ~comment(no modifiers) 
   

~comment(---- F1 ----)

   ~CMS_F1()
   ~MS_F1()
   ~CM_F1()
   ~CS_F1()
   ~M_F1(Design Definition)
   ~C_F1(Home Library)
   ~S_F1(Definition in place)
   ~F1(Definition)

~comment(---- F2 ----)

   ~CMS_F2()
   ~MS_F2()
   ~CM_F2()
   ~CS_F2()
   ~M_F2(Design Enclosing)
   ~C_F2(Enclosing Library)
   ~S_F2(Enclosing in place)
   ~F2(Enclosing)

~comment(---- F3 ----)

   ~CMS_F3()
   ~MS_F3()
   ~CM_F3()
   ~CS_F3()
   ~M_F3(Design Preview)
   ~C_F3(Source World)
   ~S_F3(Demote)
   ~F3(Edit)

~comment(---- F4 ----)

   ~CMS_F4()
   ~MS_F4()
   ~CM_F4()
   ~CS_F4()
   ~M_F4(Create Directory)
   ~C_F4(Create Text)
   ~S_F4(Create Body)
   ~F4(Create Command)

~comment(---- F5 ----)

   ~CMS_F5()
   ~MS_F5()
   ~CM_F5()
   ~CS_F5()
   ~M_F5(Invoke Debugger)
   ~C_F5(Code World)
   ~S_F5(Code Unit)
   ~F5(Promote)

~comment(---- F6 ----)

   ~CMS_F6()
   ~MS_F6()
   ~CM_F6()
   ~CS_F6()
   ~M_F6(Design Complete)
   ~C_F6()
   ~S_F6(Check Out)
   ~F6(Complete)

~comment(---- F7 ----)

   ~CMS_F7()
   ~MS_F7()
   ~CM_F7()
   ~CS_F7()
   ~M_F7(Design Format)
   ~C_F7()
   ~S_F7(Check In)
   ~F7(Format)

~comment(---- F8 ----)

   ~CMS_F8()
   ~MS_F8()
   ~CM_F8()
   ~CS_F8()
   ~M_F8(Design Explain)
   ~C_F8()
   ~S_F8(Explain)
   ~F8(Semantics)

~comment(---- F9 ----)

   ~CMS_F9()
   ~MS_F9()
   ~CM_F9()
   ~CS_F9()
   ~M_F9(Display Value)
   ~C_F9(Source Location)
   ~S_F9(Image)
   ~F9(Object)

~comment(---- F10 ----)

   ~CMS_F10()
   ~MS_F10()
   ~CM_F10()
   ~CS_F10()
   ~M_F10(Set Break)
   ~C_F10(Execute to Break)
   ~S_F10(Word)
   ~F10(Window)

~comment(---- F11 ----)

   ~CMS_F11()
   ~MS_F11()
   ~CM_F11()
   ~CS_F11()
   ~M_F11(Single Step)
   ~C_F11(Step Local)
   ~S_F11(Mark)
   ~F11(Region)

~comment(---- F12 ----)

   ~CMS_F12()
   ~MS_F12()
   ~CM_F12()
   ~CS_F12()
   ~M_F12(Show Breaks)
   ~C_F12(Activate Break)
   ~S_F12(Macro)
   ~F12(Line)
                             
~comment(=============== Numeric Keypad Entries ================)

   ~comment(
   If you do not need the numeric keypad overlay, add the macro:
      ~Turn_OFF_num_pad  )
~Turn_OFF_num_pad

   ~comment(--- Turning OFF the numeric keypad overlay ---
            If you do not need the numeric keypad overlay, add the
            macro: ~Turn_OFF_num_pad )
      

   ~comment(Description and Layout:
            This numeric keypad is based on the PC101 keyboard. Other
            keyboards may have a different numeric keypad layout, or 
            none at all. You may find the alternative nine-key pad 
            better suited for some numeric keypads.
            
            The numeric keypad is printed in three pieces: Part A, 
            Part B, and Part C. These three pieces are to be pasted
            together, as instructed by the tab notes.
            
            The layout of the ~NumKey macros in relation to the 
            numeric keypad is:
            
            ------------- -------------- --------------- --------------
           |~NumKey_Lock |~NumKey_Slash |~NumKey_Star   |~NumKey_Minus |
            ------------- -------------- --------------- --------------    
           |~NumKey_7    |~NumKey_8     |~NumKey_9      |              |    
            ------------- -------------- ---------------  ~NumKey_Plus |   
           |~NumKey_4    |~NumKey_5     |~NumKey_6      |              |    
            ------------- -------------- --------------- --------------           
           |~NumKey_1    |~NumKey_2     |~NumKey_3      |              |    
            ------------- -------------- --------------- ~NumKey_Enter |  
           |       ~NumKey_0            |~NumKey_Decimal|              |
            ----------- ----------- ----------- -------- --------------     
                                                    
                                                    
           The keypad overlay will print in three parts, which you glue
           together.
           
           Entries for the ~NumKey macros:
           
              Two Compose markup macros are used in the ~NumKey entries:
              the carriage return macro is (~<) and the hard space is (~ ).
              These macros are necessary for proper formatting of the 
              table. You include these markup macros with your keybindings.
              
              For example, if the key Numeric 7 is bound to the Begin Of
              command, you would change:
              
                  ~NumKey_7(7~<) to be ~NumKey_7(7~<Begin Of)
                  
              This will print a keycap on the overlay that looks something
              like:
              
                   ----------
                  | 7        |
                  | Begin Of |
                   ----------
              
              Certain keys are more complicated: 0, ., +, and Enter.
              
              For example, to add the Image binding to the
              ~NumKey_Plus(~<+~<~<~<) macro, change it to:
              ~NumKey_Plus(~<+~<Image~<~<). This will produce a keycap
              on the overlay similar to:
              
                   ----------
                  |          |
                  | +        |
                  | Image    |
                  |          |
                  |          |
                   ----------
              
              Experiment with the markup macros until you achieve the
              desired results.  Just in case you need the original
              arguments to the macros, they are included here for
              reference:
              
                   ~NumKey_0(0~<~ ~ )
                   ~NumKey_1(1~<)
                   ~NumKey_2(2~<)
                   ~NumKey_3(3~<)
                   ~NumKey_4(4~<)
                   ~NumKey_5(5~<)
                   ~NumKey_6(6~<)
                   ~NumKey_7(7~<)
                   ~NumKey_8(8~<)
                   ~NumKey_9(9~<)

                   ~NumKey_Decimal(.~<~ ~ )
                   ~NumKey_Enter(~<~<Enter~<~<)
   
                   ~NumKey_Lock(Num~< Lock)
                   ~NumKey_Slash(/~<)
                   ~NumKey_Star(*~<)
                   ~NumKey_Minus(-~<~ ~ )
                   ~NumKey_Plus(~<+~<~<~<)


               END OF COMMENT )

      
   ~NumPad_title(Numeric Keypad)

   ~NumKey_0(0~<~ ~ )
   ~NumKey_1(1~<End Of)
   ~NumKey_2(2~<Cursor Down)
   ~NumKey_3(3~<Image Down)
   ~NumKey_4(4~<Cursor Left)
   ~NumKey_5(5~<)
   ~NumKey_6(6~<Cursor Right)
   ~NumKey_7(7~<Begin Of)
   ~NumKey_8(8~<Cursor Up)
   ~NumKey_9(9~<Image Up)
   ~NumKey_Decimal(.~<EOI~ ~ )
   
   ~NumKey_Lock(Num~< Lock)
   ~NumKey_Slash(/~<Line)
   ~NumKey_Star(*~<Word)
   ~NumKey_Minus(-~<Mark~ ~ )

   ~NumKey_Plus(~blankspace(15points)+~<Image~<)
   ~NumKey_Enter(~blankspace(23points)Enter~<~ ~<)
   

~comment(================ Other Keymap Entries =================)

~Turn_OFF_all_groups

   ~comment(
   This section contains four general-purpose sets of grouped key
   labels that are useful for various keyboard applications:
   
      Nine-key group  (3x3 matrix)
      Six-key group   (2x3 matrix)
      Three-key group (1x3 matrix)
      Eighteen single keys
   
   If you don't want any of these key groups to print, simply add the
   macro:
   
      ~Turn_OFF_all_groups

   If you want to selectively exclude some groups, but print others,
   add one or more of the following macros:
   
      ~Turn_OFF_nine_key_group
      ~Turn_OFF_six_key_group
      ~Turn_OFF_three_key_group
      ~Turn_OFF_single_key_group   )
      
   ~comment(
   If you want each row to print wider, simply embed return
   macros ( ~< ) in your text entries. For example, to make
   a fat label, the key entry could be similar to:
   
      ~Key9_1(~< one ~<)    )  


   ~Turn_OFF_nine_key_group
   ~comment(Nine-Key Group:
   
            * * *
            * * *
            * * *    This group may be useful for some numeric 
                     keypad applications.)

   ~nine_key_group_title(Nine-Key Group)
   ~Key9_1(one)
   ~Key9_2(two)
   ~Key9_3(three)
   ~Key9_4(four)
   ~Key9_5(five)
   ~Key9_6(six)
   ~Key9_7(seven)
   ~Key9_8(eight)
   ~Key9_9(nine)

   ~comment(Six-Key Group:
   
            * * *
            * * *    This group is useful for the auxiliary keypad
                     on the PC101 Enhanced keyboard (contains the
                     keys Insert, Home, PageUp, Delete, End, PageDown).)
   
   ~six_key_group_title(Auxiliary and Item Keys)
   ~Key6_1(Object)
   ~Key6_2(Region)
   ~Key6_3(Window)
   ~Key6_4(Promote)
   ~Key6_5(Complete)
   ~Key6_6(Format)

   ~Turn_OFF_Three_Key_Group
   ~comment(Three-Key Group:
   
            * * *    This group may be useful for laptops)
   
   ~three_key_group_title(Three-Key Group)
   ~Key3_1()
   ~Key3_2()
   ~Key3_3()

   ~Turn_OFF_Single_Key_Group
   ~comment(Eighteen Single Keys: Useful wherever you need them)
     
   ~Key_1(one)
   ~Key_2(two)
   ~Key_3(three)

   ~Key_4(four)
   ~Key_5(five)
   ~Key_6(six)

   ~Key_7(seven)
   ~Key_8(eight)
   ~Key_9(nine)

   ~Key_10(ten)
   ~Key_11(eleven)
   ~Key_12(twelve)
   
   ~Key_13(thirteen)
   ~Key_14(fourteen)
   ~Key_15(fifteen)
   
   ~Key_16(sixteen)
   ~Key_17(seventeen)
   ~Key_18(eighteen)


~comment(=============== Generate the Keymap ===========================)
 
   ~comment(The file Keymap_Template_Tables contains the table macros
   that generate the keymap.  If you want to change Compose Environment
   settings such as font family, point size, and spacing, they are found
   in this file. You may want to copy Keymap_Template_Tables to a file
   with another name, and include that file in your
   Keymap_<Pcbasic>_User_Defs file, since other keymaps, such as
   Keymap_Pcbasic_User_Defs, may include Keymap_Template_Tables.)

   ~include(Keymap_Template_Tables)
DataMuseum.dk

Rational R1000/400 Tapes

⟦d79a457d5⟧ TextFile

Derivation

TextFile
