
                          
                                    
                                      
                                   
                                      
                                

                                MBRead V1.03
                             1996 Jere Sanisalo

 Sislt:
----------
 1. Mik tm on?
  1.1. Erikoisuudet
   1.1.1. CD-Soittaja
   1.1.2. VenePeli
 2. Laillista
 3. Vaatimukset
 4. Rajoituksia
 5. Kyttnotto
  5.1. Asetukset
  5.1.1. MBSetup
  5.2. Ajaminen
 6. Kytt
  6.1. Nppimet
   6.1.1. Alueruutu
   6.1.2. Tiedostolista
   6.1.3. CD-Soitin
   6.1.4. Merkittyjen tiedostojen muokkaus (LISTA.xx)
  6.2. Lista
  6.3. Etsint
  6.4. Tiedostojen kopiointi
  6.5. Merkittyjen tiedostojen muokkaus
  6.6. Tiedostoalueen laskeminen
 7. Yhteyden otto
 8. Virhe tilanteita
 8.1. Kysymyksi vastauksineen
 9. Tausta tarina
 10. Teknist tietoa
 11. Kiitoksia ja tervehdyksi

<VIHJE: Jos haluat etsi vaikkapa aluetta 6.1.1, niin etsi hakusanalla [6.1.1]>

<VAROITUS: Tss .TXT-tiedostossa esiintyv teksti *EI* ole kirjakielt, joten
 lkt kukaan sikkyk sit. Siin voi mys olla ns. kirjoitusvihreit!-) >

                                  *  *  *

 [1] Mik tm on?
-------------------
Tm ohjelma on suunniteltu tiedosto alueiden "etlukijaksi" jolloin kyttj
voi ottaa haluamastaan BBS-jrjestelmst tiedostolistan ja lukea sit
rauhassa kotonaan. Tm ohjelma on ERITYISESTI suunniteltu BBS-jrjestelmn
nimelt MBNet joka on MikroBitti-lehden yllpitm. Tm ohjelma tuskin edes
toimii muilla BBS-jrjestelmill, ellei niiden tiedostolista ole lheisesti
samanlainen kuin MBNetiss (jossa muuten on PCBoard).

 [1.1] Erikoisuudet
--------------------
MBReadissa on varmasti monia erikoisuuksia joita tuskin lytyy vastaavista oh-
jelmista. Tm johtuu siit, etteivt ne aivan ensimmiseksi tule mieleen kun
ajattelee tllaista ohjelmaa. MBReadissa siis on mukana VENEPELI ja CD-SOITIN!
Eli jos joskus tiedostoja selatessasi rupeaa kyllstyttmn, pistt CD-soitti-
mella musiikkia (tarvitsee CD-ROM aseman!) ja pelaat pari peli VenePeli. Nin
se aika kuluu. :) VenePelin ohjeet ovat peliss itsessn.

 [1.1.1] CD-Soittaja
---------------------
CD-Soittaja listtiin MBReadiin posin siksi koska tekijll sattui olemaan
valmiit aikaisemmin tehdyt CD-Rutiinit. Tm CD-Soitin tukee montaa eri CD-Rom
asemaa samassa koneessa, joten jos vaikka haluat soittaa 5:tt CD:t yhtaikaa
ja omistat 5 asemaa ja kaikki on kytketty koneeseesi niin sekin onnistuu.

 [1.1.2] VenePeli
------------------
Mukaan MBReadiin on laitettu mys vhemmn hydyllinen mutta enemmn mielen-
kiintoinen tekstitila-peli. Itse peliss on paremmat ohjeet siit ett mik se
on ja miten sit pelaillaan. Peliss on mys TOP-20-listat. Idea thn peliin
juurtaa joiltain lukion 1lk:n musiikin tunneilta jolloin ers kaverini sanoi,
ett tekisin tllaisen pelin TI-85 laskimelle (on muuten ihan ktev vehje). Ja
niin asiat johtivat seuraavaan ja tss on PC-versio samasta pelist. Tllaisia
on saattanut aikaisemminkin olla, mutta tm oli helppo ja nopea tehd, eik se
vie paljoakaan tilaa itse .EXE:ss joten se nyt on siin, piditte siit tai et!

                                  *  *  *

 [2] Laillista
---------------
Tm ohjelma on TYSIN ilmainen joten sit suuremmalla syyll tekijll ei ole
MITN pakotteita korvata vahinkoja jota tm tekee sinulle, omistamillesi
tavaroille, puhelin laskuillesi, kultakalallesi tai millekn muulle. Kytt
tt OMALLA RISKILLSI! Tosin tmn ohjelman tekij on pyrkinyt vakaaseen
kyttn ja toimivuuteen joten voit olla rauhallisin mielin. Tekij ei myskn
vastaa siit ett tm edes toimisi!! Ainut mit tekij voi luvata on se ett
tm vie tilaa levyltsi! Saat levitt tt ohjelmaa minne tahansa kunhan
yhtn tiedostoa ei ole poistettu, listty tai muokattu ja levitt alkuperist
.ZIP-pakettia. Mitn maksua tst ohjelmasta ei saa pyyt eik tmn ohjelman
kopioinnista saa pyyt yli posti- ja ksittelykulujen suuruista summaa. Mitn
osaa tst ohjelmasta tai muusta mukana tulevasta materiaalista EI saa kytt
tai muuttaa ilman tekijn vahvistamaa lupaa.

                                  *  *  *

 [3] Vaatimukset
