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.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,429176cb92b1b825
X-Google-NewGroupId: yes
X-Google-Attributes: gida07f3367d7,domainid0,public,usenet
X-Google-Language: ENGLISH,UTF8
Path: 
 g2news2.google.com!news3.google.com!feeder.news-service.com!feeder.news-service.com!85.214.198.2.MISMATCH!eternal-september.org!feeder.eternal-september.org!.POSTED!not-for-mail
From: Simon Wright <simon@pushface.org>
Newsgroups: comp.lang.ada
Subject: Re: AWS Coding Styles (and about boring plain-linear text files in
 the end)
Date: Wed, 19 Jan 2011 06:58:52 +0000
Organization: A noiseless patient Spider
Message-ID: <m2lj2hl6qb.fsf@pushface.org>
References: <op.vpfsjkfdule2fv@garhos>
	<24418fa4-8843-4fe6-8c2f-026ea6009b68@g26g2000vbz.googlegroups.com>
	<87lj2ido9j.fsf@mid.deneb.enyo.de>
	<4dc188a3-468c-40eb-9f3c-85bfb621cb23@o14g2000prn.googlegroups.com>
	<op.vpiys9g0ule2fv@garhos>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Injection-Info: mx02.eternal-september.org;
 posting-host="dFCm8HWntFqmDIilBLqEJQ";
	logging-data="10035"; mail-complaints-to="abuse@eternal-september.org";
	posting-account="U2FsdGVkX18YbDtXnLSNnK5pZyqJpSA7wBwkWnB2jDE="
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (darwin)
Cancel-Lock: sha1:rFGHsXuGkbe+wgxGorqZHph1yu8=
	sha1:IplbYf8+ZmeIzaknweQ1bCFQXNw=
Xref: g2news2.google.com comp.lang.ada:17512
Date: 2011-01-19T06:58:52+00:00
List-Id: <comp.lang.ada>

"Yannick Duchêne (Hibou57)" <yannick_duchene@yahoo.fr> writes:

> This raise (one more time) the question of comment consistency with
> source. We really need a standard convention to mark program
> identifiers in comments (and corollary to precisely define scope of
> comments).

   --  @Path is the name of the file to be called.
   procedure Call (Path : String);

would be the Javadoc way (just for parameters, there's be more to it, as
you say).

I haven't investigated whether gnathtml.pl or AdaBrowse or AdaDoc
support such a feature already. AdaBrowse and AdaDoc seem to have
stalled?