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.
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:
Så skall programmet skriva ut:
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):
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.