 ____          ____  ___
|_  /__ _ _ __|  _ \/ __|
 / // _` | '_ \ |_) \__ \ 0.34, 28 September 1999
/___\__,_| .__/____/|___/  Darren Salt,   1996-9
         |_|

This software is COPYRIGHT, but has been released as FREEWARE. Please see the
end of this file for conditions of use and distribution.


Installation


Drop !ZapDS into !Zap.Modules and (quit and re)load Zap...


Commands


Commands without any specified syntax take no parameters.

Any commands which take a string parameter will open the minibuffer if no
parameter is supplied.

A "Zap expression" is a string which is evaluated by OS_EvaluateExpression
but which may contain Zap functions.


DS_AdrL


Assembles a long (two instruction) ADR.

Syntax: DS_AdrL "[<condition code>] <register>,<address>"

Example:
	at address &1000, the command
		DS_AdrL "LT R1,&5344"
	is equivalent to
		Assemble "ADRLT R1,&1344"
		Assemble "ADDLT R1,R1,#&4000"
(It will of course use SUB if required.)


DS_AdrX


Assembles a very long (three instruction) ADR, much as DS_AdrL does - it even
has the same syntax.


DS_Add, DS_Sub, DS_Rsb, DS_And, DS_Or, DS_Eor
          

These commands perform an arithmetic or logic operation on the current byte
(or word, if in word or code mode). Each takes a Zap expression as a
parameter; it must evaluate to a number. (Even if the byte/word is unchanged,
the cursor is moved on.)

For example, to add &180 to a word (in word mode), you'd use
	DS_Add "&180"


DS_SWItoName


This takes an SWI number, found at the cursor position, and replaces it with
the corresponding name. In BASIC and BASTXT modes, quotation marks are
automatically inserted.


DS_SWItoNumber


This takes an SWI name, found at the cursor position, and replaces it with
the corresponding number. In BASIC and BASTXT modes, surrounding quotation
marks are automatically removed.

Commands removed since v0.20


Command name			Equivalent		Location
					
DS_Eval, DS_EvalH, DS_UEval	Eval, EvalH, UEval	ZapUtil
DS_FindFile			FindFileCursor		ZapText
DS_Insert			InsertBlank		ZapText
DS_OpenParent			OpenParent		Zap
DS_SaveKeepStamp		SaveKeepStamp		ZapText
DS_StripCtrlCodes,
  DS_StripCtrlWithMask		StripCtrlCodes		ZapText
DS_SwapCaseCursor		SwapCaseCursor		ZapText
DS_Untabify			Untabify		ZapText
Format_Indented			FormatIndented		ZapText
If, And_If, Or_If, Eor_If	If			Zap
If_TRUE, If_FALSE		...Else...EndIf		Zap
Repeat				Repeat			Zap
CloseAll, DiscardAll,		(names unchanged)	ZapUtil
  SaveAll, SaveAndCloseAll,
  SaveAndDiscardAll
DS_ToIcon			ToIcon			ZapBits
SendURL, SendURLString		(named unchanged)	ZapBits
SendURLGivenOffset (removed)

Copyright


The conditions of copying this program and its associated documentation are
the same as those of the main Zap application, except that you do not need my
permission to copy it if you have Dominic Symes's.

Versions marked "[TEST]" or "" are not to be distributed except with
similarly-marked versions of Zap.

This software is provided as is with no warranty as to its suitability or
otherwise for any particular task. If it does anything nasty then I want to
know so I can fix it, but I'm not taking any responsibility. (Besides,
there's no point in sueing me since I've got next to no money.)

Please note that I reserve the right to make alterations to this module, its
operation, documentation, and/or conditions of use without notice in any way
I see fit. Hopefully it will be an improvement.


Contact


Darren Salt - Zap: ds@zap.tartarus.org
             Misc: ds@youmustbejoking.demon.co.uk
         Fallback: arcsalt@spuddy.mew.co.uk
