--------------------------------------------------------------------
---------- welcome to the seka v3.2 instructions (final) ----------
--------------------------------------------------------------------
welcome to the seka v3.2 instructions, first the old instructions
(if you aren't familiar with my old seka v3.0).
old seka v3.0 instructions:
---------------------------
the seka v3.0 is based on the seka v1.5 not the seka v2.1 by mfc.
anyhow this version supports all seka v2.1 commands. the upgrade
programming was done by promax of kefrens. this is not a course
in how to use the seka, only a upgrade instructions to the new
commands.
summary of seka v2.1 improvements supported by seka v3.0:
1. workspace:
----------
pressing return by accidence when you are asked 'workspace>'
allocates normaly ( 0 kbytes user memory ). pressing return
by accidence will now just repeat the question.
2. write object:
-------------
when writing an object code you are asked to enter a mode.
type the letter c and your object code will allways be loaded
into the chip-ram when loaded from the cli. this insures that
bitmaps and copper list will work on a machine with memory
expansion.
3. execute:
--------
typeing '@' enables you to executes a command on the disk,
like in the cli. please note that the cli command run must
be present in the c-directory. you use it like this:
seka>@
execute>type df0:sekav3.0txt
the output from this command is of course directed to the seka
window !! not like in the seka v2.1 in the amigados window.
4. >extern and y:
--------------
typeing the command 'y' execute all >extern commands in your
source code. the extern command is used in stead of the 'ri'
command. type in your source code:
9
10 >extern "filename",start [ , length ]
11
start = where to load the file
length = the desired load length. if you want to
the intire file in its default length,
skip the length indication.
the start and length pointer may be both labels and direct
pointers or a mixture of both. if you use labels you must
offcourse remember to assemble before typing 'y'.
5. look in source:
---------------
the 'l' command doesn't differ between lowercase and uppercase.
6.hyper fast scrolling:
---------------------
press ctrl+a and you scroll up 100 lines. press ctrl+z and you
scroll down 100 lines.
summary of seka v3.0 improvements not included in the seka v2.1:
1. copy (debugged):
----------------
the line command 'c'-copy is fixed, there were a bug in
the two way copy selection, that made the seka destroy the
copied data.
in earlyer seka versions pressing return accidentialy caused
a system crash! this error is corrected.
2. fill (debugged):
----------------
like the copy command pressing return caused a systemcrash.
3. copy link file:
---------------
the copy link file commando 'cl' had the same error as fill.
4. breaking seka commands:
-----------------------
pressing ctrl+c breaks any seka action. in earlier seka
versions, it was not possible to break the directory function.
5. chip, fast or abs memory:
-------------------------
this function enabels you to specify your program memory type.
if you are making programs with copperlists ect. that requers
chip-ram, type a 'c'. if you want your code in the fast-ram
if you got any type 'f'. typing 'f' or just pressing return
allocates memory as usual. (default for seka v1.5).
these options were also avarialbe on the seka v2.1. the new
achevement is the abs-mem option. typing an 'a' enables you
to type in the address where to allocate the user memory --
where to put your programs.
6. friendly directory:
-------------------
using the 'v' command waited a long time before it printed the
directory. this is corrected, and the names is printed out as
soon as they are loaded, one by one.
7. assemble-optimize:
------------------
the line command 'a'-assemble with the option 'o'-optimize
specified had two bugs. before bra when optimized became br.sa
instead of bra.s and a bra.l were not made into a bra.s to
check if this shorter range were possible. these errors are
now fixed.
8. repeat last line.
-----------------
pressing crsr-up repeats last line like usual, but tabs are now
repeated like a normal char.
9. write block.
------------
pressing ctrl+w in the editor (write block) didn't work. now
this function is fixed. mark your block as usual, in stead of
pressing ctrl+c (cut block) press ctrl+w. you will not be
faced with the prompt filename>. type a name and your block
is saved at the disk.
10.hunt in memory:
---------------
the old line command 'h' is moved and is now called '=', this
has made space for a new command called 'h'-hunt. this is
a hunt in memory command. try to type:
seka>h
begin>$40000 (address or label)
end>$50000 ( ---- )
data>"hello",$a (string in ascii or bytes seperated
with: <space> or , or + )
if you by accidence have searched for data that occures a lot
of times in memory. the hunt command can be breaked by pressing
ctrl+c.
11.print command:
--------------
typeing '?' in the seka v2.1 printed the hex, dec and bin value.
now this version also prints the ascii characters.
12.pal & ntsc:
-----------
this version of the seka features automatic pal and ntsc selection.
if you start up in pal the window is automatically opened at full
256 lines.
13.edit window:
------------
pressing esc activates the edit window. now a bigger edit window
is given to you. in pal = 22 lines ( ntsc = 19 lines ). now
this could cause a problem because a 'q' in memory displays 8
lines and this bigger window deletes some of these lines. to
solve this problem i have given the key just below the esc key
marked ` a new function. pressing this key opens a smaller edit
window pal = 13 lines ( ntsc = 10 lines ). in the editor this
key is back normal, so you can still use the character ` in your
programs.
14.edit scrolling:
---------------
pressing the shift together with one of the cursor keys, scroll
the edit display one full screen up or down. this function can
also be achieved by pressing ctrl+e (up) or ctrl+x (down)
15.one hand editing:
-----------------
in the editor it is now possible to do mark-block, cut block and
paste-block with the same hand. ctrl+b = mark block. ctrl+c =
cut block. ctrl+f or ctrl+p = fill/paste block.
16.rotating block:
---------------
you have typed something, that is in exatly the wrong order.
(the first line should be the last ect.ect.). mark the desired
block and press ctrl+r to rotate this block.
17.lowercase block:
----------------
mark a block and press ctrl+l. all text is turned into lowercase.
18.uppercase block:
----------------
mark block and press ctrl+u. uppercase again.
19.copy block:
-----------
mark block and press ctrl+x, the block is now copyed and you can
paste it every where.
20.delete eol:
-----------
press ctrl+d and the line is deleted from the cursor to the end of
line.
21.go to top of text:
------------------
press ctrl+t and you are at the top line of your source.
22.look in editor:
---------------
looking with the 'l' command finds text in you source. now this
function can be executed while editing. press ctrl+j in the
editor if you want to look for the same text once more.
**********************************************************************
new features in seka v3.2:
--------------------------
1. new super fast editor scrolling and updating.
2. shift+up/down arrows and ctrl+a/z is optimized, jump more than
1000 lines/sec!!
3. a bug in ctrl+j (repeat searching) is fixed. and this routine is
also optimized. the speed is now more than 2000 lines/sec.
4. in seka v3.0 help jumped 100 lines down + '~'. help in editor mode
is now displaying a ctrl+key help text in the menu-bar.
5. ctrl+t jumps to top and toggles to bottom if the cursor is positioned
on the first line in the editor (doing this does of course not
result in loosing a cutted block)
6. mark block functions are now included on the f-keys.
pressing shift f1-f10 makes a mark
without shift f1-f10 jumps to mark
7. ctrl+g jumps to an other type of mark:
eg. type ;; in your source, at the start of one or more
subroutines.
now press ctrl+g. the editor will now jump to the
next place in your source which reads ;;
8. ctrl+r rotate has changed its place to ctrl+y, leaving space for
a search+replace routine. pressing ctrl+r activates a new feature:
input in the menu-bar. you are met with the text:
search for :
replace with :
just try it..
9. ctrl+q continues search+replace.
10.ctrl+s searches for text, like the 'l'-look line command. text is
entered in the menu bar like the search+replace feature. to
continue searching for the same text press ctrl+j as usual.
11.ctrl+x unmarks block.
12.ctrl+k tells which registers you use in a marked block. you must
beware that this routine doesn't check your subroutines and rom
calls. it only perform a normal text search. but it ignores text-
strings and labelnames.
13.v-dir now displayes the disk path name, and more charspace are
available for each filename.
14.=m meets you with the question:
add workspace memory in kbytes>
type the amount and press return. more workspace is now added.
15.=l nn, indicates number of lines in editor window.
eg. =l 28 (28 lines)
16.typing '!'-quit confronts you with three options:
exit or restart (y/n/r)?
typing 'r' results in restarting the seka, instead of re-loading
it again.
17.the ?-print command now print 32 bits seperated in 8 bit blocks.
18.alt+space jumps to the beginning of the next word.
19.lines more than 74 chars long doesn't jam the display, instead the
char 'ยป' is displayed at the end.
20.rs, ws - read/write track. rt, wt-read/write track reads a track.
one track is 11 sectors. you are confronted with the text:
ram ptr>
disk ptr>
length>
21.cc - calculate checksum. please notice that all direct disk access
is directed to df0:
22.ro - read objekt is included.
23.at the command line crsr+up/down does not only repeat the last
entered text, but the last 16.
24.seka can now be executed from the workbench
25.file length is now not only displayed in dec, but also in hex.
26.h-hunt can now search for both bytes, words and longwords.
eg. begin>$fc0000
end>$ffffff
data>1234.l 'hello' 34.w label.l
if you dont type anything byte size is default.
27.cut, fill, hunt breaks if nothing is typed, then you are asked to do
so. this prevent crashes.
28.writing to a disk with not enough diskspace, doesn't cause an
unvalidated disk. but leaves a deleteable file.
29.shift+crsrleft/crsrright beginning/end of line.
30.output from the execute cli command is again directed to the
amigados window.
31.z-zap now always has to be confirmed. if you by accidence types
z instead of a no lines are deleted. and if you are zapping more
than 20 lines no printing is done.
32.a configuration function is included. in your startup-sequence
you type:
eg. sekav3.2 \f\300\r\df0:source\^
this will automatically allocate 300 kb fastmem, read the file
source from df0: and enter the editor "^" = esc.
short summary of control commands:
ctrl+a ; 100 lines up
ctrl+b ; mark block
ctrl+c ; cut block
ctrl+d ; delete to end of lines
ctrl+f ; paste block (fill)
ctrl+g ; go to special mark ;;
ctrl+j ; cont. search for text (jump)
ctrl+k ; show registers.
ctrl+l ; lower case
ctrl+o ; insert line
ctrl+p ; paste
ctrl+q ; cont. replace
ctrl+r ; replace
ctrl+s ; search
ctrl+t ; top/bottom
ctrl+u ; upper case
ctrl+w ; write block to disk
ctrl+x ; unmark block
ctrl+y ; rotate block
ctrl+z ; 100 lines down
ctrl+[ ; esc
authers note:
-------------
this is a new upgraded version of the seka assembler. the key
word in this seka is speed. the lousy editor, has been removed.
use the cli-command add44k or add21k (onebpl) if you want more
programming space (not speed this time). if you don't want the
cli to be disabled while using the seka just type "run seka" in
your startup-sequence. some helpful keypressions are:
leftamiga + m = seka screen in front
-- + n = amigados in front
-- + b = requester cancel
if you have any comments or bugreports on this new seka v3.2
please write to:
kefrens, poste restante, 3450 alleroed, denmark
|