-----------------
Minimi:
 8086-tasoinen IBM PC yhteensopiva tietokone
 MS-DOS yhteensopiva kyttjrjestelm
 Nppimist
 Nytt
 Kovalevy
 n. 450 kiloa perusmuistia
Suositeltava:
 386/486-tasoinen IBM PC yhteensopiva tietokone
 MS-DOS yhteensopiva kyttjrjestelm
 Nppimist
 Nytt
 Kovalevy
 n. 450 kiloa perusmuistia
 SMARTDRIVE tai vastaava ohjelma
Huippu tasoinen:
 Pentium-tasoinen IBM PC yhteensopiva tietokone
 MS-DOS yhteensopiva kyttjrjestelm
 CD-ROM asema(t)
 Nppimist
 Nytt
 Kovalevy
 n. 450 kiloa perusmuistia
 SMARTDRIVE tai vastaava ohjelma (nostaa suorituskyky 200%:lla!)
--
 Koska muistinkulutus on alhainen, nkyy se toisaalta kovalevyn kytst. Eli
MBRead indeksoi tiedosto-listasi 'IDX\'-hakemistoon (mikli sit ei lydy,
MBRead tekee sen sinne). Tm vie NOIN 1.1 kertaa enemmn tilaa kuin tiedosto-
lista. Tmn jlkeen on mahdollista ett poistat tiedostolistasi kokonaan pois
koska MBRead toimii ilmankin kunhan vain 'IDX\'-hakemistossa pysyvt kaikki
tiedostot kunnossa. MBRead kytt mys kovalevy aika paljon (= usein) eli
nopeasta kovalevyst ei ole ainakaan haittaa.
 MBReadiin on mys sislletty pienimuotoinen CD-ROM soittaja (kytt
MSCDEX:) joka tukee mys montaa eri CD-Romia mikli joku omistaa useamman
niit. Tm CD-Rom ominaisuus listtiin vain siksi koska tekijll sattui ole-
maan CD-rutiinit valmiina joten aikaa ei kulunut kuin noin 5 minuuttia.. :)
 MBReadin EXE on pakattu LZEXE-ohjelman versiolla 0.91 joten se ei vie tilaa
kuin noin suunnilleen puolet siit mit se tekisi kntjll knnettyn.
Mutta silti sen pitisi toimia 8086:lla. Ainakin tllaisen kuvan antavat LZExen
dokumentoinnit.
 DOS:n versiosta ei ole tietoa mutta ainakin 5.xx:ll luulisi toimivan, toden-
nkisesti alhaisemmillakin. CD-Rutiineistakaan ei ole liiemmin tietoa.

                                  *  *  *

 [4] Rajoituksia
-----------------
Vaikka tm ohjelma on suunniteltu siten ett 8086-kone riitt kunhan vain
kovalevy riitt, lytyy silti joitain tiettyj sisisi rajoituksia. Alueiden
maksimi mr on 800 kpl. Ja yhden tiedoston kuvauksen maksimi pituus on 19
rivi (tied sitten mit tapahtuu nill tiedostoilla koska kokemuksia ei viel
ole :). CD-Rommien maksimi mr on jotain 255 kpl eli jos joku omistaa enemmn
nit ja kaikki ovat viel jotenkin saatu toimimaan DOS:n kanssa yhtaikaa niin
se on VOIVOI! Tuhlasit rahasi turhaan liian moneen CD-Rom asemaan.. :) Tiedos-
toja merkkaillessakin on taas ikv raja. Voit merkata VAIN 5000 tiedostoa.
Sitten sinun tytyy vlill kyd hakemassa ne 5000 ja sitten merkata toiset.
Mutta luulisin tmn riittvn ainakin joksikin aikaa. Sitten kun markkinoille
tulee ensimmisen 28800 MB modeemit niin eikhn MBReadkin ole jo kehittynyt
jonkin verran.. :)

                                  *  *  *

 [5] Kyttnotto
