Merge branch 'master' of ssh://svjatoslav.eu:10006/home/n0/git/qbasicapps

[qbasicapps.git] / automation / school clock / kell / juhend.org

diff --git a/automation/school clock/kell/juhend.org b/automation/school clock/kell/juhend.org
new file mode 100644 (file)
index 0000000..dcfe13c
--- /dev/null
+++ b/automation/school clock/kell/juhend.org
@@ -0,0 +1,119 @@
+
+Kooli Kell programmi kasutusjuhend
+
+- 2002.10
+- Svjatoslav Agejenko
+
+
+* Kasutajaliides
+Programm Kooli Kell on mõldud kella laskmiseks koolis, tundi sisse ja
+välja.  Samuti juhib programm arvuti küljes olevat liidest,
+kahekohaliste numbrite näitamiseks (minutid / tunnid), 3 klahvilist
+klaviatuuri ja releed.  Tundi sisse minev kell on 1 pikk ning 1 l”em
+helin. Väljaminev kell on 1 tavaline pikk helin. Programm loeb aega
+arvuti süsteemsest kellast.  Kella laskmis ajad on organiseeritud
+failidesse *.PP .  Aasta või päevaplaani muutmiseks tuleb redakteerida
+vastavaid faile. Programm valib sobiva päevaplaani lähtudes
+aastaplaanist, mis asub failis "aasta.ap" . Programmi saab kasutada
+arvutil millele on printeri pesasse (LPT1) ”endatud spetsiaalne
+liides, liidese skeem on failis "skeem.bmp". Liides omab kolme
+nummerdatud nuppu paigutusega:
+
+#+BEGIN_VERSE
+        <1>   <2>
+           <3>
+#+END_VERSE
+
+Programm on ettenähtud iseseisvalt töötama, kuid on ka võimalus
+erandkorras kгitsi kella lasta, aega muuta jne.. Programm eristab
+tavalisi nupuvajutusi ja topeltklõpse. Eesmärgiga suurendada
+funktsionaalsust väheste nuppudega.
+
+** Nuppude funktsioonid peamenüüs:
+
++ <1> klõps :: laseb kella tundi sisse
++ <1> topeltklõps :: laseb kella tunnist välja
+
++ <2> klõps :: läheb aja muutmis menüüsse
++ <3> topeltklõps :: hakkab tööle uuendatud graafikuga, vajalik pвast
+     sisendfailide redigeerimist.
+
++ <3> klõps :: ümardab süsteemse aja täistunnini, vajalik aja
+               sünkroniseerimiseks.
++ <3> topeltklõps :: laeb süsteemse: aasta, kuu, päeva, tunnid,
+     minutid failist "sync.txt"
+
+** Nuppude funktsioonid aja muutmis menüüs:
+
++ <1> klõps :: vähendab süsteemsed tunnid/minutid 1. võrra
+
++ <2> klõps :: suurendab süsteemsed tunnid/minutid 1. võrra
+
++ <3> klõps :: valib näitamiseks ja redigeerimiseks tunnid või minutid.
++ <3> topeltklõps :: läheb tagasi peamenüüsse.
+
+Aja muutmis menüüd tunneb ära selle järgi et indikaator tunnid või
+minutid vilgub, mitte ei põle nagu peamenüüs.
+
+
+* Faili AASTA.AP formaat: (aastaplaan)
+: v       <kuu>-<päev>     <kuu>-<päev>     <päevaplaan>
+
+Sõnast aja vahemik. Paneb paika päevaplaani antud
+ajavahemikus. Esimene daatum peab kindlasti olema väiksem kui
+teine. St. kui on tõesti vaja:
+
+: v       10-4    2-1     eri
+
+tuleb kirjutada:
+
+: v       10-4    12-31   eri
+: v       1-1     2-1     eri
+
+Päevaplaan kehtib vahemiku esimesest päevast kuni vahemiku viimase
+päevani.
+
+
+: n       <kuu>-<päev>     <kuu>-<päev>     <nädalapäev>      <päevaplaan>
+
+Sõnast nädalapäv. sama mis "v" kuid: paneb paika päevaplaani antud
+ajavahemikus, antud nädalapäeval. Nädalapäeva kirjeldatakse numbriga.
+nädala esimene päev on esmaspäev, talle vastab number 1.
+
+
+: e       <kuu>-<päev> <päevaplaan>
+
+Sõnast eriline. Paneb paika antud kuupävale antud pävaplaani. Sobib
+hästi erakorraliste lüendatud või muul moel muudetud päevaplaanide
+kehtestamiseks. Näiteks riigipühad, spordipäev jne.
+
+Kui teatud päeva kohta ei käinud ühtegi kirjet siis toimib vaikimisi
+"tuhi" päevaplaan. Kui teatud päeva kohta käis mitu kirjet siis jääb
+peale viimane.
+
+
+
+* Failide *.PP formaat: (päevaplaanid)
+: # <tund>:<minut>  <kell>
+
+Laseb antud ajal antud kella. Võimalikud kella helinad on:
+
+| kella kood | vastav helin       |
+|------------+--------------------|
+| sis        | kell tundi sisse   |
+| val        | kell tunnist välja |
+
+* Faili SYNC.TXT formaat:
+faili esimesel kahel real peab olema järgnev:
+
+: KK-PP-AAAA
+: TT:MM
+
+kus:
+| kood | tähendus |
+|------+----------|
+| KK   | kuu      |
+| PP   | päev     |
+| AAAA | aasta    |
+| TT   | tunnid   |
+| MM   | minutid  |