
	     QWKUTIL 2.1 Copyright (c) 1993,1994 Jarmo Aho


  QWKUTIL on skandinaavisten merkkien muunnosohjelma QWK-lukijoille.
QWKUTIL tekee muunnoksia 7-bittisten, IBM-merkkien (DOS) ja ISO-merkkien
(Windows, ANSI) vlill.  QWKUTIL on sinua varten, jos net purkeista
tulevissa viesteiss sulkuja tai sigmoja kksten sijasta ja haluat
korjata asian.  QWKUTIL 2.1 ei maksa mitn, mutta en toisaalta pahastu
vaikka haluaisit postittaa minulle lahjaksi tyhjn levykkeen. QWKUTILin
skandimuunnosten kytt voidaan haluttaessa mritell purkkikohtaisesti,
ja purkin sisll aluekohtaisesti.  Jos QWK-lukijasi lis kirjoittamiesi
viestien loppuun oman mainoksensa, sen poistamisen pitisi onnistua
QWKUTILilla.


VAATIMUKSET
===========

  Ehtona on, ett QWK-tiedostosi on pakattu PKZIPill tai yhteensopivalla
ohjelmalla.  Lisksi sinun on saatava kyttmsi QWK-lukija kutsumaan
ohjelmaa QWUNZIP ohjelman PKUNZIP sijasta sek vastaavasti QWZIP PKZIPin
sijasta.  Ja tietysti PKZIP ja PKUNZIP on oltava hakemistopolun varrella,
koska QWZIP ja QWUNZIP eivt ole pakkausohjelmia vaan ne tarvitsevat
PKZIPi ja PKUNZIPi avukseen.  QWZIP ja QWUNZIP eivt anna mitn
virheilmoitusta, jos ne eivt lyd tarvitsemiaan ohjelmia, joten
varmista, ett ohjelmat ovat PATH-muuttujan osoittamassa hakemistossa.
QWKUTIL vaatii vhintn 80286-prosessorin.  QWKUTIL on tehty DOS-
ohjelmaksi, mutta toimii hyvin mys Windows-ympristss.  Pakatun
viestitiedoston nimen tarkenteen on joko oltava REP tai alettava
kirjaimella Q. Tm siksi, ett jotkut etlukuohjelmat saattavat pakata ja
purkaa muitakin kuin QWK-tiedostoja.


KYTTNOTTO
============

  Jos et ole kyttnyt QWKUTILia ennen, kopioi ohjelmat QWZIP.EXE,
QWUNZIP.EXE ja QWKUTIL.EXE sek QWKUTIL.INI haluamaasi hakemistoon,
esimerkiksi samaan, jossa sinulla on PKZIP ja PKUNZIP.
Varmista, ett INI-tiedosto on samassa hakemistossa, johon aiot tmn
ohjelmiston jtt.  Oletuksena INI-tiedostossa on muunnokset lukiessa
Windowsin kyttmn merkistn ja lhetettvien viestien muunto
7-bittiseen merkistn.  Seuraava toimenpide on asettaa QWK-lukijasi
kyttmn ohjelmaparia QWZIP ja QWUNZIP QWK-tiedostojen pakkaamiseen ja
purkamiseen.  Sinun on itse tiedettv miten se tehdn, koska min en voi
tiet mit QWK-lukijaa sin kytt.  Esimerkiksi CMPQWK:ssa on valikossa
Options kohta Packers (versiossa 1.4), josta valitaan kytettv pakkaus-
ja purkuohjelma.  Valitse External (other), jonka jlkeen aukeaa
kyselyikkuna, johon kirjoitetaan:

  Un-Arhive Command: qwunzip %1 %2
  Archive Command  : qwzip %1 %2

BlueWavessa valitset

Pakkaus:  QWZIP.EXE @F @I
Purku:    QWUNZIP.EXE @F @I

