

                     --------------------------------------
                           !Help file for Func'n'Proc

                                1.83 (13-Jul-03)

                             Andrew Ayre 1995-97
                        Ray Favre, changes from May 1999 
                     --------------------------------------

INTRODUCTION...

  Func'n'Proc gives details of all the functions and procedures related to
the DrWimp system, and as such should NOT be distributed seperately.

  All the functions and procedures are grouped into sections, currently:

  Misc
  Polling
  User
  Windows
  Messages
  Icons
  Menus
  Sprites
  Pointer
  Drawfiles
  Text
  Printing
  Dynamic Areas
  Colour Picker

  Func'n'Proc supports interactive help applications.

USING...

  Double-click on the icon to load. (The iconbar icon shows the Dr
Wimp version number on which the information to be shown is based.)

  Click on the iconbar icon to bring up the main window.

  At the top is the name of a wimp-function (or user-function)
together with its parameters, if any. (When you first start !Fnc'n'Prc it is
the first function in the first section which is displayed.)

  In the rest of the window the function's action and the parameters passed are
described in more detail.

  Click on the up arrow in the toolbox to go to the next function in
the list in that section. Click on the down arrow to move back a
function. The other two icons in the toolbox move you to the last
(top) and the first (bottom) of the section.

EXPORTING TEXT...

  At the bottom of the main window the function entry at the top of the
window is repeated in a writable icon (white background). There are
also two action icons named 'Export to caret' and 'Reset writable'.

  If you wish, you can edit the contents of the writable icon in the
usual way.

  If you click over 'Export to caret' the current contents of the
writable icon will be copied across to wherever the caret happens to
be. So this allows you to enter wimp-functions directly into, say,
your developing Dr Wimp !RunImage listing in your Basic editor -
reducing the chances of typing errors etc.

  If you click over 'Reset writable' the text in the writable icon
will be restored to that shown at the top of the window.

  Some Basic/Text editors (e.g !Edit) cannot accept the exported
characters at very high speed without losing some characters. To cater
for this, there are two radio icons at the bottom right of the window
- labelled 'Faster export' and 'Slower export'. Experiment to see
which one works properly in your editor. (A good way to test is to
export something fairly long to your editor twice - on separate lines
- first using 'Faster export' and secondly using 'Slower export'. Then
line up the start of each exported text to easily see if they match
exactly.)

The last setting you choose will be maintained until you change it again - even over a quit/shutdown.

CHANGING SECTION...

  Press Menu over the window and choose the new section from the Sections
submenu.

JUMPING TO A FUNCTION...

  Press Menu over the window and choose the function name from the
Fnc'n'Prcs submenu.

SAVING...

  The complete text displayed in the window can be saved as a text
file. Press Menu over the main window and move to the Save submenu.
Drag the icon to a filer window or another application.

  From Version 1.50 of !Fnc'n'Prc (released with Version 3.53 of Dr
Wimp) you can also save (from the iconbar menu) a new
alphabetically-sorted version of the 'Info' file (the file containing
all the text information about the functions). The Info file, as
supplied, is already sorted so you probably will not need to use this
facility - but it assists the author for future upgrades. (Sorting the
Info file makes the initial loading quicker.)

SEARCHING...

  Choose "Search..." from the main menu and enter the string to search
for into the writable icon.

  There are two options: "Functions" and "Everything".
  
  Turning "Functions" on will restrict the search to just the function
names (and any arguments/parameters).

  Turning "Everything" on will search through the function names,
arguments and descriptions.

  Click on "OK" to start the search and if any matches are found, a
window will open listing all the matching functions. Click on a
function to jump to it in the main window.


CREDITS...

  See Addr+Cred file in the Documents folder.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

For distribution conditions see the !!ReadMe!! file.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

EOF183