-------------------
MBReadin kyttn otto ei ole vaikeaa. Teet sille mieluiten oman hakemiston ja
purat MBReadin ZIP-paketin sinne. Tst hakemistosta ajat sitten MBReadin.
MBRead etsii MB_FILES.LST-tiedostoa vakiona ja mikli sellainen lytyy niin se
indeksoidaan jne. Kytt on todella helppoa ja yksiselitteist. Mutta nist
lis myhemmin. Mys erinimisi listatiedostoja tuetaan mutta MB_FILES.LST on
vakiona (kts. asetukset)! Mukana pitisi tulla tekstitiedosto nimelt
'LUEMINUT.TXT', ja siin on kaikki tarvittava alkuun psemiseksi.

 [5.1] Asetukset
-----------------
MBReadin asetukset hoituvat kaikki joko MBREAD.CTL-tiedoston kautta tai sitten
suoraan komentorivilt. Tss on selitelty MBREAD.CTL-kontrollitiedoston ra-
kennetta ja toimintaa.
 MBREAD.CTL-tiedosto on normaali tekstitiedosto jota sinun kannattaa editoida
jollakin tekstieditorilla. (DOS:n mukana tulee EDIT.EXE)
.CTL-tiedostossa '#'-merkill alkavat rivit ovat kommentteja. Alkuperisen
MBReadin mukana tulleessa MBREAD.CTL:ssa on hyvt kommentit joka direktiivist
(mreest). Osa MBReadin .CTL:n asetuksista ovat sellaisia ettei niihin kan-
nata kajota, joten pid nyrkkisntn se, ett jos et tajua sit, l koske
siihen. Komentorivilt voit mrt MBReadille mys muita .CTL-tiedostoja,
mutta muista ett MBREAD.CTL ladataan _AINA_ ensiksi, eli se on PAKKO lyty
samasta hakemistosta kuin MBRead.

 [5.1.1] MBSetup
-----------------
Versiosta 1.02 lhtien MBReadin mukana on tullut .CTL:n muokkaamiseen tarkoi-
tettu lisohjelma, MBSetup. Se tekee saman asian kuin vaikka DOS:n EDIT, mutta
hieman mukavammin ja helppokyttisemmin. Siin on vain 4 nppint, <ESC>:st
lopettaa, <F1>:st tulee apua (mikli siit aiheesta on saatavilla) ja
<SPACE>:sta tai 'M'. Tietty siin on mys <Yls>, <Alas>, <Home>, <End>, <PgUp>
ja <PgDown>. Muista, ett sill voi MUUTTAA vain olemassa olevia kontrollitie-
dostoja, etk voi list yhtn kohtaa sinne, saati poistaa. MBSetup jtt
mys kaikki kommentit paikalleen. Kontrollitiedoston max. koko on n. 500 rivi.
<<UUTTA MBSETUPIN V1.01:>>
MBSetupin versiosta v1.01 lhtien voi vrej ja ON/OFF(/ASK)-kytkimi muutella
MYS nuoli oikealle/vasemmalle-nppimill!

 [5.2] Ajaminen
----------------
MBRead kynnistyy kskyll 'MBREAD'. Paljoa muuta se ei tarvitse. Voit muutella
osia parametreist komentorivilt ksin. Muista ett komentorivi ksitelln
MBREAD.CTL:n lukemisen _JLKEEN_ (Sen takia ett nm ohittaisivat CTL:n
prioriteetin)! Saadaksesi listan MBReadin parametreist, kynnist MBRead ko-
mennolla 'MBREAD -?' (ilman ' merkkej tietysti).

                                  *  *  *

 [6] Kytt
------------
MBReadin kytt on aika yksiselitteist. Kelausruutuja on vain 2, toisessa
valitset alueen ja toisessa taas kelailet tiedostoja (joko valitun alueen tai
sitten etsinnn tuloksia). Lisksi on mys merkittyjen tiedostojen kelaus.
Kytt yleens toimii nuolinppimill ja ruudun alalaidassa on kaikki trkeim-
mt kskyt muistutuksena viel.

 [6.1] Nppimet
-----------------
Tss on suunnilleen kaikki tuetut nppin toiminnot MBReadissa. VenePelin np-
pimi ei ole tss kerrottu koska ne ovat itse pelin alussa.

 [6.1.1] Alueruutu
-------------------
 <F10>      Kynnist ruudunsstjn vlittmsti.
 <Home>     Hypp aluelistan alkuun.
 <End>      Hypp aluelistan loppuun.
 <PgUp>     Hypp yhden ruudullisen verran ylspin listassa.
 <PgDown>   Hypp yhden ruudullisen verran alaspin listassa.
 <Up>       Siirtyy yhden rivin verran ylspin listassa.
 <Down>     Siirtyy yhden rivin verran alaspin listassa.
 <Right>    Siirtyy valitulle alueelle. (Sama kuin <ENTER>!)
 <ENTER>    (kts. <Right>)
 <ESC>      Lopettaa MBReadin.
 <SPACE>    (kts. ksky 'V' edesspin)

 1          Siirtyy 80x25 ruutu moodiin.
 2          Siirtyy 80x50 ruutu moodiin.
 B          Kynnist VenePelin. :)
 C          Mikli MBRead lysi MSCDEX-yhteensopivan cd-ajurin kynnistyksess,
            tm ksky hypp CD-Soittelijaan.
 E          Etsii jotakin hakusanaa listasta. (Mys & ja | -merkit toimivat!)
 M          Merkittyjen tiedostojen muokkaus.
 R          Piirt ruudun uudelleen.
 V          Valitse alue etsint varten.

 [6.1.2] Tiedostolista
