ILMAINEN

  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ
                            SF-KALENTERI v1.95
  ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

                        (C)1991-95 Rasmus Wickholm

           ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
           ³                                                   ³
           ³  T„t„ ohjelmaa saat vapaasti levitt„„, kunhan     ³
           ³  noudatat seuraavia ohjeita:                      ³
           ³                                                   ³
           ³    1) Et mill„„n tavalla muuta ohjelmaa tai       ³
           ³       sen mukana tulleita tiedostoja.             ³
           ³                                                   ³
           ³    2) Kopioit aina my”s kaikki ohjelman mukana    ³
           ³       tulleet ohjeet.                             ³
           ³                                                   ³
           ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ



SISŽLLYS

  1  Mik„ se on?
  2  Mit„ sill„ tehd„„n?
  3  Miten se k„ynnistet„„n?
  4  Kalenterin merkinn„t
       4.1  Kalenteriruudukko
       4.2  Erikoism„„reet
       4.3  P„iv„m„„r„
       4.4  Liputusp„iv„t
  5  Kalenterissa liikkuminen
       5.1  Yksinkertainen liikkuminen
       5.2  Haluttuun p„iv„m„„r„„n siirtyminen
       5.3  Kiinalainen kalenteri ja liikkuminen vuositasolla
       5.4  Kohdistimen sijainnin merkitseminen/Merkittyyn kohtaan siirtyminen
  6  Tietojen etsint„
       6.1  Etsinn„n suunta
       6.2  Etsinn„n aikarajat
       6.3  Etsinn„n keskeytys
       6.4  Nimip„iv„t
       6.5  Merkki- ja juhlap„iv„t
       6.6  Liputusp„iv„t
       6.7  Etsinn„n toisto
  7  Muut toiminnot
       7.1  Ohjeet
       7.2  Merkki- ja juhlap„ivien selitykset
       7.3  Ohjelmasta poistuminen
  8  Ohjelman toteutus
       8.1  Juhlap„ivi„ k„sittelev„t tietol„hteet
       8.2  Matemaattiset kaavat
  9  Vastuunrajoitus



1 - MIKŽ SE ON?

      SF-Kalenteri on suomalainen kalenteriohjelma. Se osaa suomalaiset
      juhlapyh„t (kolmea vuosittain vahvistettavaa rukoussunnuntaita
      lukuunottamatta), sek„ liputusp„iv„t ja erin„isi„ merkkip„ivi„.
      Ohjelma osaa laskea kalenterin vuosille 1980-2099.

      Koska monikaan suomalainen ei tied„, miten juhlap„iviemme vietto on
      saanut alkunsa tai miksi niit„ oikeastaan vietet„„n, on ohjelmaan
      lis„tty jokaisen merkkip„iv„n yhteyteen pieni selitys, joka kertoo
      hiukan p„iv„n historiasta ja/tai vietosta. Lis„ksi ohjelma taitaa
      suomenkieliset nimip„iv„t.


2 - MITŽ SILLŽ TEHDŽŽN?

      Ohjelma ei pyri korvaamaan paperille painettua kalenteria, johon
      SF-Kalenterista poiketen voi tehd„ muistiinpanoja. SF-Kalenteri
      ei sis„ll„ t„htitieteellisi„ tietoja.

      SF-Kalenteri on pikemminkin niihin tilanteisiin, joihin tavallinen
      kalenteri ei riit„, esim. kun suunnittelee jotakin monta vuotta
      etuk„teen, eik„ tarvittavia kalentereita viel„ ole julkaistu.
      My”s tietojen etsiminen ja tutkiminen on helpompaa ohjelman avulla.

      Voit esim. selvitt„„ min„ viikonp„iv„n„ vuosien p„„st„ j„rjes-
      tett„v„ luokkakokous on, onko 1.1.2000 perjantai, mitk„ seuraavat
      liputusp„iv„t ovat, milloin Heikill„ on seuraavan kerran nimip„iv„,
      tai miten p„„si„inen sijoittuu tulevina vuosina.


3 - MITEN SE KŽYNNISTETŽŽN?

      Ohjelma k„ynnistet„„n ajamalla KAL.EXE -niminen tiedosto. Jos
      koneen kello on oikeassa ajassa, ilmestyy kuluvan kuukauden
      kalenterilehti, jossa kohdistin on kuluvan p„iv„n kohdalla.

      Ohjelma on merkkipohjainen, ja tunnistaa automaattisesti onko
      k„yt”ss„ v„ri- vai mustavalkon„ytt”. Automaattisen tunnistuksen
      voi sivuuttaa antamalla ohjelmaa k„ynnistett„ess„ komentorivill„
      parametrit:

      /v„ri     (/v riitt„„), jolloin ohjelma k„ynnistyy v„ritilassa.
      /mv       (/m riitt„„), jolloin ohjelma k„ynnistyy yksiv„ritilassa.
      /ei       (/e riitt„„), jolloin ohjelma ei muuta n„yt”n tilaa