Kaikki parametrit QW(UN)ZIPille ovat aivan samat kuin PK(UN)ZIPille.  Jos
siis haluat antaa muitakin parametreja kuin ksiteltvien tiedostojen
nimet, esim -ex, niin anna kaikki parametrit ikn kuin ajaisit suoraan
PK(UN)ZIPi.  WaveRider tarjoaa pakkauksessa viimeiseksi parametriksi -c.
Jt se pois, muuten PkZip ei tee mitn.  Muissa QWK-lukijoissa on
pitisi olla vastaava valinta.  Jos tt valintaa ei lydy tai et saa sit
toimimaan, on sinulla viel yksi mahdollisuus, josta kerron myhemmin
luvussa QWK-LUKIJAN PAKKOPAITA.  Lyhyen selostustuksen QWKUTILin
tuntemista komentoriviparametreista saat ajamalla QWKUTIL ilman
parametreja.  Useimpia parametreja et luultavasti koskaan tarvitse, sill
QWZIP ja QWUNZIP tekevt tyn puolestasi etk sin joudu ajamaan QWKUTILia
suoraan enemp kuin kerran.  Ja jos joudutkin, niin parametrien merkitys
selvi paremmin tmn ohjetekstin luettuasi.


QWKUTIL.INI ELI KONFIGUROINTI OMAN TARPEEN MUKAAN
=================================================
   
  Yleist
  -------

  QWKUTIL.INI on tavallinen tekstitiedosto, jota voit itse muokata
editorilla, joka pystyy tallentamaan ASCII-teksti.  Tiedoston pit olla
samassa hakemistossa kuin QWKUTIL.EXE.  Tiedostossa mritelln
mit merkkimuunnoksia kytetn ja poistetaanko QWK-lukijan lismt
mainokset.  Lisksi voit halutessasi mritell purkkikohtaisesti mink
viestialueiden merkit muutetaan tai ei muuteta.  Esimerkiksi
englanninkielisten viestialueiden merkkien muuttaminen on tarpeetonta ja
toisaalta turhien viestien muuttamatta jttminen nopeuttaa QWKUTILia.
  Jos kadotat tai sotket ini-tiedoston, niin voit tehd uuden komennolla 
QWKUTIL /uusi.
  QWKUTIL.INI jakautuu kahteen osaan.  Ensimminen on yleinen osa, jossa
mritelln kaikkia purkkeja koskevat asetukset.  Toisessa osassa ovat
purkkikohtaiset asetukset.  Purkkikohtaisia asetuksia ei ole pakko tehd.
Ensimminen osa alkaa tekstill [QWKUtil].  Jlkimminen osa ei ala
milln vakiotekstill, vaan osuuden aloittaa hakasulkujen sisll oleva
purkin nimi.  QWKUTIL lis itse automaattisesti tiedostoon kaikki
kyttmsi purkit.  Sinun tarvitsee vain list mahdolliset erityisohjeet
haluamallesi purkille.  Jos et purkkikohtaisia asetuksia halua, sinun ei
tosiaan tarvi tehd mitn.
  Jos kyttmsi QWK-lukija on Windowsohjelma, ja kytt QWK-lukijassasi
jotain muuta fonttia kuin Terminal, sinun ei vlttmtt tarvi muokata
QWKUTIL.INI ollenkaan alkuun pstksesi.  Jos kytt DOSsia tai jos
kytt Windowsissa Terminal-fonttia (tai muuta fonttia, jossa on
samanlainen merkist kuin DOSsissa), katso alta mit sinun pit tehd.
  Windows kytt erilaista merkist kuin DOS.  Tm tuottaa
suomalaisille pieni vaikeuksia kirjainten ,  ja  kanssa.  DOSsilla
kirjoitetuissa teksteiss nkyy Windowsissa kksten paikalla laatikoita
ja Windowsilla kirjoitetuissa teksteiss puolestaan nkyy DOSsissa outoja
merkkej kuten sigmoja.  Lisksi Windowsissa nkyvt merkit riippuvat
kytetyst fontista.  QWKUTIL selvitt kaikki nm ongelmat, kunhan
valitset oikean muunnostyypin.  Ikv kyll itse kirjoittamissasi
viesteiss tulet todennkisesti ennemmin tai myhemmin nkemn sulkuja
tai sigmoja.  Itse kirjoittamasi viestit QWKUTIL muuttaa vasta, kun teet
viestipaketin, joten et pse itse nkemn omia viestejsi muunnettuna.
Se mit net avatessasi olemassaolevan rep-tiedoston uudelleen luettavaksi
riippuu puolestaan ini-tiedoston asetuksista.

  Pikaohje muunnoksille
  ---------------------
  