-----------------------
 <F10>      Kynnist ruudunsstjn vlittmsti.
 <Home>     Siirtyy aivan listan alkuun.
 <End>      Siirtyy aivan listan loppuun.
 <Up>       Siirtyy yhden tiedoston verran ylspin listassa.
 <Down>     Siirtyy yhden tiedoston verran alaspin listassa.
 <Left>     Siirtyy takaisin alueruutuun. (Sama kuin <ESC>!)
 <ESC>      (kts. <Left>)
 <Space>    (kts. M)

 C          Mikli MBRead lysi MSCDEX-yhteensopivan cd-ajurin kynnistyksess,
            tm ksky hypp CD-Soittelijaan.
 E          Pika-etsint. Etsii jotakin yht sanaa koko listasta ja pyshtyy
            aina seuraavaan osumaan. Thn _EI_ saa mitn ehtoja! Tm aloit-
            taa etsinnn aina alusta, 'S' jatkaa seuraavaan.
 H          Hypp tiedostoon numeron perusteella (ensimminen tiedosto on 1
            jne.).
 K          Mikli tiedostojen kopiointi on kytketty plle .CTL:st, niin tl-
            l kskyll voit kopioida tiedostoja itsellesi toiseen hakemistoon.
 L          Laskee jokaisen tiedoston koon ja mys sen, ett kuinka kauan kes-
            tisi jos ottaisit KAIKKI listan tiedostot modeemilla. Tst on
            erityisesti hyty jos etsit kaikki merkatut tiedostot ja lasket
            silloin niin tiedt ett kauan kest.
 M          Merkkaa tiedoston 'LISTA.xx'-tiedostoon.
 R          Piirt ruudun uudelleen.
 S          Etsii seuraavaa osumaa joka on 'E':ll aloitettu.

 [6.1.3] CD-Soitin
-------------------
 <F10>      Kynnist ruudunsstjn vlittmsti.
 <ESC>      Siirtyy takaisin edelliseen ruutuun.

 +          Seuraava CD-Rom asema (Mikli niit on useampia).
 -          Edellinen CD-Rom asema (Mikli niit on useampia).
 <          Siirry edelliseen kappaleeseen ja aloita soittaminen.
 >          Siirry seuraavaan kappaleeseen ja aloita soittaminen.

 C          Jatka soittamista. (mikli pysytetty!)
 P          Aloita soittaminen ensimmisest kappaleesta.
 R          Piirt ruudun uudelleen.
 S          Pysyt soittaminen.

 [6.1.4] Merkittyjen tiedostojen muokkaus (LISTA.xx)
-----------------------------------------------------
 <F10>      Kynnist ruudunsstjn vlittmsti.
 <Home>     Hypp tiedostolistan alkuun.
 <End>      Hypp tiedostolistan loppuun.
 <PgUp>     Hypp yhden ruudullisen verran ylspin listassa.
 <PgDown>   Hypp yhden ruudullisen verran alaspin listassa.
 <Up>       Siirtyy yhden tiedoston verran ylspin listassa.
 <Down>     Siirtyy yhden tiedoston verran alaspin listassa.
 <Left>     Siirtyy takaisin alueruutuun. (Sama kuin <ESC>!)
 <ESC>      Siirtyy takaisin alueruutuun.
 <SPACE>    Merkitse/Poista tiedosto merkittyjen tiedostojen listalta.

 1          Siirtyy 80x25 ruutu moodiin.
 2          Siirtyy 80x50 ruutu moodiin.
 B          Kynnist VenePelin.
 C          Mikli MBRead lysi MSCDEX-yhteensopivan cd-ajurin kynnistyksess,
            tm ksky hypp CD-Soittelijaan.
 E          Etsii merkatut tiedostot tiedostolistasta.
 K          Mikli tiedostojen kopiointi on kytketty plle .CTL:st, niin tl-
            l kskyll voit kopioida tiedostoja itsellesi toiseen hakemistoon.
 L          Lis uuden tiedoston (kysyy nime jne.)
 M          Muokkaa valitun tiedoston nime.
 R          Piirt ruudun uudelleen.

 [6.2] Lista