4 - KALENTERIN MERKINNŽT

4.1  Kalenteriruudukko

      Kalenteriin on merkitty pyh„p„iv„t punaisella (yksiv„rin„yt”ll„
      alleviivattuina) ja arkip„iv„t sinisell„ (yksiv„rin„yt”ll„ normaa-
      lilla tekstill„). Kohdistin on merkitty vihre„ll„ (yksiv„rin„yt”ll„
      k„„nteisell„) v„rill„.

      Viikonp„iv„t k„yv„t ilmi kalenteriruudukon yl„- ja alapuolelle
      sijoitetuista kaksikirjaimisista lyhenteist„ (ma, ti, ...)


4.2  Erikoism„„reet

      Ruudun ylimm„ll„ rivill„ n„kyv„t kuukausi ja vuosi, sek„
      mahdollisesti M-kirjain vuosiluvun per„ss„ muistuttamassa siit„,
      ett„ jokin kohta kalenterissa on merkitty sarkainn„pp„imell„
      (ks. 5.4.).

      Samanv„risell„ rivill„ alempana ruudulla n„kyv„t p„iv„n erikois-
      m„„reet, kuten esim. Žitienp„iv„ tai Runebergin p„iv„.


4.3  P„iv„m„„r„

      P„iv„n erikoism„„reiden alapuolella on viikonp„iv„n nimi, sek„
      p„iv„m„„r„ numeroin. Lukujen merkitys on aina j„rjestykselt„„n:
      p„iv„, kuukausi, vuosi. N„iden alapuolella on viel„ kyseisen
      p„iv„n nimip„iv„sankareiden nimet.


4.4  Liputusp„iv„t

      Kun kyseess„ on liputusp„iv„, ilmestyy ruudun oikeaan alakulmaan
      Suomen lipun kuva. Lipun edess„ on my”s liputusp„iv„n luonteesta
      riippuen joko teksti "Virallinen" tai "Vakiintunut".


5 - KALENTERISSA LIIKKUMINEN

      Ohjausn„pp„imet selitet„„n ohjetekstiss„, jonka saa esiin
      [F1]-n„pp„imell„. Seuraavaksi hiukan seikkaper„isemm„t
      k„ytt”ohjeet:


5.1  Yksinkertainen kalenterissa liikkuminen
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ Kohdistin oikealle.....siirry p„iv„ eteenp„in     ³
       ³ Kohdistin vasemmalle...siirry p„iv„ taaksep„in    ³
       ³ Kohdistin alas.........siirry viikko eteenp„in    ³
       ³ Kohdistin yl”s.........siirry viikko taaksep„in   ³
       ³                                                   ³
       ³ PageDown...............siirry kuukausi eteenp„in  ³
       ³ PageUp.................siirry kuukausi taaksep„in ³
       ³ Ctrl-PageDown..........siirry vuosi eteenp„in     ³
       ³ Ctrl-PageUp............siirry vuosi taaksep„in    ³
       ³ Home...................siirry kuluvaan p„iv„„n    ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


5.2  Haluttuun p„iv„m„„r„„n siirtyminen

      Haluttuun p„iv„m„„r„„n siirtyminen on SF-Kalenterissa helppoa:
      kirjoitat p„iv„m„„r„n n„pp„imist”lt„!

      Kirjoittaessasi ensimm„isen numeron ilmestyy n„yt”lle automaat-
      tisesti sy”tt”rivi, jolla tarpeen tullessa voit korjailla kirjoitus-
      virheit„si normaalein muokkausn„pp„imin. Mik„li vahingossa avaat
      sy”tt”rivin, p„„set siit„ pois sy”tt„m„ll„ tyhj„n rivin tai paina-
      malla [Esc]-n„pp„int„.

      SF-Kalenterin tulkitsemien lukujen merkitys on aina j„rjestyksess„:
      p„iv„, kuukausi, vuosi. Kaikkia n„it„ ei ole pakko sy”tt„„, vaan
      parametreja saa j„tt„„ pois oikealta lukien. Jokainen luku on
      erotettava jollakin ei-numero-merkill„, esim. pisteell„ (14.4)
      tai viivalla (01-01-1988). Kun haluttu p„iv„m„„r„ on sy”tetty,
      painetaan rivinvaihtoa (Enter, CR, <Ù).

      Vuosiluvuista saa j„tt„„ pois vuosisataa ilmaisevat kaksi
      ensimm„ist„ numeroa, jolloin luvut tulkitaan seuraavasti:

                     80..99  ->  1980..1999
                     00..79  ->  2000..2079

      Kuukaudet voidaan sy”tt„„ my”s kirjaimin, jolloin v„limerkkej„
      ei tarvita (kirjaimethan eiv„t ole numeroita). T„ll”in tulee
      kirjoittaa v„hint„„n kolme ensimm„ist„ kirjainta kuukauden
      suomenkielisest„ nimest„, muutoin ohjelma ei voisi luotettavasti
      erottaa esim. marraskuuta ja maaliskuuta toisistaan.

      Ohjelma hyv„ksyy ainoastaan todellisia p„iv„m„„ri„ v„lilt„
      1.1.1980 ja 31.12.2099. T„ss„ esimerkkej„ hyv„ksytt„vist„
      p„iv„m„„rist„:

      01-01-1989         on  1. 1.1989
      24.12 -92          on 24.12.1992
      12 3 2             on 12. 3.2002
      3/4 '94            on  3. 4.1994
      6jouluk            on  6.12.

      Mik„li sy”tetty p„iv„m„„r„ on virheellinen, ohjelma ei hyv„ksy
      p„iv„m„„r„„, vaan ilmoittaa miss„ osassa vika on, ja antaa
      k„ytt„j„lle mahdollisuuden korjata virheen.

      HUOM!  Muokkain on automaattisesti lis„ystilassa (Insert-mode).
             Jos sy”tt”ruutu on jo t„ynn„ teksti„, ei siihen en„„ saa
             sy”tetty„ korjauksia ennen kuin on siirtynyt korvaustilaan
             painamalla [Insert]-n„pp„int„.