1. DOS-kyttjt: Laita INI-tiedoston [QwkUtil]-lohkoon rivit

  LukuMerkit=IBM
  LukuMuunnettavat=ISO,SF7

2. Windows-kyttjt: Jos qwk-lukijassasi on fonttina Terminal tai MS
  LineDraw, tee kuten kohdassa 1. Jos kytt muuta fonttia, laita
  [QwkUtil]-lohkoon rivit

  LukuMerkit=ISO
  LukuMuunnettavat=SF7,IBM

  Jos kuitenkin net viestipaketissa laatikoita tai sigmoja, niin kokeile
  toista muunnosta.  l hkelly vaikka kirjoittaessasi viesti nkisit
  outoja merkkej; ne muutetaan kun pakkaat viestipaketin.

3. Monen shkpostin kohdalla voit kytt 7-bittisi merkkej, joten
  laita [QwkUtil]-lohkoon rivi

  MerkitUlos=SF7

  Voit list viel rivin MuunnettavatUlos=ISO,IBM.

4. Esimerkiksi Metropoli on siirtynyt ISO-merkistn, lis sellaisia
  purkkeja varten purkkilohkoon jokaisen purkin kohdalle rivi
  MerkitUlos=ISO (tai MerkitUlos=ANSI, mik on sama asia).  Kannattaa
  list mys MuunnettavatUlos=IBM (sama kuin DOS).  Tss tapauksessa
  DOS-merkit muutettaisiin kyll automaattisestikin, mutta nin voit
  rajata sulkumerkit muutosten ulottumattomiin.


  Esimerkki
  ---------

  Mallitiedosto:

[QWKUtil]
LukuMerkit=Dos
LukuMuunnettavat=ISO,SF7
MuunnettavatUlos=Dos,ISO
MerkitUlos=SF7
PoistaTag=On
Tag1=---
Tag2=  MinunQwk #Mainos#

[COMPART]
;ComPart BBS
SF7=0-99
ISO=31,1000-1159
Ei=45-999,1160-10000

[MPOLI]
;Metropoli
MerkitUlos=ISO

[MP]
;MikroPC BBS
MerkitUlos=Dos
MuunnettavatUlos=ISO

[OK]
;Ok BBS

[JOKU]
;Joku Shkposti
LukuMuunnettavat=Ei
MuunnettavatUlos=Ei


  Kydnp mallitiedosto yksityiskohtaisesti lpi.  Puolipisteell
alkavat rivit ovat kommentteja, jotka eivt vaikuta QWKUTILin toimintaan
mitenkn.  Ensimmisen on yleinen osa, jossa on kaikkia purkkeja
koskevat asetukset, jotka ovat voimassa ellei jonkun purkin kohdalla
erikseen muuta mainita.  Rivi LukuMerkit=Dos ottaa kyttn DOSsiin
sopivat muunnokset.  LukuMuunnettavat=ISO,SF7 sanoo ett kaikki
Windows-kkset ja 7-bittiset kkset muutetaan.  Rivi on periaatteessa
tarpeeton, koska ohjelma muuttaa aina kaikki merkistt ilmoitettuun
LukuMerkit-merkistn, jos et ole muuta ilmoittanut.  MerkiUlos=SF7 sanoo,
ett lhetettvien merkkien pit olla 7 bittisi.
MuunnettavatUlos=Dos,ISO kertoo mitk merkit muutetaan vastauspaketista.
Rivill PoistaTag=On kerrotaan, ett mainokset halutaan pois.  Seuraavat
kaksi rivi kertovat mist mainos tunnistetaan.  Mainoksen poistamista
varten sinun on luettava viel tarkempi selostus alempaa.  Jos poistat
mainoksen vain siksi ettet ole rekisterinyt shareware-ohjelmaasi, niin
suosittelen tt vain tilapisratkaisuksi.
  Seuraavana alkaa purkkiosa.  [COMPART]-lohkossa kerrotaan kyttjn
haluavan, ett viestialueille joiden numerona on 0-99 lhetetn 7
bittisi merkkej.  Alueille 31 ja 1000-1059 menee ISO Latin-1 merkkej ja
alueiden 45-999,1160-10000 viestien merkkej ei muuteta ollenkaan.
Huomaa, ett alue 31 esiintyy kahdella rivill.  Tllaisessa tilanteessa
jlkimminen asetus j voimaan.  Hakasuluissa olevan tekstin sek
puolipisteell alkavan rivin on lisnnyt QWKUTIL, kun se on ensimmisen
kerran kohdannut ComPartista tulleen viestipaketin.
  [MPOLI]-lohkossa ilmoitetaan, ett MetroPoliin kirjoitettaessa merkit