-------------
MBRead tukee sellaista ominaisuutta, ett voit valita tiedostosi kotona omassa
rauhassasi, ja sitten koota niiden nimet yhteen tiedostoon, jonka sitten lhe-
tt MBNettiin, joka taas sitten lhett takaisin valitsemasi tiedostot. Voit
merkata tiedostoja 'M'-nppimell tiedostoja selaillessasi. 'LISTA.xx':n pte
tulee nimesi perusteella, josta on MBREAD.CTL-tiedostossa enemmn tietoa.
Vakiona se on ohjelman tekijn mukaan, joten kannattaa muuttaa sit, muuten se
ei ehk toimi kun kokeilet sit MBNetiss. LISTA-imuroinnin komento on tietysti
'LISTA' MBNetiss, ellei sit ole muutettu, joka on eptodennkist.

 [6.3] Etsint
---------------
MBReadilla voit etsi tiedostoja listasta melkein miten haluat. Voit etsi
vain yhdelt alueelta, kaikilta tai sitten vain valituilta alueilta ('V'-np-
pimell voit valita alueita niit selatessasi).
Etsint kynnistetn 'E'-nppimell alueita selattaessa. Sitten sinulta kysy-
tn ett mit merkkijonoa etsitn. Samalla voit muuttaa tiettyj asetuksia
funktionppimist (ruudussa on lis helppi niist). Etsittvss merkkijo-
nossa voi olla '&' (JA) ja '|' (TAI) -ehtoja thn tyyliin:
 "JERE"
  * Etsii sanaa "JERE".
 "JERE SANISALO"
  * Etsii sanoja "JERE" _ja_ "SANISALO". Jos molemmat lytyy niin tiedosto kel-
    paa.
 "JERE & SANISALO"
  * Etsii sanoja "JERE" _ja_ "SANISALO". Jos molemmat lytyy niin tiedosto kel-
    paa.
 "JERE | SANISALO"
  * Etsii sanaa "JERE" _tai_ "SANISALO". Jos jompikumpi tai molemmat lytyvt,
    niin tiedosto kelpaa.
 "JERE | SANISALO & MBREAD"
  * Etsitn merkkijonoja: "JERE" tai "SANISALO & MBREAD"
 "A & B | C& && D || | JEE |"
  * Etsitn merkkijonoja (("A" ja "B") tai ("C&" ja "&" ja "D" ja "|") tai
    ("JEE")).
    HUOM! Keskimmisess merkkijonossa, "C& & D |":ss, '&' ja '|' merkit
          EIVT merkitse mitn, koska alkuperisess niit oli 2 kpl, joka
          kumoaa ehtosysteemin.
Eli '|' merkki jakaa aina puoliksi merkkijonon. Tietty tm on hieman rajoit-
teista, mutta siihen on tyytyminen.

 [6.4] Tiedostojen kopiointi
-----------------------------
Tm ominaisuus ei ole viel varsinaisesti kytss, mutta se on tehty tulevan
varalle. Eli jos sinulla on osa tai kaikki tiedostolistan tiedostot jossain ha-
kemistossa (kuten CD-asemalla), niin antamalla MBReadille .CTL-tiedostossa
MBReadille sen hakemiston hakemistopolun, voit kopioida tiedostosi MBReadista
ksin ('K'-nppin tiedostoja/merkattuja tiedostoja kelatessa). Tt kirjoit-
taessa on jo julkaistu MB-CD #1, jossa ei ole mitn listaa niist tiedostois-
ta. Eli nyt vain odotetaan ja toivotaan, ett joku tekee .LST-listan niist
tiedostoista, niin psee kelaamaan/kopioimaan tiedostojaan MBReadista ksin.

 [6.5] Merkittyjen tiedostojen muokkaus
----------------------------------------
MBReadilla voit mys muokata jo merkattujen tiedostojen listaa. Thn valikkoon
psee painamalla 'M' aluevalinnassa. Merkittyj tiedostoja voit joko muokata
nimelt ('M') tai sitten lisill omia vapaavalintaisia tiedostoja ('L'). Jos
tiedostojen kopiointi on kytketty plle, niin 'K'-nppimell voit kopioida
tiedostoja mys.

 [6.6] Tiedostoalueen laskeminen
---------------------------------
MBRead pystyy laskemaan mink tahansa alueen kaikkien tiedostojen yhteenlaske-
tun summan ja mys sen, ett kuinka kauan ne kestisi ottaa modeemilla. Tm on
mahdollista VAIN kokonaisilla listoilla. Ai mitk hyty siit sitten on kun
tuskin kukaan koko listaa ottaa? Noh kun olet etsinyt kaikki merkatut tiedostot
samaan listaan, niin silloin voit laskea ett kuinka kauan ne kest ottaa.
Tt varten tm on thn tehtykkin.

                                  *  *  *

 [7] Yhteyden otto