5.3  Kiinalainen kalenteri ja liikkuminen vuositasolla

      Ohjelmalla on mahdollista tutkia kalenteria my”s vuositasolla,
      painamalla:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ Insert.................siirry vuositasolle ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

      Vuositasolla voit siirty„ kalenterissa vuoden harppauksin ja
      n„et yhdell„ silm„yksell„ mitk„ vuodet ovat karkausvuosia. Ne
      ovat merkittyj„ vuosiluvun eteen sijoitetulla pienell„ pisteell„.
      Vuosiluvun per„ss„ on my”s kiinalaisen kalenterin vuosien nimet.

      Vuositasolla toimivat seuraavat ohjausn„pp„imet:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ Kohdistin alas.........siirry vuosi eteenp„in  ³
       ³ Kohdistin yl”s.........siirry vuosi taaksep„in ³
       ³ Enter (CR, <Ù).........palaa kalenterisivulle  ³
       ³ Esc....................palaa kalenterisivulle  ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


5.4  Kohdistimen sijainnin merkitseminen/Merkittyyn kohtaan siirtyminen

      Joskus voi olla tarpeen merkit„ tietty paikka kalenterissa,
      esim. jos suorittaa useita etsint”j„ (ks. 6.7) ja haluaa aina
      aloittaa ne samasta paikasta.

      Sarkainn„pp„imell„ (tabulaattori) on helppo merkit„ tietty paikka
      kalenterissa, ja my”hemmin palata samaan paikkaan painamalla toista-
      miseen sarkainn„pp„int„. Kun tietty kohta on merkitty, muistutetaan
      siit„ ruudun ylimm„ll„ rivill„ M-kirjaimella (ks. 4.2.).


6 - TIETOJEN ETSINTŽ

      SF-Kalenterin k„tevin ominaisuus on mahdollisuus nopeasti ja
      helposti hakea merkkip„ivi„. Tietojen etsint„„n siirryt„„n
      painamalla mit„ tahansa kirjann„pp„int„ A:n ja ™:n v„lilt„.

      Kun kirjoitat ensimm„isen kirjaimen, ilmestyy n„yt”lle kentt„,
      johon kirjoitat etsitt„v„n tiedon. Voit korjailla kirjoitus-
      virheit„si tutuilla muokkausn„pp„imill„. Mik„li vahingossa avaat
      sy”tt”rivin, p„„set siit„ pois sy”tt„m„ll„ tyhj„n rivin tai paina-
      malla [ESC]-n„pp„int„.


6.1  Etsinn„n suunta

      Tietojen etsint„ suoritetaan oletusarvoisesti aina kohdistimen
      osoittamasta p„iv„st„ eteenp„in, mutta etsint„suunnan voi
      my”s erikseen m„„ritell„ kirjoittamalla etsint„tekstin viimei-
      seksi merkiksi miinuksen, jolloin etsint„ suoritetaan taaksep„in,
      tai plussan, jolloin etsint„ suoritetaan eteenp„in. Etsint„suuntaa
      voi my”s muuttaa etsinn„n toiston yhteydess„ (ks. 6.7.).


6.2  Etsinn„n aikarajat

      Etsint„ suoritetaan 1.1.1980-31.12.2099 aikav„lill„. Mik„li
      etsint„ jatkuu tuloksemattomana n„iden rajojen ulkopuolelle,
      se keskeytyy.


