Oakland CPM Archive/oakcpm.iso/cpm/disasm/revas25.lbr/READ.MZ/READ.ME

Text File | 1987-03-15 | 4KB | 87 lines

                    FILES IN THIS LIBRARY COMPRISE
             THE REVAS Z80/8080 DISASSEMBLER, VERSION 2.5

THIS SOFTWARE, COPYRIGHTED IN 1978 BY A.E. HAWLEY, IN LOS ANGELES
CALIFORNIA, IS HEREBY RELEASED FOR PRIVATE INDIVIDUAL USE ONLY. IT
MAY NOT BE SOLD OR DISTRIBUTED FOR PROFIT WITHOUT PRIOR EXPRESS
WRITTEN PERMISSION OF THE COPYRIGHT HOLDER. PUBLIC NON-PROFIT
DISTRIBUTION OVER COMPUTER NETWORKS IS SPECIFICALLY PERMITTED.
THIS RELEASE NOTICE APPLIES ONLY TO VERSION 2.5; OTHER VERSIONS
WHICH ARE COMMERCIALLY AVAILABLE ARE NOT RELEASED TO THE PUBLIC
DOMAIN, AND ARE NOT COVERED BY THIS NOTICE.

            AL HAWLEY
            LADERA HEIGHTS RBBS/RCPM
            [phone]

NOTE: ALTHOUGH THE SOURCE CODE IS NOT PRESENT IN THIS LIBRARY,
IT CAN BE MADE AVAILABLE FOR DOWNLOADING BY SPECIFIC REQUEST
AND ARRANGEMENT.  AEH

    MAN1.TXT, MAN2.TXT, AND MAN3.TXT COMPRISE THE ORIGINAL
USERS MANUAL FOR VERSIONS 1 (FOR A MONITOR) AND 2 OF THE REVAS
Z80/8080 DISASSEMBLER. WHEN THE CP/M VERSION (V2.5 IS THE
LATEST VERSION OF THIS DISASSEMBLER) WAS GENERATED, THE USERS
MANUAL WAS AUGMENTED WITH ANOTHER SECTION. CPMAN.TXT IS THAT
SECTION; IT IS NOT INDEPENDANT, AND YOU MUST READ *ALL* OF THE
DOCUMENTATION IN ORDER TO MAKE EFFECTIVE USE OF THE DISASSEMBLER.
IN ADDITION, AS NOTED BELOW, SOME ADDITIONAL COMMANDS AND
MODIFICATIONS WERE MADE AFTER CPMAN WAS WRITTEN, AND THIS FILE
ALSO CONTAINS IMPORTANT INFORMATION ABOUT REVAS V2.5

        Z80.LIB AND Z80LIB.DOC CONTAIN TABLES THAT WILL HELP
YOU CROSS REFERENCE THE MNEMONICS USED BY REVAS WITH THOSE
PUBLISHED BY ZILOG AND WITH THE SET EMPLOYED BY THE MACROS IN
Z80.LIB.

        REVAS.MON IS A COPY OF REVAS WHICH IS CONFIGURED
TO WORK WITH A MONITOR, AS DESCRIBED IN YOUR USER'S MANUAL.
IT WILL NOT EXECUTE UNDER CP/M. THE LENGTH OF REVAS.MON IS
1400H BYTES BEFORE EXECUTION. AFTER EXECUTION, THE AUTOMATIC
LOADER HAS BEEN OVERLAYED, AND THE REVAS PROGRAM NOW
OCCUPIES ONLY 1000H BYTES STARTING AT THE LOAD ADDRESS.
        REVAS.MON IS REFERRED TO IN THE USER'S MANUAL ON
PAGE 18 AS SIMPLY "REVAS". IT IS INCLUDED ON THIS DISK ONLY
IN THE EVENT THAT YOU WISH TO USE REVAS IN A NON-CP/M
ENVIRONMENT.

                **** REVAS V2.5 NOTES ****

        THE FOLLOWING UPDATE NOTES APPLY ONLY TO THE CP/M
VERSION OF REVAS. YOU MAY WISH TO ADD THESE CHANGES TO THE
APPROPRIATE PLACES IN YOUR MANUAL.


THE FOLLOWING FEATURES/COMMANDS HAVE BEEN ADDED TO REVAS TO
MAKE IT EVEN MORE USEFUL. THEY ARE NOT DESCRIBED IN YOUR
MANUAL, WHICH WAS PRINTED PRIOR TO RELEASE OF V2.5

CONTINUATION OF D, DT, B, AND BT
        IF ONE OF THESE COMMANDS IS IMMEDIATELY FOLLOWED BY
A CARRIAGE RETURN, THEN DISPLAY (OR BUILD TABLES) WILL
CONTINUE STARTING WITH THE LAST INSTRUCTION OR BYTE DISPLAYED
AND CONTINUING TO THE LAST ENDING ADDRESS ENTERED BY ANY
COMMAND THAT TAKES AN ADDRESS RANGE AS ARGUMENT. IF NO SUCH
COMMAND HAS YET BEEN EXECUTED, THE DEFAULT RANGE STARTS WITH
ADDRESS 0100H AND ENDS WITH THE FIRST BYTE OF REVAS ITSELF.

'N' COMMAND
        THE 'N' COMMAND, ACTIVE IN COMMAND MODE ONLY, SETS
THE PAGING ROUTINES TO 'TOP OF PAGE' CONDITION WITHOUT
ISSUING A FORM FEED. THIS COMMAND IS USEFUL FOR ADJUSTING
YOUR PRINTER TO TOP OF FORM AND THEN TELLING REVAS ABOUT IT
SO THAT PAGING PROCEDES FROM THAT POSITION.


SYMBOL TABLE OVERFLOW
        SOME USERS HAVE USED REVAS ON PROGRAMS THAT ARE SO
LARGE THAT THE SYMBOL TABLE LIMITS HAVE BEEN EXCEEDED. THIS
VERSION (2.5) OF REVAS CONTAINS A WARNING AND REFUSES TO
ENTER SYMBOLS IN EXCESS OF ITS TABLE CAPACITY. THE ONLY WAY
TO ENTER MORE SYMBOLS IS TO 'KILL' SOME EXISTING LABELS TO
MAKE ROOM FOR THE NEW ONES. A SIMILAR MESSAGE WILL BE GIVEN
IF TABLES ARE ABOUT TO ENCROACH ON THE OPERATING SYSTEM
MEMORY SPACE.

                                        AL HAWLEY