››››     ›     ›     ›                 Installation Manual and Technical Information›     ›     * Program and documentation (C)CopyRight 1994 Ken Siders›     * This program may be freely distributed, unaltered with›     documentation.›     ›     ›                                 REQUIREMENTS›          Atari Writer Plus Super Menu (AWPSM) is compatable with Atari›     Writer Plus (AW+) and Atari Writer+  130 XE Version (AW+XE).  Before›     attempting to use the program read all these instructions.›          System requirements are an Atari XL or XE model with minimum 128K›     if using AW+ or minimum 256K if using AW+XE.  If a ramdisk is being›     used, one memory bank must be left free for Super Menus use.  If the›     ramdisk program you are using is not configurable, you should not use›     the ramdisk.  You may need to have a thorough understanding of XE›     memory to safely use a ramdisk with this program.  Ramdisks that do›     not use the $D301 (54017) selection register should be ok however.  If›     you are using cartridge version of SpartaDos or any utilities that use›     XE memory, you are on your own.  Super Menu does not touch the ram›     "under" the OS ROMs and should be compatable with any dOS's or›     utilities that do.›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ›     ››››››››››                 AW+ Super Menu Installation Manual -  Page 2››››                                   Step One›          Before proceeding format a disk and write the DOS you will be›     using.  The DOS you are using must have a memlo no higher than 7936›     ($7F00).  When Using the XE version it must be no higher than 7680›     ($1E00)[Why?, I don't know].  If in doubt, boot the disk into BASIC›     and type PRINT PEEK(743)+256*PEEK(744).  If the result is larger than›     7936 (7680 for XE version), then you will need to reduce the number of›     file buffers (Most DOSs) or number of drives (This won't help with›     MyDos 4.5x).  With MyDos 4.5x you can have 3 buffers (2 with XE›     version).  See DOS manual for help.  After changing number of file›     buffers, go to dos, and write DOS to disk and reboot disk into BASIC›     and re-check as above.  Copy the AWPSMENU.COM program to the disk. ›     Copy all files from the AW+ or AW+XE disk except DOS.SYS and DUP.SYS›     to the new disk.  Rename AUTORUN.SYS to BOOTAWP.COM and rename AP.OBJ›     to AP.OLD.  If you were unable to lower MEMLO enough, you may need to›     change DOS's.›                                    Step 2›          Boot from the disk into BASIC if BASIC is not already running. ›     Run the PATCHSM.BAS program from BASIC.  Insert the newly created›     disk, press a key as prompted.  AWPSMENU.COM will be read from the›     disk.  PATCHSM will prompt you for the memory bank to use.  A list of›     typical banks will be displayed.  (If you are using the 48K version,›     and not using a ramdisk, you should not need to perform this step). ›     Do not use an 130 XE bank if you are using AW+XE.  If you are using a›     ramdisk program, you must be sure or set up the ramdisk not to use the›     bank you entered.  PATCHSM.BAS will rewrite AWPSMENU.COM to the disk. ›     If any errors occur, it may be necessary to recopy AWPSMENU.COM to the›     disk and repeat this entire step.›                                    Step 3›          Exit to BASIC from DOS.  Run the PATCHAWP.BAS program from BASIC.›     Insert new disk as prompted and hit a key.  The program will prompt›     you if you wan't to remove the copy protection.  This is done to make›     the program easier to run, not for pirating of the disk.  If you do›     not do it you will have to boot from the disk, switch to the AW+ disk›     and manually load it.  Also, the DOS you are using must be able to›     directly read Atari DOS 2.x compatable disks.  The option NOT to›     remove it is given so if you already have a patched disk for other›     reasons, the program won't go in and muck something up.  Next the›     program will ask you if you wish to add console key patch.  This patch›     enables you to embed OPTION, SELECT, and START key combos in Macros. ›     PATCHAWP.BAS will read in and patch the file.  PATCHAWP.BAS searches›     for the code it changes as opposed to changing bytes ay a fixed›     location so it should work even if you have made other patches or›     changes.  4 Patches are installed for AW+ and 5 for AW+ XE.›                                   Step Four›          In order to Load the file you need to boot from the disk into DOS›     (hold OPTION to disable BASIC).  Load any initialization program, such›     as for a ramdisk.  Load SUPRMENU.COM, it will load and control will›     return to DOS.  Finally, load BOOTAWP.COM.  To Automate this process›     read on.›          If you are using a command line driven DOS, it is easiest to›     create a batch file to perform this operation.  See your dos manual.›          To automate the process with a DOS that loads a file such as››››››››››                 AW+ Super Menu Installation Manual -  Page 3››››     AUTORUN.SYS, the files SUPRMENU.COM and BOOTAWP.COM can be appended›     together.  Go To DOS.  Delete AP.OLD.  Rename AWPSMENU.COM to›     AUTORUN.SYS,and Copy "WITH APPEND" BOOTAWP.COM to AUTORUN.SYS.  Delete›     BOOTAWP.COM.  If you have a program to set up a Ramdisk set up›     program, copy it to AUTORUN.SYS first, then append the other two files›     to it (in the previous order specified).  With DOS 2.5 you can simply›     name the ramdisk program RAMDISK.COM but you CANNOT use the normal dos›     2.5 ramdisk driver unless you have 256K or more and  use the 48K›     version of AW+, and specify a non-XE bank when setting up the program.›     With command line driven DOS's that do not load AUTORUN.SYS, use a›     different name, usually ending in ".COM".  You should be a able to›     load the file by just typing the same (without the ".COM").›     ›                             Important Information›          Before use, it is recommended you enter a little bit of text. ›     Verify you can go to and from the spelling checker, and mail merge. ›     NEVER use the exit to DOS function from the spelling checker or mail›     merge.  This causes a lockup in some cases and I do not know why.  Do›     not press RESET while in Super Menus (you may press RESET while in›     AW+).  Pressing RESET may cause loss or scrambling of text, and may›     disable Super Menu.  Only press HELP or SHIFT-CONTROL-ESC from the›     menu or edit screens, attempting to call it when the Atari logo is›     displayed or during i/o could cause problems and disable Super Menus. ›     If Super Menus becomes disabled, The OPTION, SELECT, and START keys›     will not work (if console key patch was installed) and you won't be›     able to enter Super Menu or use any Macros.  If this happens, save›     your text (preferbably to a new, temporary file in case it was›     damaged) and reboot the disk.  You should not have any of these›     problems if you follow these few rules.  Note: This is not›     unreasonable, you could loose your text within AW+, if you hit RESET›     when changing modules, for example.›     ›                             Technical Information›          Super Menus actually works outside the AW+ environment.  It›     supplies its own reset, keyboard interupt, and vertical blank interupt›     handlers.  SM actually consumes less than 256 bytes of normal RAM›     space once it initializes.  This is why the DOS must have a memlo no›     higher than $1F00 since AW+ modules load at $2000.  It automatically›     relocates this resident portion to LOMEM on your system, and raises›     LOWMEM to protect itself.  It also uses the first few bytes of the›     hardware stack at location 256 ($100).  It temporarily uses 16 zero›     page bytes at 128 (and locations 0 and 1), and 1k of memory at 32768›     ($8000) for the dlist and screen.  This keeps the screen out of the›     selectable memory area at 16384 to 32767 ($4000 to $6000) to keep it›     compatable with most memory upgrades.  When you enter the menu, SM›     saves the current values of the temporary locations, and uses them. ›     When it exits it restores them.  If you press RESET when a SM menu is›     displayed, these values will not be switched back properly and you may›     loose your text and will probably crash AW+.  You may be able to get›     Super Menus to work with other programs.  If the program has any›     interupt routines from $8000 to $83FF or use any of the zero page›     locations in an interupt routine, it probably will not work.  I have›     got it to even work with some magazine machine language games.  It››››››››››                 AW+ Super Menu Installation Manual -  Page 4››››     should also work with BASIC.  Note: The Load/Save commands will not›     work though since they are AW+ dependant.  I have not tested the›     program with AtariWriter 80 and would be interested to here from›     anyone who tries (successful or not).  The Super Menu would appear on›     the 40 column screen.›          A vbi updates shadow locations for the console keys so the macros›     can "press" them from within a macro.  The PATCHAWP program patches›     AW+ to read from the shadow instead of location 53279.  This is why›     you must enter a console-delay command since it can take up to 1/60th›     second to update this register.  ›          If you have any questions, comments, donations send to below.›          It is not register this program to use it since it may take›     sometime to get the hang of it, particularly macros.  I would›     appreciate any feedback, and if there is suffiecient interest, I may›     update it›     ›     Postal Address›     Ken Siders›     588 Catherine Ave.›     Marion, OH 43302-2253›     ›     EMail Address›     cp576@cleveland.Freenet.Edu›     ›     ›                                                                           ›