6.3  Etsinn„n keskeytys

      Kun etsint„ on k„ynniss„, voi sen keskeytt„„ painamalla
      mit„ tahansa n„pp„int„.


6.4  Nimip„iv„t

      Nimip„ivi„ etsitt„ess„ on muistettava kirjoittaa nimen ensimm„inen
      kirjain isolla kirjaimella, muita kommervenkkej„ ei tarvitse muistaa.

      Etsitt„v„n merkkijonon ei kuitenkaan aina v„ltt„m„tt„ tarvitse alkaa
      isolla kirjaimella, vaan nimest„ saa my”s kirjoittaa vain osan. T„ten
      esim. "ker" l”yt„„ Inkerin, mutta "Ker" Kerkon, Kertun ja Kerttulin.


6.5  Merkki- ja juhlap„iv„t

      Merkki- ja juhlap„ivi„ etsitt„ess„ pit„„ p„iv„n nimest„ kirjoittaa
      niin monta merkki„, ett„ se erottuu nimip„ivist„. Eli, jos esim.
      etsit juhannusp„iv„„, ei riit„, ett„ kirjoitat "Juha" (seh„n on
      nimi), vaan joudut kirjoittamaan v„hint„„nkin "Juhann".


6.6  Liputusp„iv„t

      Liputusp„ivien etsint„„n on ohjelmassa pari erikoismerkint„„,
      jotka sy”tet„„n normaalin etsint„tekstin tapaan sy”tt”riville:

      Liputus        etsii liputusp„iv„t
      Vakiintunut    etsii vakiintuneet liputusp„iv„t
      Virallinen     etsii viralliset liputusp„iv„t


6.7  Etsinn„n toisto

      Kun etsitt„v„ teksti kerran on sy”tetty, voidaan etsint„ toistaa
      painamalla:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ +......................etsi seuraava eteenp„in                   ³
       ³ -......................etsi seuraava taaksep„in                  ³
       ³ Ctrl+L.................etsi seuraava („l„ muuta etsinn„n suuntaa)³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

      Etsint„ keskeytyy, kun SF-kalenterin ymm„rt„m„ aikav„li on
      etsitty (ks. 6.2.).


7 - MUUT TOIMINNOT

7.1  Ohjeet

      Ohjausn„pp„imet selitet„„n ohjeissa, jotka saa esille
      painamalla:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ F1.....................n„yt„ ohjeteksti ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


7.2  Merkki- ja juhlap„ivien selitykset

      Mik„li kohdistimen osoittamalla p„iv„ll„ on erikoism„„reit„, kuten
      esim. "Žitienp„iv„" tai "Jouluaatto", saa p„iv„n historiasta ja
      vietosta lyhyehk”n selityksen painamalla:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ Enter (CR, <Ù).........n„yt„ merkki- ja juhlap„iv„n selitys ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

      Mik„li p„iv„ on liputusp„iv„, n„ytt„„ ohjelma my”s yleiset
      liputusohjeet.


7.3  Ohjelmasta poistuminen

      SF-Kalenterista poistutaan painamalla:
       ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
       ³ Esc....................poistu ohjelmasta ³
       ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


8 - OHJELMAN TOTEUTUS

8.1  Juhlap„ivi„ k„sittelev„t tietol„hteet

      Juhlap„ivien taustoja koskevat tiedot ovat per„isin mm.
      suomalaisten kustantajien eri tietosanakirjoista. Eniten
      apua oli kirjasta, johon jokaisen lis„„ tietoa janoavan
      kannattaa tutustua:

           Uusi Ajantieto         Sirpa Karjalainen
           WSOY, Porvoo 1989      Teppo Korhonen
           ISBN 951-0-15901-8     J.U.E. Lehtonen


8.2  Matemaattiset kaavat

      Ohjelman matemaattiset kaavat ovat p„„osin ohjelman julkaisijan
      k„sialaa, mutta p„„si„isp„iv„n laskemisessa ohjelma k„ytt„„ englanti-
      laisen T. H. O'Beirnen vuonna 1966 kehitt„m„„ algoritmia. Kiinnostu-
      neet saavat tarvittaessa tarkempaa tietoa algoritmista kirjoittamalla
      ohjelman tekij„lle.


9 - VASTUUNRAJOITUS

      Ohjelma on testattu ja toimivaksi todettu. Ohjelman tekij„ ei
      kuitenkaan ole vastuussa mahdollisista ohjelman k„yt”st„ johtuvista
      haitoista, eik„ ole velvollinen korjaamaan tai p„ivitt„m„„n ohjelmaa.
      SF-Kalenteri v1.95 on julkaistu 1.8.1995.