Umu logo Umeå universitet
Teknisk-naturvetenskaplig fakultet
Institutionen för datavetenskap



Laboration 1

Denna uppgift går ut på att implementera ett hjälpmedel för automatisk dokumenation av programkod skriven i C.

Detta hjälpmedel är ganska enkelt, det skall endast filtrera källkoden och visa kommentarer som är märkta för automatisk dokumentering. Sådan märkning består av strängen DOC: i början av kommentaren. Programmet ska klara av att hantera godtyckligt långa filer.

Programmet skall läsa data från stdin och skriva ut resultatet på stdout, tex mha av getchar() och putchar().

Du behöver alltså inte öppna några filer eller dylikt.

Programmet skall alltså skriva ut innehållet i alla kommentarer som börjar med DOC:, exklusive kommentartecken och strängen DOC:.

Exempel: Om infilen innehåller följande rader:

main() { /*DOC: main - starts prime counter */ /*DOC: 1994-01-23 Fixed source so it complies with ANSI standards */ [...]

Så skall programmet skriva ut:

main - starts prime counter 1994-01-23 Fixed source so it complies with ANSI standards

Programmets funktion skall verifieras innan inlämning. Det görs genom att köra programmet på en testfil och jämföra resultatet med en mall.

Filen heter testfil1.c och mallen heter testfil1.doc. Båda filerna finns i katalogen ~torkel/pub/edu/snp94/lab1.

Exempel på test (programmet heter docit):

cd ~torkel/pub/edu/snp94/lab1 docit < testfil1.c >/tmp/doc.$$ diff /tmp/doc.$$ testfil1.doc

Uppgiften skall lösas individuellt och programmet skall implementeras i C. Tänk på att syntaxen i C medger att tecknen som söks kan förekomma både i strängar, konstanter och i inuti kommentarer. Med andra ord, uppgiften kan vara klurigare än vid första anblicken.

Den slutgiltiga exekverbara versionen skall vara kompilerad för IBM RS/6000 för att underlätta för den som ska testköra era program.

SISTA INLÄMNINGSDAG 1994-10-16


Författare:


Senast ändrad 1994-09-29 av mr@cs.umu.se