muutetaan ISO-standardin (=ANSI, Windowsin kyttm merkist) mukaisiksi.
Purkkilohkossa oleva MerkitUlos- tai LukuMerkit kumoaa aina samalla
[QwkUtil]-lohkon MuunnettavatUlos- tai LukuMuunnettavat-asetuksen.  Tss
esimerkiss MetroPoliin lhtevist viesteist muutetaan siis SF7- ja
IBM-merkit ISO-merkeiksi vaikka INI-tiedoston alussa muutettaviksi
merkistiksi oli laitettu DOS ja ISO.  
  [MP] eli MikroPC-shkpostiin lhetetn Dos:in kyttmi merkkej.
Muunnettavaksi on valittu vain ISO-merkit, jotta sulut ja kenoviivat ym.
pysyisivt ennallaan.
  Seuraavana on OK BBS, jonka kohdalla ei lue mitn, koska oletusarvot
eli se mit lukee lohkossa [QwkUtil] kelpaavat tlle purkille.
  Joku Shkpostia varten on muunnokset ottetu kokonaan pois kytst
tulevista ja lhtevist viestipaketeista riveill LukuMuunnettavat=Ei ja
MuunnettavatUlos=Ei.

  INI-tiedoston tarkka sislt
  ----------------------------  

Puolipisteell alkavia rivej voit laittaa mihin paikkaan tahansa
itsellesi selvennykseksi. Kirjainkoko, vlilynnit tai tyhjt rivit
eivt ole merkitsevi.  Pystyviiva '|' alla tarkoittaa sit, ett tasan
yksi vaihtoehdoista saa olla samalla rivill.  Pilkulla erotettuja
mreit saa yhdist.

[QWKUTIL]-lohkossa sek purkkilohkossa voi molemmissa olla seuraavat osat:

LukuMuunnettavat=IBM,ISO,SF7,DOS,ANSI|EI
MuunnettavatUlos=IBM,ISO,SF7,DOS,ANSI|EI
LukuMerkit=IBM|ISO|SF7|DOS|ANSI
MerkitUlos=IBM|ISO|SF7|DOS|ANSI
MuutaReplytLukiessa=On|Ei
PoistaTag=On|Ei

Ainoastaan lohko [QWKUTIL] voi sislt seuraavat asiat:

Tag1='joku teksti'
Tag2='joku muu teksti'

Ainoastaan purkkilohkoissa voi olla seuraava osa:

Ei=aluenumeroluettelo
ISO=aluenumeroluettelo   (ISO:n tilalle ky mik tahansa merkist)

DOS ja IBM tarkoittavat samaa asiaa eli DOSsissa kytettv merkist.
SF7 on 7-bittinen merkist, jossa kkset on korvattu mm. sulkumerkeill. 
ISO ja ANSI tarkoittavat keskenn samaa asiaa eli Windowsissa kytettv
merkist.

  Lohkossa [QWKUtil] kerrotaan globaalit asetukset.  Purkkilohko alkaa
hakasulkujen sisll olevalla purkin nimell, ja siin voidaan ohittaa
globaalit asetukset.  Lisksi viimeisen oleva asetus ohittaa aina aiemmin
olevan.  Voit toisin sanoen laittaa alkuun LukuMuunnettavat=Ei, jolloin
skandimuunnoksia ei tehd ellet tietyn purkin kohdalla muunnoksia laita
kyttn.  Huomaa, ett lohkon [QWKUtil] on oltava ennen minkn purkin
asetuksia (kommentteja saat kuitenkin list alkuun).  Purkkilohkossa
olevat asetukset eivt vaikuta mihinkn toiseen purkkiin.

LUKUMUUNNETTAVAT=IBM,ISO,SF7,DOS,ANSI|EI kertoo mitk merkit muutetaan
luettaessa viestej vai muutetaanko mitn.  Rivi ei ole pakollinen,
oletuksena on, ett kaikkien merkistjen merkit muutetaan merkistn, joka
kerrotaan LukuMerkit-asetuksella.  Arvo LukuMuunnettavat= EI est
merkkimuunnokset viestien lukemissa.