-------------------
Kuten sanottu tm ohjelma on ilmainen joten mitn rahaa ei ole pakko
lhett. Kaikki raha, lahjoitukset ja fani-posti kyll vastaan otetaan avomie-
lin. Uusin versio lytyy aina MBNetist. Jos on jotain kysymist, parannuseh-
dotuksia, bugi-raportteja tai muuta mukavaa, ota yhteytt:
  SkyLiner BBS, 955-176242, 24h, v34  (Jt viesti tnne)
  MBNet, Numerot varmaan tiedt jos olet kynyt tll, 24h (miinus kaatuilut:)
Osoite:
  Jere Sanisalo
  Kappalaisenkatu 4D16
  50170 Mikkeli
E-Mail (nykyinen):
  jere.sanisalo@under.nullnet.fi  (Ei ole varma mutta kokeilla saa)

                                  *  *  *

 [8] Virhe tilanteita
----------------------
Tss muutama asia ennen kuin kannattaa ottaa ohjelman tekijn yhteytt bugi-
raporttien johdossa:
 - MBRead TARVITSEE hieman plle 450kb (perus)muistia!
 - l kynnist MBReadia pathin varrelta. Sen PITISI toimia, mutta jos jo-
   tain tapahtuu, kokeile samasta hakemistosta uudelleen.
 - Jos CD:n tunnistus ei toimi Windowsissa/OS/2:ssa kyt FORCE-CD-
   komentorivi kytkint. ('-CD'!)
 - Voi olla ettei etsint-parseri osaa kaikkia eri mahdollisuuksia. Sellaiset
   kuten "| && | | & & || & | & && || & ||'-voivat tuottaa hankaluuksia, joten
   l edes kokeile niit!
 - MBReadia tehdn koko ajan lis, joten bugeista kannattaa ilmoittaa!

 [8.1] Kysymyksi vastauksineen
--------------------------------
K. Indeksoinnissa MBRead menee jumiin kun tiedostolistoja ollaan ksitelty
   jo jonkin matkaa, miksi?
V. Todennkisesti kovalevyltsi on loppunut tila joten tee lis ja kynnist
   MBRead uudelleen.

K. Olen jo indeksoinut listan ja se toimi aivan mainiosti jonkin aikaa, mutta
   nyt yhtkki MBRead kaatuu Run-Time Erroriin tai vastaavaan, mit teen?
V. Todennkisesti jokin 'IDX\'-hakemistossa olevista tiedostoista on rikki.
   Kynnist MBRead komennolla 'MBREAD.EXE /R'.

K. Pidn MBReadista NIIN paljon etten haluaisi edes sammuttaa sit, mutta nyt-
   tni en voi sammuttaa josatain syyst, joten onko mitn ruudunsstj
   tehty MBReadiin tllisten tapauksien varalle?
V. Tottahan toki. Kun purit MBReadin (alkuperisest .ZIP-paketista, eik
   niin? :) niin mukana tulleissa asetuksissa se on asetettu kynnistymn 5:n
   minuutin tekemttmyyden jlkeen, mutta tt voit muuttaa MBREAD.CTL:st.
   Jos jostain kumman syyst nytnsstj ei toimi kunnolla (ei palauta
   alkup. ruutua), niin kytke se pois!

K. Kun luen tiedostoja, on kelaaminen HIRVEN hidasta, miss vika?
V. Todennkisesti kovalevysssi koska MBRead lukee kaiken sielt muistin
   sstmiseksi. Joten kokeile ladata SmartDrive ja poistaa kaikki moniajo-
   jrjestelmt ja yrit uudelleen.

K. Minulla on tiedosto-oikeudet erseen BBS:n jossa kytn MBReadia, eik
   MBRead laske tiedostojen lukumr ja/tai kokoa oikein! Miksi?
V. Mist min tietisin. :) Syyttk osaksi tst 'Tarmo Toikkanen'-nimist
   henkil MBNetiss, joka kuului MBReadin tapaisten ohjelmien kilpailun
   jrjestjiin, eik voinut/viitsinyt/halunnut/kehdannut antaa minulle oikeita
   tuloksia nist asioista ja JOSTAIN syyst hermot pettivt kun yritin laski-
   mella vnt noita 15000 tiedostoa yhteen.. :) Joten jos vikaa lytyy ja
   heitto on useissa sadoissa megoissa niin ottakaa yhteytt niin asia
   korjataan.

K. Minulta loppuu kovalevyltni tila koska pidn siell pakattua, purettua ja
   indeksoitua MBNetin tiedostolistaa, onko mitn tapaa pienent tt menek-
   ki?
V. Kyll on. MBRead _EI_ tarvitse pakattua tai purettua listatiedostoa jos
   valmiiksi indeksoitu lista lytyy. Joten ainakin puretun listan voit tuhota.
   Pakattu kannattaa silytt siit syyst ett jos indeksi-tiedostoille ta-
   pahtuu jotain, niin voit tarvittaessa indeksoida uudelleen.

