From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.3 required=5.0 tests=BAYES_00,INVALID_MSGID
	autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,8eaea1d1465f843d
X-Google-Attributes: gid103376,public
From: ok@goanna.cs.rmit.edu.au (Richard A. O'Keefe)
Subject: Re: Comments
Date: 1996/11/18
Message-ID: <56p8l2$a6t$1@goanna.cs.rmit.edu.au>#1/1
X-Deja-AN: 197184844
references: <328828AA.4EF6@wantree.com.au>
 <19961113121001.HAA20548@ladder01.news.aol.com>
organization: Comp Sci, RMIT, Melbourne, Australia
nntp-posting-user: ok
newsgroups: comp.lang.ada
Date: 1996-11-18T00:00:00+00:00
List-Id: <comp.lang.ada>


ennals@aol.com writes:

>It can be useful for describing what function calls etc do.
>For example I might write a procedure (fake code)

>procedure brcp(s : screen ; i : image ; c : colours); 
>#desc Build Really Cool Picture on screen %s of image %i with %c colours

But in Ada I can write

	procedure Build_Really_Cool_Picture(
	   Of_Image : in Image;
	   On_Screen: in Screen;
	   Colour_Count: in Positive);

>brcp(myscreen, megaimage, 256);
>the comment would be:

>#com Build really coop picture on screen myscreen of image megaimage with
>256 colours.

and then call it as

	Build_Really_Cool_Picture(Of_Image => Mega_Image,
	   On_Screen => My_Screen, Colour_Count => 256);

If you really want a preprocessor, write one that adds keyword=> to
arguments.
-- 
Mixed Member Proportional---a *great* way to vote!
Richard A. O'Keefe; http://www.cs.rmit.edu.au/%7Eok; RMIT Comp.Sci.