Ijjas István - Kiss Guba Ferenc - Molnár Tibor: Mezőgazdasági vízépítés (Tankönyvkiadó, Budapest, 1981)

Bevezető

- a programdokumentációk pontosan megadják az útmutatást a programokkal megoldható feladatok méreteinek változtatásához,- a programdokumentációk az OS és DOS operációs rendszerben történő futtatáshoz is megadják a JOB control kártyák összeállításának módját.

Az IPSP programozási nyelve

Az IPSP FORTRAN nyelven készül. Ennek az az oka , hogy a műszaki-tudományos számításokban a FORTRAN a legelterjedtebb nyelv.

A FORTRAN nyelv sajnos nem teszi lehetővé a programok könnyű megértését biztositó strukturált programozást. A programok megértésének megkönnyítése érdekében az IPSP fejlesztésekor (elsősorban az újonnan irt programok és szubrutinok kidolgozásakor):- kerüljük a bonyolult programszerkezeteket,- moduláris programfelépitést alkalmazunk, lehetőség szerint, kisméretű modulokkal,- a programokat és szubrutinokat nagyon gondos programon belüli dokumentálással készítjük.

Az IPSP programjainak és szubrutinjainak belső dokumentációja

Az IPSP programain és szubritinjain belüli dokumentáció azt jelenti, hogy a programban levő comment-ek ismertetik a változók, vagy legalább is a program megértéséhez szükséges legfontosabb változók jelentését, dimenzióját,- az egyes programrészietekben megoldott feladatot,- a programrészek közötti kapcsolat módját, a számítási lépések sorrendjét.

Az IPSP programai és szubrutinjai programon belüli dokumentációjának fejlécében levő commentek mindig tartalmazzák a következőket:- az IPSP-re való hivatkozás,- a program, vagy szubrutin neve,- a megoldott feladat és a megoldás módszerére való rövid utalás,- a felhasznált szubrutinok neve,- a bemenő és kimenő adatokat, eredményeket tartalmazó változók neve és dimenziója,- a szubrutin aktivizálásának módja,- az utolsó tesztelés időpontja,- a megoldható feladat méreteire vonatkozó, vagy egyéb korlátozások (pld. megengedett legnagyobb egész szám),- a módszer és a program, illetve szubrutin kidolgozója.

17