K. Toimiiko MBRead muillakin kyttjrjestelmill kuin MS-DOS?
V. Kyll, mikli se on MS-DOS yhteensopiva. Joten MBRead EI kyt mitn eri-
   koisuuksia ettei se toimisi. CD-Rom rutiineista ei ole varmaa tietoa, ett
   toimivatko ne Windowsissa tai OS/2:ssa tai muissakaan. Mukana tulee mys
   OS/2 versio jonka pitisi ainakin periaatteessa nimens mukaisesti toimia
   OS/2-kyttjrjestelmss.. :)

K. Miksi MBReadissa ei ole alueen poistamis-mahdollisuutta vaikka joissain
   muissa vastaavissa ohjelmissa se onkin?
V. Vain siksi ett tiedostoalueen poistaminen jossa on X tiedostoa kest
   suunnilleen yht kauan kuin kokolistan indeksointi, eli se olisi TODELLA hi-
   dasta. Tm tosin tehdn ehk jos tarpeeksi moni sit pyyt.

K. Minulla on SB 2.0 ja mitn ni siit ei kuulu, mik vikana?
V. MBRead ei tue nikortteja, viel. Joten mikn ei ole vikana. Pieni lahjoi-
   tus saattaa tuoda nikorttituenkin thn.. :)

K. Jos otan uuden .LST tiedoston, osaako MBRead automaattisesti kytt sit?
V. Kyll osaa. MBRead kysyy sinulta ett haluatko uudelleen indeksoida sen tai
   sitten kytt vanhaa.

K. Kun yritn kynnist MBReadia, tulee vain "Undefined Error ...", miksi?
V. Perusmuistisi on loppu, joten hommaa sit jostain lis. (tuskin kaupasta
   kuitenkaan :)

K. Viek MBRead kaiken mahdollisen tehon irti moniajo-kyttjrjestelmstni
   mink se vain suinkin ksiins saa?
V. Ei. MBReadiin on rakennettu tuki mys Windowsille, OS/2:lle ja DesqViewille
   tarkoittaen sit ett MBRead antaa silloin tllin mys muille ohjelmille.

K. Tm teksti on tynn kirjoitus vihreit ja olen KYLLSTYNYT siihen. Mit
   tlle voi tehd?                  --
V. 1) Ilmoita ne tekijlle (mutta ilman kirosanoja kitoos).
   2) Lue vain kerran lpi tm niin ne eivt hiritse.
   3) Korjaa ne itse.
   4) l vlit niist.

K. Olen ottanut esim. MB_PC.LST nimisen tiedoston MBNetist, mutta MBRead
   valittaa, ettei 'MB_FILES.LST'-tiedostoa lydy, mit teen?
V. Joko annat parametrina .LST:n nimen ('MBREAD.EXE MB_PC.LST'), tai sitten
   muutat sen .CTL-tiedostoon vakioksi (oletuksena kytetn 'MBREAD.CTL':,
   mutta parametrill -C:<.CTL> sit voidaan vaihtaa (esim.
   'MBREAD.EXE -C:TESTI.CTL' (HUOM! 'MBREAD.CTL' ladataan silti, mutta se lada-
   taan ennen 'TESTI.CTL':!!)).

K. Miksi etsinnss on niin huonosti tehty ehdot?
V. Ensiksi: MBRead valmistui MBNetin kilpailun myt. Toiseksi: Kilpailulla oli
   aikaraja. Joten minulla (Jere) ei ollut aikaa tehd sit paremmaksi. Ehdot-
   han pakottivat vain hakuun, ei ehtoihin ollenkaan, joten tm on parempi
   kuin ei mitn, vai?

K. Ohjelma kaatuu RunTime-Erroriin, mit tapahtui?
V. Ilmeisesti jokin asia on mrtty vrin. Ehkp nimikirjaimissa on kiellet-
   tyj merkkej tai jotain vastaavaa. Tmn EI pitisi olla vakavaa, mutta ota
   ihmeess yhteys tekijn, mikli jokin ei toimi!

K. Olen fanaattinen Windows-fani, enk tykk yhtn lopussa olevista Windows-
   vitseist. Ota ne pois!?
V. Voit disabloida ne salaisella komentorivi-kytkimell. Se on
   '-RAKASTAN_WINDOWSIA'.. Kokeile, se toimii!

K. Minulla on Amiga-OS eik MBRead toimi, miss vika?
V. MBRead on IBM-PC:lle tehty ohjelma ja tarvitsee MS-DOS *YHTEENSOPIVAN*
   kyttjrjestelmn. Amiga-versio tulee mikli kaikki amigan omistajat muis-
   tavat tekij isoilla rahalahjoituksilla.

K. Voiko MBReadilla lukea monia eri listatiedostoja ilman eri indeksointeja
   siin vliss?
V. Kyll voi. Joko mrt uudet IDX-hakemistot ja listat komentoriviss tai
   sitten kytt MBReadin mukana levitettv ohjelmaa MultiMB joka on tehty
   juuri thn tarkoitukseen ja sen mukana tulee omat ohjeet.

K. Olen jo kyllstynyt nihin kysymyksiin vastauksineen.. Mit teen nyt?
V. Noh onneksesi olet pssyt viimeiseen kohtaan joten voit jatkaa eteenpin
   seuraaviin artikkeleihin.. :)

                                  *  *  *

 [9] Tausta tarina
