(axe.info)Actions


Next: SampBinds Prev: SampRsrcs Up: Customise
Enter node , (file) or (file)node

Actions specific to aXe
=======================

The main editing subwindow of a top-level aXe window is derived from an
Athena Text Widget. Hence all of the default bindings of keys to Text
Widget action routines apply. The Text Widget is fully described in
'Athena Widget Set - C Language InterFace' of the 'MIT X Window System
Manual Set', but for your convenience an extract from the section
describing the default key bindings can be viewed on-line (Note: The
default key bindings.).  aXe extends the functionality of the
Text Widget by providing additional action routines, but it does not
set up any default key bindings for them, i.e. the new features are
only available through the menu and button interfaces, or the
minibuffer. If you wish to set up your own bindings then you need to
know the names of the new action routines.

They are

             goto-line
             search-caret
             forward-search-selection
             backward-search-selection
     
             include-file
             include-selection
             paste
     
             delete-word
             delete-line
             cut
     
             undo
             where
             centre-line
             set-preferences
     
             new-window
             close-window
             close-all
             iconify-all
             deiconify-all
     
             new-buffer
             clear-buffer
             close-buffer
     
             save-and-close
             save-all
             save-file
             save-as
             load-file
             reload-file
     
             size
             match-parens
             find-match
             re-search
             forward-line
             backward-line
             delete-selection-or-previous-character
             insert-or-expand-tab
             keymap
     
             set-mark
             highlight-region
             kill-region
             copy-region
             yank-region

It should be obvious which menu entries/buttons those in the first
eight groups correspond to.

include-file inserts a file using the file selector, as distinct from
insert-file, the Text Widget action bound to Meta-i that brings up the
Text Widget's own insertFile dialogue box.

new-window and new-buffer may be given the optional argument `load',
causing the file selector to be popped up for the new window or buffer
immediately it is created.

Without an argument save-and-close saves and closes all buffers. With
the argument `window' it saves and closes the current window; with the
argument `buffer' it saves and closes the current buffer.

The remaining actions are not available via the menus or buttons and
hence must be bound to keystrokes or typed into the minibuffer (Note:
How to use the minibuffer.).

size reports the size of the editing buffer in the information bar.

match-parens, if bound to `)', `}' or `]', causes the matching closing
bracket to be highlit for a period of time determined by the value of
the *blinkPeriod* resource (*Note AxeiiText widget resources:
AxeiiTextRsrcs.).

find-match causes a search to be made for the character matching the
`(', `)', `{', `}', `[' or `]' immediately to the right of the caret,
and if successful, highlighting the text between the two characters,
inclusive.

re-search is like the standard search action except that regular
expression searching is performed. It must be supplied with a direction
argument of 'forward' or 'backward'. search and re-search share the
same popup. The main observable difference when regular expression
searching is in effect is that its title is 'RE search' rather than
'search'. There are also minor differences in the messages

The forward/backward-line actions are similar to the Text Widgets's
next/previous-line actions except that they maintain position within
the line if at all possible, i.e. the cursor does not gravitate towards
the left margin as ever shorter lines are encountered.

The delete-selection-or-previous-character action does what its name
suggests.

insert-or-expand-tab is bound to the Tab key by default, and operates
in conjunction with the *expandTabs* resource (Note: AxeiiText widget
resources.).  If that resource is False then tabs are
inserted, otherwise an appropriate number of spaces to take the
insertion point up to the next tab stop is inserted.

The keymap action enables an alternative set of bindings to be switched
in. keymap takes a name as argument, which, together with the suffix
Keymap, defines the name of a translations resource. A name of None
restores the original translations, e.g.

     *ed.translations:#override \n <Key>F1:keymap(foo) \n ...
     
     *ed.fooKeymap.translations:<Key>F1:keymap(None) \n ...

The final set of actions allows selections to be manipulated via the
keyboard. set-mark sets an invisible marker. It is initially at the
beginning of the buffer. highlight-region highlights the region between
the marker and the caret. kill-region deletes the region between the
mark and the caret, and stores it in cut buffer 2.  copy-region copies
the region between the mark and the caret to cut buffer 2. yank-region
inserts the contents of cut buffer 2 at the current insertion point.


automatically generated by info2www version 1.2.2.9