MUUNNETTAVATULOS=IBM,ISO,SF7,DOS,ANSI|EI kertoo mitk merkit muutetaan kun
kirjoitetaan viestej.  Rivi ei ole pakollinen, oletuksena on, ett
kaikkien merkistjen merkit muutetaan merkistn, joka kerrotaan
MerkitUlos-asetuksella.  Arvo MuunnettavatUlos=EI est merkkimuunnokset
viestej lhetettess.

LUKUMERKIT=IBM|DOS|SF7|ISO|ANSI kertoo mit merkist kyetn viestej
luettaessa.  Oletusarvona on ISO, jos INI-tiedostossa ei ole mitn.

MERKITULOS=IBM|ISO|SF7|DOS|ANSI kertoo mit merkist kytetn
lhetettviss viesteiss.

MUUTAREPLYTLUKIESSA=ON|EI
Jos tll asetuksella on arvo EI, niin avattaessa reply-pakettia
uudelleen luettavaksi ja editoitavaksi ei merkkimuunnoksia tehd.
Viestien pakkauksessa tm ei vaikuta mitn.  Asetuksen olemassaololle on
kaksi syyt.  Ensinnkin voit tmn avulla helposti tarkistaa millaisia
merkkej sin lhett purkkeihin, kun luet replysi muuntamattomina.
Toiseksi kun avaat olemassaolevan vastauspaketin ja pakkaat sen uudestaan,
niin osa merkeist muuttuu kahden muunnoskerran takia erilaiseksi kuin
piti.  Merkkien muunnos ei nimittin ole kokonaan palautuva prosessi;
kahden vastakkaiseen suuntaan tehdyn muutoksen jlkeen kaikki merkit eivt
ole alkuperisi.  Haittapuoli asetuksen kytst on tietysti, ett omia
viestejsi uudelleen lukiessasi tai editoidessasi net kuvaruudulla
skandien tilalla osittain muita merkkej.  Jos asetus
MuutaReplytLukiessa=EI puuttuu ini-tiedostosta, niin oletusarvona on On
eli vastauspaketit muunnetaan lukiessa.

POISTATAG=ON|EI kertoo poistetaanko QWK-lukijan lism mainos.
Oletusarvona on PoistaTag=On.  Viestin loppu Tag1:st alkaen tytetn
vlilynneill.

TAG1 ja TAG2 vaativat hieman lisselityksi.  Nm muodostavat muista
INI-tiedoston riveist poikkeuksen siin, ett vlilynnit ovat '='-merkin
jlkeen merkitsevi, samoin kirjainkoko on merkitsev, joten sinun on
oltava tarkkana.  Mainokset voivat olla kaksirivisi.  QWKUTILin
periaatteena on, ett ensimminen poistettava rivi on annettava Tag1-
lausessa kokonaan mikli haluat poistaa kaksi rivi.  Viimeisest rivist
riitt pelkk alkuosa (niin paljon merkkej kuin itse pidt
tarpeellisena).  Oletetaan, ett ohjelmasi lis viestien loppuun tekstin:

---
  MinunQwk #Mainos# Maailman paras ohjelma

Tss tapauksessa voit kytt mallitiedostossa olleita Tag1- ja
Tag2-mritelmi, jossa Tag1:ss on ensimminen rivi kokonaan ja Tag2:ssa
on vain alku toisesta rivist.  Jos haluat jtt viivat viestin loppuun
ja poistaa vain toisen rivin, tai jos ohjelmasi kytt vain yht rivi,
laita Tag1:een poistettavan rivin alku (tai koko rivi, jos haluat olla
varmempi), ja poista Tag2 INI-tiedostosta tai jt se '='-merkin jlkeen
tyhjksi.  Siis esimerkissmme:

Tag1=  MinunQwk #Mainos#


EI=aluenumeroluettelo
Jos sinulla on muunnokset kytss, voit rivill EI kertoa, mink
viestialueiden viestej jossakin purkissa ei muuteta.  
Aluenumeroluettelo voi olla esimerkiksi Ei=1-10,15,17,300-50000.  Voit
siis luetella alueita numero kerrallaan pilkulla toisistaan erotettuna, ja
voit antaa kokonaisen vlin kyttmll tavuviivaa.  Suurin mahdollinen
aluenumero, jonka QWK-formaatti sallii, on 65535.  Aluevalinta on
tarkoitettu vain merkkimuunnoksille, mainosrivit poistetaan kaikilta
alueilta.

