******************
*** Zdzich 4 ***
*** PODRECZNIK ***
******************

Spis tresci:
------------
1. Wstep
2. Jak pisac programy w jezyku Zdzich?
3. Zmienne, stale i etykiety
4. Dyrektywy
5. Bledy
5.1. Spis bledow
6. Edytor Zdzicha
7. Konwersja polskich liter


1. Wstep:
---------
Zdzich jest jezykiem programowania przeznaczonym zarowno dla
poczatkujacych, jak i - dzieki mozliwosci uzywania niektorych
polecen Asemblera - dla bardziej zaawansowanych. Kompilacji
pliku z programem dokonuje sie poprzez uruchomienie kompilatora
ZD.EXE z parametrem okreslajacym nazwe pliku.

2. Jak pisac programy w jezyku Zdzich?
--------------------------------------
Jezyk Zdzich oferuje zestaw polecen, za pomoca ktorych mozna
napisac prosty program. Mozna je wpisywac z polskimi literami
Mazowia (do Zdzicha dolaczone sa odpowiednie programy do ich
instalacji) lub bez polskich liter. Oprocz polecen takich jak
PISZ,CZYSC, czy KONIEC, ktorych znaczenie latwo zrozumiec nawet
poczatkujacemu programiscie, wystepuja tez takie, jak
PRZERWANIE, LADUJ, USTAW, itp. Sa to komendy uzywane do pisania
bardziej zlozonych programow i nie potrzeba znac ich znaczenia,
zeby napisac wlasny.

Liczby mozna wpisywac w systemie dziesiatkowym
lub szesnastkowym (poprzedzone wtedy znakiem "$"),
przykladowo:

AH=10
BH=$1C prawidlowo

CH=1010101011b
AX=0x001C nieprawidlowo
SI=1Ah

Polecenia powinny zawierac sie w jednej linii, np.
Taka konstrukcja:

PISZ To jest linia 1,
a to linia 2

Jest niepoprawna.
Zamiast tego, powinno sie napisac:

PISZL To jest linia 1,
PISZ a to linia 2

Tresc przykladowego programu, napisanego z uzyciem
tylko podstawowych funkcji, moze wygladac tak:

CZYSC 53
POZYCJA 35,17
PISZ Nacisnij dowolny klawisz...
KLAWISZ
CZYSC
KONIEC

Powyzszy program po skompilowaniu, to znaczy po stworzeniu z
niego za pomoca programu ZD.EXE pliku typu .COM i uruchomieniu,
spowoduje wyczyszczenie ekranu kolorem czerwonym i wypisanie
tekstu "Nacisnij dowolny klawisz". Po nacisnieciu klawisza
ekran odzyska normalna barwe i program skonczy dzialanie.

CZYSC 53
POZYCJA 35,17
PISZ Nacisnij klawisz ENTER
:Petla
KLAWISZ
POROWNAJ AL,13
<>SKOK :Petla
CZYSC
KONIEC

Aby zrozumiec ten program,trzeba juz wiedziec, co znacza litery
"AL". Jest to rejestr procesora, czyli miejsce, gdzie mozna
przechowywac dane (liczbe). Rejestrow podstawowych jest 14:

AL,AH,BL,BH,CL,CH,DL,DH,AX,BX,CX,DX,SI i DI.

Poza tym istnieja jeszcze takie rejestry, jak SP,BP,CS,DS,ES i
IP, jednak sluza one do innych celow i nie da sie ich uzyc w
jezyku Zdzich. Liczby, ktore mozna przechowywac w rejestrach
dziela sie na bajty, czyli liczby naturalne od 0-255 i slowa -
- liczby naturalne od 0-65535.
W rejestrach zakonczonych na L lub H mozna przechowywac bajty,
w pozostalych slowa. Jednak rejestry, ktorych poczatkiem jest
taka sama litera, tworza jedna calosc:

AX = 256*AH + AL

Rejestr AH jest tutaj starszym bajtem, a AL - analogicznie -
- mlodszym bajtem.


3. Zmienne, stale i etykiety:
-----------------------------
ZDZICH umozliwia stosowanie zmiennych tekstowych, badz
liczbowych. Zmienne nalezy zdefiniowac na poczatku programu
przez wpisanie polecenia:

Zmienna $xxxx - dla zmiennych tekstowych
Zmienna %xxxx - dla zmiennych liczbowych 0-65535 (slowo)
lub Zmienna &xxxx - dla zmiennych liczbowych 0-255 (bajt)

Nazwy zmiennych moga miec do 25 znakow dlugosci,
wlaczajac znak $, % lub &.

Stale tym sie roznia od etykiet,ze maja przez caly czas trwania
programu ustalona wartosc, ktorej nie mozna zmienic. Stale
definiuje sie:

Stala $xxxx=yyyy
Stala %xxxx=yyyy
lub Stala &xxxx=yyyy

Zmienne i stale tekstowe moga zawierac teksty o dlugosci do 254
bajtow,liczbowe (%xxxx) - liczby od 0 do 65535, natomiast licz-
bowe (&xxxx) - od 0 do 255.

W programie moga byc tez uzyte etykiety, wskazujace okreslone
miejsce w programie. Do przemieszczania sie do roznych etykiet
sluza polecenia:

SKOK, &SKOK, <>SKOK, SKOK, <&SKOK, >&SKOK,

ktore powoduja skok w zaleznosci od spelnionych warunkow.
Etykiety zaczynaja sie znakiem ":" i moga miec -tak jak zmienne
- 25 znakow, wlaczajac znak :.

4. Dyrektywy:
-------------
Dyrektywy sa to polecenia, ktore nic nie wykonuja w programie,
tylko przekazuja kompilatorowi wskazowki odnosnie kompilowania
pliku. Dyrektywy zaczynaja sie znakiem "#".
Dyrektywa #WSTAW powoduje wstawienie kodu z innego pliku do
kompilowanego programu.

5. Bledy:
---------
Podczas kompilacji blad (sygnalizowany przez program) moze
wystapic, jesli wpisze sie bledna komende lub niewlasciwy
parametr.

Program informuje nas o miejscu popelnienia bledu poprzez
podanie nazwy blednego polecenia badz parametru.

5.1. Spis bledow:
-----------------

Patrz plik BLEDY.TXT

6. Edytor Zdzicha:
------------------
Zdzich od wersji 3a wyposazony jest w prosty edytor.Program ten
uruchamia sie poleceniem ZDZICH.EXE koniecznie z tego samego
katalogu, co plik ZD.EXE. Umozliwia on edycje programow i ich
kompilacje (na razie bez uruchamiania, do tego trzeba uruchomic
DOS poleceniem DOS z menu Plik).

7. Konwersja polskich liter:
----------------------------
Do Zdzicha dolaczony jest programik, umozliwiajacy konwersje
polskich liter w roznych formatach. Najnowsza wersja obsluguje
Mazowie, Latin II,Strone 1250, ISO 8859-2 (ISO Latin) i Bez PL.
Programu tego mozna uzywac do zamiany liter w pisanych przez
siebie programach na format Windows ( CP 1250 ), Mazowia lub
Bez PL, rozpoznawany przez kompilator Zdzicha.