@"Doc.s for Locate128's 'NewF.SRC" source code files"
This program, and the associated source code files, are intended for use with GEOS128 V2.0 in 80 column mode only.
If you make any improvments, or use this code in another program, please upload those changes and source code files to the GEnie CBM GEOS libraries for all to enjoy.
The intention here is to help promote more GEOS programming from the private sector.
Seems we lost a good old source when Q-Link disappeared. This was a strong point for GEOS that seems to have dwindled away.
Everybodys got a "secret", few seem to want to share to enhance the system.
I hope this will help renew an old resource we seem to have lost.
On with the show.....
You will find the source code file NewF.SRC has been commented heavily where I felt it was needed for beginners, and very light where it would not help a beginner. If you have any questions about any un-commented code please feel free to send me E-Mail. I will be glad to help clear things up for you if I can. Alot of the code comes form PD sources found on the various online services. Some of those services no longer exist (like Q-Link) and some are going strong as ever (like GEnie).
If I goofed anyplace please feel free to correct me if you can. : )
I learn from my mistakes, I don't like repeating them, so a little critic won't hurt me in the least.
I don't learn from opinions, in fact I ignore them.
I intentionally left some routines lacking, some others over-expanded, some room for improvement, and very little support for various devices. So be creative and upgrade it !
My wish is to get those geo-programmers up and running again (we seem to be asleep) so we can make some real improvements to our GEOS systems, and keep our 128's alive for a long time to come. Half the fun of our machines is making them do the unthinkable. There is no feeling like creating a program yourself that works ! Even if it does vey little.
So gals and guys, get your GEOS machines running and give it your best shot !
ng and give it your best shot !
gals and guys, get your GEOS machines running and give it your best shot !
The source code files are in geoWrite128 V2.1 format.
If you wish, you can downgrade it to your machines capabilities with some of the PD converter programs available. ( Joe Buckleys Wrong is Write V7 is a real good PD choice to downgrade a geoWrite V2.1 to a geoWrite V2.0, ect.. )
The source code files are ready, as-is, for use with the geoProgrammer package.
Symbol and Macro files are included, as they contain address' and equates that do not come with the standard geoProgrammer package. You will have to use them to assemble & link a working copy.
Some of the routines included do not appear in GEOS 64 V2.0, so the program will not run as-is under that Kernal. You can substitute you own routines to adapt it to 64 GEOS V2.0.
Also, you will have to change the X-positions to reflect the 64's smaller 40 column screen positions. (for graphic and text printing)
Files (& things) needed for assembly & linking....
GEOS128 V2.0 (or higher)
GEOS V2.0 (for the 64)
P** NOTE **
source code, symbol and macro files will need to be
altered for use on a 64 with GEOS V2.0 for the 64
( geoProgrammer package )
geoAssembler (v2.0 preferred)
geoLinker (v2.0 preferred)
geosSym (v2.0 preferred)
geosMac (v2.0 preferred)
geos128Sym (v2.0 preferred)
NewFsym (from package)
NewFmac (from package)
geoWrite128
NewF.SRC main source code file in geoWrite128, v2.1, data format
NewF.hdr header file in geoWrite128, v2.1, data format
NewF.lnk link file ( in geoWrite128, v2.1, data format ) for use by geoLinker
I suggest using a 1581 disk drive, or FD2000 disk drive, or RamLink for the assembly, although it is not necessary
Place these files on your work disk, assemble the source code file, the header file, and then
use geoLinker, with the link file, to create a working, stand alone, Desk Accessory.
References you may want, but do not need, .......
The official GEOS programmers reference guide
The HitchHikers guide to GEOS
Abacus' GEOS Tricks and Tips
Abacus' GEOS Inside & Out
6502/6510 assembly language
Commodore 128 programmers reference guide
Commodore 64 programmers reference guide
Some of these reference books are available from Creative Micro Designs, the others you will need to hunt down and find yourself if you want them.
For your convience....
The program was created on the following system :
C128D, SmartMouse, 12mb RamLink (1996) Drive B with geoMakeBoot Kernal, with 16 1581 emulation partitions, 100mb HD (1994) 25 1581 emulation partitions for GEOS use (swap with drive B when in use) (I use it for storage only in Para.), 1581 disk drive as drive D, 1571 disk drive as Drive A (internal C128D drive) FD2000 (1996) as Drive C. I use a Magnavox 80 col. RGBI monitor, and an 1802 40 col monitor (both active at the same time), and a Micro R&D switcher to swap back and forth from my SmartTrack and SmartMouse input devices.
(.txt)