ISO=aluenumeroluettelo
Ilmoittaa mille alueille haluat mitkin merkkej kirjoittaa.  Voit kytt
mit merkkilajia tahansa tss ISO:n tilalla.  Tm valinta vaikuttaa
ainoastaan lhetettvien viestien merkkeihin eli lukiessa tm ei vaikuta.
Jos luettelet vain osan alueista tll tavalla, niin ne alueet, joita ei
ole mainittu, muutetaan asetuksen MerkitUlos mukaan.


  Lisohjeita muunnoksiin
  -----------------------

  Oletetaan, ett kytt Windowsia, ja sinulla on lukiessa muunnokset
ANSI-merkistn.  Tllin sek 7-bittiset ett DOS-kkset muunnetaan
Windowsin merkistn, jos et ole mritellyt erikseen mitk merkit
muutetaan.  Jos viel oletetaan, ett shkpostisi kytt samaa merkist
kuin Windows (esim.  Metropoli), niin saattaa olla hyv mietti muunnoksia
hieman.  Toki asiaa kannattaa mietti, vaikka tm esimerkki ei ptisi
aivan sellaisenaan sinun kohdallasi.  Tss esimerkkitilanteessa
lhtevist viesteist muutetaan sek 7-bittiset ett DOS-kkset
ISO-merkistn, koska QWKUTIL muuttaa kaikki merkit, jos ei toisin sanota.
7-bittisten merkkien muunnokset lhteviss viesteiss kannattaa kuitenkin
ottaa pois plt, koska muuten kirjoittamasi haka- ja kaarisulut ja pari
muuta merkki muuttuvat kirjaimiksi.  Eli list rivin
MuunnettavatUlos=DOS.  Miksi sitten muuttaa edes DOS-merkkej, kun kerran
kytt Windowsia ja merkkisi ovat valmiiksi sit mit purkki haluaa
vastaanottaa?  Siksi, ett saatat kopioida teksti tiedostosta, jossa on
DOS-merkkej.  Voit kokeilla lisksi mit tapahtuu, kun list rivin
LukuMuunnettavat=Ei, jolloin mitn ei muuteta tulevista viesteist.
Silloin sulut pysyvt sulkuina.  Ongelma on siin, ett kaikki kyttjt
eivt ehk kyt purkin vaatimaa ISO-merkist, joten saatat nhd
kksten paikalla roskaa, jos otat muunnokset pois.  Voit mys laittaa
rivin LukuMuunnettavat=DOS, jolloin DOS-merkit muutetaan Windowsiin
sopivaksi silt varalta, ett joku huolimaton on DOS-merkkej kyttnyt
viesti kirjoittaessaan. Sulut pysyvt silti sulkuina.

  Lisksi on huomattava, ett jos laitat purkkilohkoon MerkitUlos-
asetuksen, niin yleisen lohkon MuunnettavatUlos-asetus muuttuu samalla
automaattisesti.  Jos siis haluat sdell mitk merkit muutetaan
lhetettvn merkistn, niin se on mriteltv purkkilohkossa
uudelleen. Sama ptee kohtiin LukuMerkit ja LukuMuunnettavat.


QWK-LUKIJAN PAKKOPAITA 
======================
  
  Tm luku sinun pit lukea, vain jos et saanut QWK-lukijaasi kutsumaan
ohjelmia QWZIP ja QWUNZIP luvussa KYTTNOTTO esitetyll tavalla.  Ennen
kuin jatkat, varmista ett sinulla on kopio QWK-lukijasta, koska joudut
nyt muuttamaan ohjelmaasi, enk halua ottaa vastuuta siit, ett
ohjelmallesi mahdollisesti tapahtuu jotain, jonka seurauksena se ei toimi.
Pelsty ei silti tarvi!  Kyll tmn muutoksen uskaltaa tehd, itsekin
olen joutunut thn aiemmin turvautumaan.  
  Sinun ei tarvitse tiet mitn exe-tiedostojen muuttamisesta, koska