-------------------
Tss on MBReadin tausta, eli mist se lhti ja miten se eteni ja mit ongelmia
matkalla oli. MBRead on siis MBNet-nimisen BBS jrjestelmn (MikroBitti-lehden
yllpitm) jrjestm kilpailu, jossa piti tehd juuri tllainen tiedostolis-
tan "etlukija". Alussa oli luvassa vain mainetta ja kunniaa, joka myhemmin
kyll vaihtui. Aloitin MBReadin haasteena. Siit tuli ihan mukava, mutta PALJON
harmaita/punaisia hiuksia tuotti indexi-jrjestelm ja etsint, mutta nyt ne
ovat suunnilleen siin kunnossa ett niit kehtaa nytell. CD-koodit olivat jo
valmiina joten niihin ei tarvinnut paljoa aikaa tuhlata. Venepeli perustuu
joillekin lukion 1lk:n musiikin tunneille, jolloin ers kaverini ehdotti, ett
tekisin samanlaisen pelin TI-85-laskimelle. Siit sain saman idean PC:lle ja
tss se on, hiscoreineen. Jo alunperin halusin ett tm ohjelma toimii 8086-
koneella ja 400kb:ll muistia. Nyt sen pitisi olla juuri siin pisteess, ai-
nut "moka" on kovalevyn suuri tarve kun .LST/.NEW indeksoidaan, mutta tein sys-
teemin jonka ansiosta alkup. .LST/.NEW tiedostoa ei tarvita mikli se on jo in-
deksoitu ja indexi on kunnossa. Siin se suunnilleen olikin.. mitn muita suu-
rempia ongelmia ei ollut, ainoastaan joitain puutteita informoinnissa mutta
niist pstiin eroon muiden kilpailijoiden avustuksella. OS/2 versiota ei oli-
si tullut ilman henkil nimelt Timo Sirainen (SkyLinerin SysOp). Hn auttoi
minua suurimmaksi osaksi MBReadin kntmisess OS/2:lle. Loppu menikin aivan
kuin itsestn.. :)

                                  *  *  *

 [10] Teknist tietoa
----------------------
MBRead on kirjoitettu Borland Pascal 7.0:lla ja pakattu LZExe 0.91:lla
(tekijn Fabrice Bellard). MBRead ei hookkaa omia interrupteja ollenkaan ja
kytt konekielt vain CD- ja moniajo-rutiineissa. Stakki on asetettu 16384:n
tavuun. MBReadissa on 2 sisist bufferia, toinen on temppitiedoston read-ahead
bufferi ja toinen on itse pindeksin rivien read-ahead bufferi. Molempien koko
roikkuu siin 64kb:n paikkeilla. Mitn epstandardeja levynluku/kirjoitus-
hommia ei ole kytetty (kuten suoraa levyosoitusta). Joku saattaa protestoida
LZExe vastaan, mutta kun pakkaus on yli 50%, niin eik se kannata?-) OS/2
versio on taas tehty melkein heti kilpailun jlkeen, ja on knnetty Virtual
Pascalilla (kiitokset Timolle!). OS/2 versiossa ei ole kytetty mitn EXE:n
pakkaajaa, joten siit nette miten iso DOS versio olisi suunnilleen purettuna.
LZExe _EI_ ole cryptattu milln ohjelmalla, vaikka tm kvikin mieless.
Syyn se, ettei freewarea KANNATA, eik tm en vlttmtt toimisi niin
hyvin kuin nyt jos sellaista olisi kytetty.

                                  *  *  *

 [11] Kiitoksia ja tervehdyksi
--------------------------------
Kiitokset menevt seuraaville hepuille:
  Timo Sirainen   -- Helppi OS/2-version kanssa, testaus
  Olli Wiik       -- Testaus, Pari ideaa
  Juha Talikka    -- Pari ideaa
  Janne Nygrd    -- Pari ideaa lis
Terveiset menevt sitten nille: ("EiSittenMissnErikoisessa"-jrjestyksess)
  Teemu Kontkanen           Asko Soukka
  Simo Laakso               Tatu Pkkil
  Sampo Yrjninen          Olli Kakkonen
  Timi Tuohenmaa            Vin Ala-Hrknen
  Timo Saarinen             Olli Suorlahti
  Tero Viitala              Tarmo Toikkanen
  Jarmo Muukka              Jetro Lauha
 <Kaikille ohjelmoiville>

                                  *  *  *

.. Se siit sitten.. Voit kynnist MBReadin nyt.. :)

