Premier Release V3.10 20th May 1990
===================================

History since version 3.00
==========================


Version 3.03
============

This release fully conforms to the details given in the first edition of the
Premier User's Guide, and the Premier Reference Manual, with the following
additions.

New Command: DUMP

     Provides a listing of all user defined objects with their current values
     where appropriate. The listing is made to the Journal buffer.

New Operator: &

     This operator is used to convert an integer to a string, as the $ and %
     operators, but results the the value being given in hexadecimal.
     e.g. show &premdoc, results in the display 'D26'.

Manual Errata.

     Please note that the FILER, FINDER, DATAWINDOW, COMMAND and WAIT
     commands cannot be given from the command window, but must be given 
     from a menu, key definition, or command file.


Version 3.04
============

     Error in WordProc command file concerning 'seek' command corrected, plus
     minor bug fixes.


Version 3.05
============

     Premier will now execute system 'star' commands, by accepting a '*'
     as a command word, either entered in the command window, or within 
     a command file or macro, etc. The syntax is :-

     * <string expression>

     so that quotes are needed around explicit strings. Any string expression
     may be used. e.g.

     * "dir " + MyDir

     This will select a new default directory. You should avoid commands
     which may prevent Premier from continuing, such as dismounting it's 
     disc!

     Error concerning interaction of AND and OR attributes of 'filter'
     command corrected.

     The command window now permits the recall of previous successful
     commands by using the up and down cursor keys. These will recall the 
     last command executed, followed by up to 20 previous commands, in the 
     appropriate direction through the list. Any recalled command may be 
     used 'as is' by typing return, or edited first as required.


Version 3.06   5th May 1990
============

*    IMPORTANT  From this version onward, commands which allow more than one
     =========  parameter, must include commas between all parameters.

     e.g. The filter command syntax should now be -

                filter field, logic, operator, data  

     This modification should be carried out immediately, and ALL existing
     object files (in !Premier.object ) should be deleted to force re-
     compilation. This has been necessary to overcome some syntactical
     problems when using complex expressions for parameters.

*    Bug Fixes. Screen format bug within justified paragraph fixed. 
     (Caused a fatal crash). Also a possible 'menu' crash has been removed.
     A formatting error where tabs were included has been corrected.

*    Cursor movement around dynamic items has been improved, so that it may be
     positioned correctly between adjacent dynamic items, etc.

*    The keystroke record and playback system will now record the mouse 
     co-ordinates correctly, when a mouse button is recorded. However, there
     are still some limitations to this. The playback system will correctly
     position the pointer, but the selection of a new window will not work.
     For this reason, key stroke records including mouse button clicks, 
     should be restricted to actions within one window. Also note that screen 
     objects may have moved since the recording was done.

*    Memory usage has also been improved, while run time usage is also more
     optimum.

     New Commands.   Four new commands have been introduced with this version.
     ============    ====

     CENTRE, RIGHT, TAB n  These can only be used within dynamic items, and
     allow dynamic text formatting.

*    CENTRE causes all following text, up to a newline, to be centred within
            the current margins. It the line is too long the command is ignored

*    RIGHT  causes all following text, up to a newline, to be right justified               up to the right margin. It the line is too long the command is                  ignored.

*    TAB n  causes the following text to be positioned at the column given by
            the 'n'. Text will then wrap as usual.

*    FLAG <menu name> <item number> <tick> <fade>

            This command can be used to fade (non-selectable) and/or tick a
            menu item, after the menu has been created.

     Command Enhancements.  The following commands have been improved.
     ====================

*    The INSERT command has been enhanced to accept an optional marker name
     following the string to be inserted,  e.g.  insert "Fred", NewMark

*    The UPDATE command has been enhanced to accept two markers, defining the
     area to be updated,  e.g. update mark1, mark2   Without the markers the
     whole of the current window is refreshed as before.

*    The FILTER command allows filters to be removed, although this was not
     documented. The correct syntax is:-

     filter <field> [ ,<logic>, <operator>, <data> ]

     If the last three items are optional, and if omitted, all filters on the
     given field will be removed. If the given field is zero, ALL filters will
     be removed from ALL fields.

*    Two new key numbers have been added, to provide access to mouse 'dragging'
     facilities.

         259  = mouse button 'select-drag'
         260  = mouse button 'adjust-drag'

     If a button is held down for more than 100-200 mS, Premier will behave as
     though a key of the above number has been pressed, and carry out whatever
     commands have been assigned to it.

     The select-drag key has been assigned a macro ( in WordProc ) permitting 
     text areas to be marked by dragging the mouse pointer over the required 
     area. Normal 'clicks' should therefore be brief to avoid invoking the 
     'drag' action.

*    The macros RJ, CJ, FJ1 & FJ0 have been defined in the WordProc commands 
     file for use as dynamic items to invoke the right, centre, and full
     justify facilities. This command file has been greatly extended, and the
     menus redefined, permitting, for example, marked areas to have font style
     or colour changes. The new options should be self explanitary.

*    The markers used within Premier for text area marking, using the 'mark'
     command, may now be accessed via the marker names "MarkedStart", and 
     "MarkedEnd". If no marked are exists, these names will default to the 
     currently selected marker, if any (but see below).

*    The new system integer 'marked' has been defined, which indicates whether
     a marked area exists or not, being either 'true' (non-zero) or 'false' 
     (zero). This variable should always be tested before refering to the
     above marker names.

*    The 'prompt' dialogue box has been re-designed to be smaller, for better
     presentation when used from menu selections. Also, if the pointer is moved
     back over the menu from the prompt box, the menu macro being executed will
     be aborted. Commands in the macro preceeding the prompt command WILL have
     already been executed.


Version 3.10  20th May 1990
============

     New Commands.
     ============

*    A new command BEEP has been introduced, causes the computer to 'beep'.
     
*    Integer functions may now be defined, in addition to string functions,
     and the syntax is similar:-

     int function <name> [ <command list> ] = <integer expression>

     where the command list is optional, as for string functions.
     Integer functions may be used wherever a simple integer is acceptable.

     Find Dialogue Window Enhancements.
     =================================

*    The use of the RETURN key within the find and replace string input boxes
     now initiates the appropriate action. i.e. in the find box it causes a
     find action, in the replace box it causes the found string to be replaced.
     A null string is NOT now used in a replace action. This used to cause the
     found string to be deleted.

*    The quit button, now not required, (use the normal window close icon),
     has been re-named 'Mark'. If selected, will cause the found string to
     be marked on the screen, as if the 'mark' command had been issued at
     either end of it. This marking is cancelled when another find is performed
     or a replace done.

*    The find window will now remember the last find and replace strings.

     System Variable Improvements.
     ============================

     The system variables 'line' and 'column' when used within dynamic items,
     now give the position where the item is embedded, not the current marker
     position. Other uses remain unchanged.


There are now no known bugs or 'funnies', and no further enhancements are 
currently planned. Version 3.10 should therefore have a longer life than most!

New manuals are being prepared for this version.
