gitweb on Svarog

projekti pod git sistemom za održavanje verzija -- projects under the git version control system
skripta verzija 14c
[spa1skripta-public.git] / xds-uputstvo.tex
1 \section{Native XDS Modula 2 -- kratko uputstvo}
4 Ovo uputstvo ukratko pokriva kako se može nabaviti XDS Modula 2 za Windows
5 sistem, njenu instalaciju, te kako napraviti i pokretnuti jednostavan program.
7 \subsection*{Dobavljanje instalacije}
10 Native XDS Modula 2 se može besplatno skinuti sa sajta proizvođača,
11 tačnije na adresi:\\
12 \url{http://www.excelsior-usa.com/xdsdl.html}
14 Prvo se prikazuje ugovor o korišćenju koji na dnu treba potvrditi da ste
15 razumeli i da ćete ga se pridržavati.
17 Na stranici koja se potom otvara je potrebno odabrati ``XDS 2.6 beta 2
18 for Windows'' i snimiti je na računar.
20 \subsection*{Instalacija okruženja}
22 Osnovno okruženje (xds-x86...) se instalira pokretanjem prethodno pomenute
23 instalacione arhive.
25 \emph{Korisnicima Windows-a 7 preporučujemo da pokrenu instalacione
26 pakete pomoću opcije ``Run as administrator'' do koje se stiže desnim
27 klikom miša.}
29 Pretpostavićemo u daljem tekstu da je program instaliran u
30 \kod{C:/XDS/}
32 \subsection*{Pokretanje okruženja}
34 Po uspešnoj instalaciji bi trebalo da postoji ikonica na desktopu, kao
35 i grupa sa programom u start meniju.
37 Ukoliko iz bilo kakvog razloga ne postoje odgovarajuće prečice,
38 okruženje se može pokrenuti uz pomoć izvršnog fajla
39 \kod{C:/XDS/BIN/xds.exe} (ako je instalirano na podrazumevanoj
40 lokaciji).
42 \subsection*{Prvi projekat}
44 Da bismo mogli da pišemo i pokrećemo svoj program, potrebno je prvo
45 napraviti projekat za njega, što se radi na sledeći način:
47 \begin{itemize}
49 \item
50 Iz menija se odabere Project->New.
51 \item U dijalogu se klikne na gornje dugme ``Browse'', odabere se putanja gde
52 će se kreirati projekat i ukuca se ime novog projekta.
54 \item U drugom polju ``Template'' ne treba da piše ništa. Ukoliko
55 postoji neki tekst, obrisati ga.
57 \item Kliknuti na ``OK''
59 \item Iskočiće dijalog na kome piše da ne postoji fajl za editovanje,
60 kliknuti na ``OK'' da se on napravi.
62 \item Pojavljuje se forma za kucanje programa, ukucati (na primer):
64 \begin{minipage}{\columnwidth}
65 \begin{lstlisting}[style=codeblock]
66 MODULE Hello;
67 FROM InOut IMPORT WriteString,WriteLn;
68 BEGIN
69 WriteString("Hello World");
70 WriteLn;
71 END Hello.
72 \end{lstlisting}
73 \end{minipage}
75 \item Program se može pokrenuti na različite načine, pri čemu se
76 automatski prevodi:
78 \begin{itemize}
80 \item Klik na ``Run'' ikonicu u toolbaru (plavi čovečuljak koji trči)
82 \item Meni Debug->Run
84 \item Prečica Ctrl+F9 na tastaturi
86 \end{itemize}
88 \item Ako je sve u redu sa programom, treba da se pojavi novi terminal
89 u kome se ispisuje rezultat izvršavanja programa, u našem slučaju
90 jednostavna pozdravna poruka.
91 \end{itemize}
93 Naravno moguće je i samo prevesti (kompajlirati) program, tako da se
94 samo prikažu greške (ako ih ima) i bez pokretanja programa:
95 \begin{itemize}
96 \item Klik na ``Compile'' ikonicu u toolbaru
97 \item Meni Tools->Compile
98 \item Prečica F9 na tastaturi
99 \end{itemize}
101 Ukoliko u programu postoje greške, on neće biti pokrenut, već će se
102 dobiti lista grešaka u donjem delu prozora. Na primer ako obrišemo ``S''
103 u četvrtom redu i probamo da pokrenemo program, taj red će biti
104 označen svetlo plavom bojom i dobićemo poruku:
106 \kod{- Error in pro1.mod [4:5]: Undeclared identifier "Writeting"}
108 Što znači da u četvrtom redu, kod petog karatkera postoji problem, da
109 identifikator nije deklarisan, što najčešće znači da ga nismo uvezli,
110 ili, kao u našem slučaju, da smo napravili grešku u kucanju.
112 Stvar na koju isto treba obratiti pažnju je da se nekad greška
113 prijavljue nešto kasnije u tekstu nego što je napravljena. Na primer,
114 ako obrišemo ``;'' na kraju četvrtog reda i probamo da pokrenemo
115 program, peti red će biti označen svetlo plavom bojom i dobićemo
116 poruku:
118 \kod{- Error in pro1.mod [5:5]: Expected symbol ";" }
120 Ovo se desilo jer nedostaje tačka zarez na kraju četvrtog reda, ali će
121 kompajler probati da je traži i dalje, pa će tek na početku petog reda
122 prijaviti grešku.
124 U spisku se takođe pojavljuje i upozorenje (Warning) o tome da se
125 uvezena komanda WriteString ne koristi nigde u programu. Često se
126 upozorenja mogu ignorisati, a pažnju uglavnom treba obraćati na
127 greške, odnosno poruke koje počinju sa ``Error''.
129 Takođe se često dešava da su druge prijavljene greške posledica prve,
130 te je poželjno ponovo kompajlirati (ili pokretati) program posle svake
131 ispravljene greške.
133 \paragraph{Napomena o template-ovima pri kreiranju projekta:}
134 Moguće je namestiti da u dijalogu za novi projekat drugo polje ``Template''
135 uvek bude prazno. Potrebno je u tom istom dijalogu kliknuti na
136 ``Configure'', a potom isprazniti polje ``default template''.
138 \subsection{Mogući problemi}
140 \subsubsection*{Nedostajući sistemski moduli}
142 Verzije pre 2.6 nisu imale uključene u glavni paket sve module koji se
143 koriste u okviru kursa, i bilo je neophodno da se dodatno instalira i
144 ``Top Speed Compatibility Pack'' (tscp-x86...). Bez njega je kompajler
145 prijavljivao da ne postoje neki moduli - najčešće je problem bio da
146 nedostaje \kod{FIO} modul.
148 \subsubsection*{Problemi u pokretanju - nemoguće naći exe}
150 Ako pri pokušaju kompajliranja/pokretanja programa kompajler prijavi
151 da ne može da nađe exe i pri tome prijavljuje kraću putanju od one
152 koja je stvarno u pitanju, obično se radi o tome da je postojao razmak
153 u okviru putanje do modula. Npr ``C:\textbackslash Moj prvi program''
154 će prouzrokovati probleme, a kompajler će prijaviti da ne može da nađe
155 ``C:\textbackslash Moj''.
157 Ovo je nažalost problem okruženja i dok se ne ispravi u nekoj budućoj
158 verziji ne može se zaobići, tako da je jedino rešenje premestiti
159 fajlove, odnosno ako je moguće preimenovati problematične foldere.
Svarog.pmf.uns.ac.rs/gitweb maintanance Doni Pracner