idlwave: Structure Tag Completion
4.4.5 Structure Tag Completion
------------------------------
In many programs, especially those involving widgets, large structures
(e.g., the ‘state’ structure) are used to communicate among routines.
It is very convenient to be able to complete structure tags, in the same
way as for instance variables (tags) of the ‘self’ object (Object
Method Completion and Class Ambiguity). Add-in code for structure tag
completion is available in the form of a loadable completion module:
‘idlw-complete-structtag.el’. Tag completion in structures is highly
ambiguous (much more so than ‘self’ completion), so
‘idlw-complete-structtag’ makes an unusual and very specific assumption:
the exact same variable name is used to refer to the structure in all
parts of the program. This is entirely unenforced by the IDL language,
but is a typical convention. If you consistently refer to the same
structure with the same variable name (e.g., ‘state’), structure tags
which are read from its definition in the same file can be used for
completion.
Structure tag completion is not enabled by default. To enable it,
simply add the following to your ‘.emacs’:
(add-hook 'idlwave-load-hook
(lambda () (require 'idlw-complete-structtag)))
Once enabled, you’ll also be able to access online help on the
structure tags, using the usual methods (Online Help). In
addition, structure variables in the shell will be queried for tag
names, similar to the way object variables in the shell are queried for
method names. So, e.g.:
IDL> st.[Tab]
will complete with all structure fields of the structure ‘st’.