SET(SHIFT_KEY)

  Specifies the shift key for use in other key definitions.  There is no
  relation to the SHIFT key on the main keyboard.

  Syntax

     SET (SHIFT_KEY, keyname [,string])

  Parameters

     keyname    Specifies the key you want to use as the shift key.  See
                help on KEYNAMES TABLE.

     string     The key-map list for which the shift key is to be used.  If
                you do not specify a key-map list, the key-map list for the
                current buffer is used.

  Comments

  Using a shift key lets you assign two bindings to a key.  One binding is
  executed when you press the shift key and the other key; the other binding
  is executed when you press the other key alone.  For example, if you use
  the following statements:

     SET (SHIFT_KEY, F17);
     DEFINE_KEY ("COPY_TEXT ('Sincerely,')", KEY_NAME ("s",SHIFT_KEY));

  Pressing F17 and the letter S inserts the word "Sincerely"; otherwise,
  pressing S alone inserts that character.

  Only one shift key can be active at a time.  By default, PF1 is the DECTPU
  shift key.  If you want to use PF1 for another purpose, use SET
  (SHIFT_KEY) to specify a key other than PF1.  You can use any key as the
  shift key, as long as DECTPU allows you to define the key at all.  (See
  help on NONDEFINABLE KEYS.)

  Examples

  1.  SET (SHIFT_KEY, F17, "tpu$key_map_list");

      Specifies F17 as the shift key for the specified key-map list.

  2.  If you do not want a shift key for your application, use the following
      statement:

      SET (SHIFT_KEY, KEY_NAME (PF1, SHIFT_KEY);

  Related topics

     DEFINE_KEY   KEY_NAME   SHIFT_KEY   UNDEFINE_KEY