QWKUTIL voi tehd sen puolestasi automaattisesti.  Jos osaat kytt
heksaeditoria ja jos sinulla sellainen on, niin voit tehd muutokset
itsekin.  Jos sinulla on CMPQWK, niin voit jtt tyn aivan huoletta
QWKUTILin hoidettavaksi ja todennkisesti muutenkin.  Ideana on
yksinkertaisesti, ett QWK-lukijasta etsitn merkkijonoja PKZIP ja
PKUNZIP, jotka korvataan merkkijonoilla QWZIP ja QWUNZIP.  Sen jlkeen
valitset QWK-lukijassasi pakkaus/purkuohjelmaksi PKZIPin ja PKUNZIPin.
(Mahdollisesti ohjelmasi tarjoaakin nyt ohjelmaparia QWZIP ja QWUNZIP!)
Esimerkiksi ohjelmasta CMPQWK.EXE etsitn PkZip %1 %2, joka korvataan
tekstill qwzip %1 %2, vastaavasti vaihdetaan PkUnZip %1 %2.  Jossain
toisessa ohjelmassa ei vlttmtt ole prosenttimerkkej, joista oikean
kohdan CMPQWK:n tapauksessa tunnistaa varmasti.  Siin tapauksessa voi
koettaa vaihtaa kaikki pkzip- ja pkunzip-tekstit.  Jos et halua tehd
muokkausta itse, voit kske QWKUTILia tekemn sen.  Tm tehdn
komennolla

  QWKUTIL /tohtoroi c:\minunqwk\minunqwk.exe 
  
c:\minunqwk\minunqwk.exe tilalle laitat tietysi kyttmsi QWK-lukijan
hakemiston ja nimen (tai ohjelmasi kyttmn konfigurointitiedoston
nimen).  Tm pit muistaa tehd uudestaa aina, kun pivitt QWK-lukijasi
uuteen versioon.  Muokkauksen peruutus onnistuu komennolla

  QWKUTIL /palauta c:\minunqwk\minunqwk.exe 
  
Peruutusta tarvitset, jos jostain merkillisest syyst QWKUTIL ei viel
tllkn tohtoroinnilla tullut kyttn tai jos haluat muuten vain olla
kyttmtt QWKUTILia.  Palautuksen jlkeen alkuperisen muuttamattoman ja
palautetun ohjelman vlill voi olla pikkuriikkinen ero, joka johtuu
siit, ett palautuksessa merkkijonot qwzip ja qwunzip korvataan
teksteill PkZip ja PkUnZip, ja alkuperisess tiedostossa ovat isot ja
pienet kirjaimet saattaneet olla eri tavalla.  Muuta eroa ei ole.
Kirjainkoolla on merkityst vain, jos QWK-lukija laskee itsestn
tarkistussumman muutoksien estmiseksi, yleens mikn ohjelma ei
kuitenkaan niin tee.


KYTT ILMAN QWZIP/QWUNZIPI
============================

  QWKUTILin kytt on mahdollista mys suoraan.  Kytt on kuitenkin
helpointa ohjelmaparin QWZIP/QWUNZIP kanssa, koska nm kaksi ohjelmaa
osaavat antaa QWKUTILille oikeat komentoriviparametrit ja lisksi QWZIP ja
QWUNZIP voidaan ajaa automaattisesti QWK-lukijasta.  Tmn luvun voit
aivan hyvin jtt lukematta, jos olet aiemmin esitetyill ohjeilla saanut
QWKUTILin toimimaan etk halua esim omia BAT-tiedostoja rakennella.
  
Nin se ky:

  qwkutil parametri hakemisto1 hakemisto2

Parametri on joko /pura tai /pakkaa.  Jos puretaan tai pakataan
rep-paketti (eli sinun kirjoittamasi lhetettvksi tarkoitetut viestit),
on hakemisto1:ss oltava paketin nimi, muuten hakemisto1:n paikalla voi
lukea mit hyvns (jotain on pakko kuitenkin laittaa).  Hakemisto2 on
hakemisto, jossa pakkaamattomassa muodossa olevat qwk-tiedostot ovat.

Esimerkkej: pakattu tiedosto on hakemistossa c:\dl.  QWK-lukijan kyttm
tyhakemisto eli hakemisto, johon QWK-tiedosto on purettu, on c:\qwk\work.

