|
Neki studenti vec mi salju rjesenja zadataka za vjezbu, a kako ce, u dogledno vrijeme, doci i prave domace zadace, evo ovdje uputstava kako cete mi slati programe.
(Ovo vrijedi za moju grupu. Asistent Puljic ce imati svoje metode.)
Komentirajte! Kad niste sigurni treba li negdje u kodu stajati komentar, uvijek je odgovor da treba. Potrosite nesto vremena, ali i sebi i meni ustedite puno vise kad program treba debugirati ili pregledavati.
Konzistentno formatirajte! Ne namecem ikome pravila, no preporuka je da koristite ili samo space-ove ili samo tab-ove za identaciju, koja mora biti barem dva mjesta kako bi se ista dalo procitati.
E-mail adresa na koju cete slati programe je student, a ne cromath! Dakle: [tt]venovako[/tt] na racunalu [tt]student.math.hr[/tt].
Source fajlove (.cpp, .hpp i/ili makefile-ovi) staviti u arhivu (.zip, .tar.bz2, .tar.gz; molim, ne .rar ili neki format koji ne mogu otvoriti na proizvoljnom sustavu), te arhivu u attachment. Arhiva mora cuvati strukturu direktorija, ukoliko su izvorni kodovi rasporedjeni u vise njih. Ako pravite tarball, svakako odaberite POSIX format.
Ne slati binarne medjudatoteke (.o(bj)), a narocito ne izvrsne programe (.exe ili sto vec)! Zasigurno necu pokretati izvrsne programe koje, ne slijedeci ova uputstva, ipak prilozite.
Nadalje, ne mozete pretpostaviti nista o okolini na kojoj ce se programi kompajlirati i izvrsavati. Ako je, iz nekog razloga, neophodno koristiti samo jednu platformu (u sto me morate uspjeti uvjeriti, a jamcim da to nece biti lako), tu napomenu i obrazlozenje svakako morate staviti u tekst e-mail poruke!
E-mail poruka mora biti plain text (HTML mail [b]ignoriram[/b]) i molim da ne sadrzi nista osim ASCII znakova. Da, postoje jos ljudi koji citaju mail na dinosaurskim sustavima s konzolnim programima.
Iznimno je pozeljno u arhivi priloziti test primjere i dokumentaciju (.txt, .html, .ps, .pdf; molim, ne slati dokumente X-Office paketa, za bilo koje vrijednosti od X). Kao minimum, neki oblik README.txt fajla, jedan trivijalan i jedan netrivijalan test primjer su nuzni. U README fajlu svakako opisati reproducibilan nacin kompilacije te koji(e) ste kompajler(e) koristili. Ako koristite tocno odredjeni kompajler i sigurni ste da se ne moze kompajlirati nekim drugim, morate obrazloziti zasto.
Ako koristite nestandardne biblioteke, budite sigurni da:
-> biblioteka radi na sustavu X, za vrlo cudnovate X;
-> biblioteka je dostupna u izvornom kodu i moze se u razumno vrijeme instalirati;
-> u dokumentaciji je prilozen URL na web site biblioteke i par recenica kako se kombinira s ostatkom koda.
Neki studenti vec mi salju rjesenja zadataka za vjezbu, a kako ce, u dogledno vrijeme, doci i prave domace zadace, evo ovdje uputstava kako cete mi slati programe.
(Ovo vrijedi za moju grupu. Asistent Puljic ce imati svoje metode.)
Komentirajte! Kad niste sigurni treba li negdje u kodu stajati komentar, uvijek je odgovor da treba. Potrosite nesto vremena, ali i sebi i meni ustedite puno vise kad program treba debugirati ili pregledavati.
Konzistentno formatirajte! Ne namecem ikome pravila, no preporuka je da koristite ili samo space-ove ili samo tab-ove za identaciju, koja mora biti barem dva mjesta kako bi se ista dalo procitati.
E-mail adresa na koju cete slati programe je student, a ne cromath! Dakle: venovako na racunalu student.math.hr.
Source fajlove (.cpp, .hpp i/ili makefile-ovi) staviti u arhivu (.zip, .tar.bz2, .tar.gz; molim, ne .rar ili neki format koji ne mogu otvoriti na proizvoljnom sustavu), te arhivu u attachment. Arhiva mora cuvati strukturu direktorija, ukoliko su izvorni kodovi rasporedjeni u vise njih. Ako pravite tarball, svakako odaberite POSIX format.
Ne slati binarne medjudatoteke (.o(bj)), a narocito ne izvrsne programe (.exe ili sto vec)! Zasigurno necu pokretati izvrsne programe koje, ne slijedeci ova uputstva, ipak prilozite.
Nadalje, ne mozete pretpostaviti nista o okolini na kojoj ce se programi kompajlirati i izvrsavati. Ako je, iz nekog razloga, neophodno koristiti samo jednu platformu (u sto me morate uspjeti uvjeriti, a jamcim da to nece biti lako), tu napomenu i obrazlozenje svakako morate staviti u tekst e-mail poruke!
E-mail poruka mora biti plain text (HTML mail ignoriram) i molim da ne sadrzi nista osim ASCII znakova. Da, postoje jos ljudi koji citaju mail na dinosaurskim sustavima s konzolnim programima.
Iznimno je pozeljno u arhivi priloziti test primjere i dokumentaciju (.txt, .html, .ps, .pdf; molim, ne slati dokumente X-Office paketa, za bilo koje vrijednosti od X). Kao minimum, neki oblik README.txt fajla, jedan trivijalan i jedan netrivijalan test primjer su nuzni. U README fajlu svakako opisati reproducibilan nacin kompilacije te koji(e) ste kompajler(e) koristili. Ako koristite tocno odredjeni kompajler i sigurni ste da se ne moze kompajlirati nekim drugim, morate obrazloziti zasto.
Ako koristite nestandardne biblioteke, budite sigurni da:
→ biblioteka radi na sustavu X, za vrlo cudnovate X;
→ biblioteka je dostupna u izvornom kodu i moze se u razumno vrijeme instalirati;
→ u dokumentaciji je prilozen URL na web site biblioteke i par recenica kako se kombinira s ostatkom koda.
Zadnja promjena: venovako; 18:44 pet, 20. 10. 2006; ukupno mijenjano 1 put.
|
