File name:	README.TXT		Revision date:	1992.07.19
Author:		Ulf Ronald Andersson	Creation date:	1992.07.19

Hejsan Martin!

Efter 7 sorger och 8 bedrvelser s har jag ntligen ftt ordning p GFA-
versionen av QWK-konverteringen.  Jag hade ett litet helsicke med att f
GSHELL att funka ordentligt, men det ordnade sig nr jag suddade den gamla
GSH-filen och startade om frn brjan igen.

Det blev ocks litet extra jobbigt nr jag upptckte att NVDI 2.0, som jag
nyligen brjat anvnda inte alls funkade bra med GFA-basic i TOS 2.6, och
srskilt illa med OverScan aktivt (och det har jag ju jmnt!!!).
S nu har jag gtt tillbaka till QST igen, varvat med Warp 9.
Synd bara att Warp 9 (version 3.5) fortfarande inte klarar breda GEM-fnster.

Sedan trasslade det till sig igen nr jag tittade p GFA-assembler, som du ju
hade bett mig att fixa.  Och det var nog tur att jag testade innan jag snde
den till dig eftersom den har massor av FATALA brister:

*  Den r helt inkompatibel med OverScan, och alla andra storbildsformat.
*  Den r helt inkompatibel med TOS 2.06, och allts med alla nya TOS.
*  Den har ostandardiserat interface, och misshandlar GEM.
   (fast det gller ju all GFA-mjukvara, inte minst basic'en :-)

Frst frstod jag inte vad du skulle ha sdan dynga till, men sedan lste jag
om manualen till GFA-Basic och sg att de inte ens kunnat flja spec'arna nr
de kopierade DR's objektformat.
D frstod jag ju att du naturligtvis behver GFA-assembler enbart fr att du
skall kunna modifiera GFA3BLIB, eftersom linkern inte klarar flera LIB.
Drfr har jag fr en gngs skull bootat TOS 1.4 utan OverScan f|r att prva
om det fungerar, vilket det (frvnande nog :-) tycks gra.

Under huvudmenyns avdelning "Assembler" ligger en submeny som innehller ett
kommando "Archive" som kan lsa in ett lib, kombinera det med nya moduler, och
sedan lagra det nya strre lib'et och ven dess nya utkade indexfil.

Men nu vidare till trevligare saker !!!

Jag har som sagt ftt ordning p konverteringarna nu, och har bifogat svl
GFA som C-version i separata foldrar, nmligen C_CONV\ och GFA_CONV\, vilka
innehller fljande filer:

C_CONV\
  PCR_CONV.C	kllkoden till PCR_CONV.O
  TST_CONV.C	kllkoden till TST_CONV.O fr att testa konvertering i C
  TST_CONV.CFG	lmplig (p mitt system iaf) konfig-fil till Pure C
  PCR_CONV.O	objektfilen med konv-funktionerna OBS: Nyttjas ven av GFA!!!
  TST_CONV.O	objektfilen med testprogrammet i C
  TST_CONV.PRJ	Projektfilen som anvndes vid kompileringen av testprogrammet
  TST_CONV.TTP	det frdiga testprogrammet som konverterar argument
  
GFA_CONV\
  TST_CONV.GFA	det hopbakade testprogrammet frdigt fr GFA-kompilering
  TST_CONV.GSH	de instllningar jag hade i GSHELL (du fr vl ndra paths)
  PCR_CONV.LST	mergefil med konv-funktioner som anvnds i interpretatorn, men
     -''-       som dremot anropar C-rutinerna i PCR_CONV.O vid kompilering
  TST_CONV.LST	mergefil med testloop som konverterar INPUT-data
  TST_CONV.O    objektfil fr ovanst testloop (innehller EJ konv-funktionerna)
  TST_CONV.TOS	frdigt program med testloop frn GFA och funktioner frn C.
  
De filer som r viktigast fr dig r allts:
  PCR_CONV.C	kllkoden fr konverterings-funktionerna i C
  PCR_CONV.O	den kompilerade objektmodulen med dessa C-funktioner
  PCR_CONV.LST	som 'merge'as med dina program fr att anropa C-funktionerna
                eller vid interpretering ven sjlv har den kod som d krvs

Jag bifogar ven den folder med GFA-assembler som medfljde ST Format #35.
Men var fr guds skull frsiktig, den verkar ovanligt lusig tom fr GFA.
Jag sj{lv skulle inte vga ha en hrddisk ansluten nr det progget kr.
Tragiskt att detta ska vara enda mjligheten att modifiera lib'et, om det nu
r s...

Nmner inte manualen ven ett program vid namn "DOINDEX"...?
Det kanske r vrt att kolla upp, det kan ju inte vara smre iaf !!!

Nej nu fr det rcka fr idag, jag ska packa arkivet och UL'a direkt.

Vi hrs snart igen!

Mvh:  Ronald Andersson