Muunnetaan purkista tullut QWK-tiedosto:

  qwkutil /pura mittahansathn c:\qwk\work

Tss tapauksessa c:\qwk\work-hakemistossa on oltava tiedostot
messages.dat ja control.dat.

Valmistetaan vastaustiedosto pakattavaksi:

  qwkutil /pakkaa c:\dl\purkki.rep c:\qwk\work\purkki.msg

Tss tapauksessa c:\qwk\work-hakemistossa on oltava tiedosto
purkki.msg.

Luetaan vastauspaketti QWK-lukijan uudelleen muokattavaksi:

  qwkutil /pura  c:\dl\purkki.rep c:\qwk\work

Mys tss tapauksessa c:\qwk\work-hakemistossa on oltava tiedosto
purkki.msg.

Hakemisto2 kertoo siis aina hakemiston, jossa pakkaamattomat
viestitiedostot ovat.  Lisksi vastauspakettia luotaessa hakemisto2:een
sisltyy viestit sisltvn tiedoston nimi, joka on aina muotoa purkki.msg.
Hakemisto1 tarvitaan vain, kun ksitelln rep-tiedostoa ja siin on
hakemiston lisksi oltava reply-tiedoston nimi, joka on aina muotoa
purkki.rep.  Lyhyesti sanottuna komentoriviparametrit ovat aivan samat
kuin mit annetaan ohjelmille PKZIP ja PKUNZIP, siit johtuu tuo
'mittahansathn', joka PKUNZIPille annettuna sislt todellista
informaatiota.  QWZIP ja QWUNZIP antavat QWKUTILILLE aivan samat
parametrit kuin mit QWZIP ja QWUNZIP saivat QWK-lukijalta listtyn
tietysti komennolla /pura tai /pakkaa.


PAKETTIIN KUULUVAT TIEDOSTOT
============================

   QWKUTIL.EXE   - varsinainen muunnokset tekev tyjuhta
   QWZIP.EXE     - apuohjelma PKZIPin ja QWKUTILin ajamiseen
   QWUNZIP.EXE   - apuohjelma PKUNZIPin ja QWKUTILin ajamiseen
   QWKUTIL.TXT   - sinun pitisi jo tiet
   QWKUTIL.INI	 - oletusarvot sisltv konfigurointitiedosto
   UUTTA.TXT     - kertoo mik on muuttunut edelliseen versioon verrattuna
   FILE_ID.DIZ   - kuvaus ohjelmasta

  Tt pakettia saa vapaasti levit, kunhan yllmainitut tiedostot
pidetn mukana.  File_id.diz-tiedostoa saa muuttaa, muihin ei saa tehd
mitn muutoksia.


MUUTA TIETOA
============

  QWKUTIL muuttaa merkit viestin otsikosta sek itse viestist.  Muuhun
kuten kirjoittajan tai vastaanottajan nimeen QWKUTIL ei koske.  Ainoat
kirjaimet, jotka muutetaan ovat , ,  (mys isot).

  Jos olet Windowsin kyttj ja olet kyttnyt PK(UN)ZIPille PIF-
tiedostoa ja haluat samojen asetusten toimivat QWKUTILin kanssa, niin
sinun pit tehd vastaavat PIF-tiedostot QW(UN)ZIPille.  QWKUTIL ei tarvi
omaa, koska se toimii QW(UN)ZIPin kautta.

  Jos ongelmia tulee tai sinulla on muita ehdotuksia ohjelman suhteen,
voit kirjoittaa minulle vaikka Internetin emailia kytten.  Compartiin
tai Metropoliin voit mys jtt viestin.  Hyvi ehdotuksia tm
ohjetekstin parantamiseksi voi mys antaa.

  En ole vastuussa mistn QWKUTILin, QWZIPin tai QWUNZIPin mahdollisesti
aiheuttamista vahingoista tai siit mit sin QWKUTIL-ohjelmalla teet.
Itsellni QWKUTIL ei ole koskaan aiheuttanut mitn vahinkoa, ei edes
parametreilla /tohtoroi ja /palauta.

  Ohjelmointivlineen oli Borland Pascal 7 with Objects.

  Jarmo Aho
  Neljs linja 20 B 50
  00530 Helsinki

  email: jarmo.aho@compart.fi
