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=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD,
	FREEMAIL_FROM autolearn=no 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,CP1252
Path: 
 g2news2.google.com!postnews.google.com!i39g2000prd.googlegroups.com!not-for-mail
From: Shark8 <onewingedshark@gmail.com>
Newsgroups: comp.lang.ada
Subject: Re: AWS Coding Styles (and about boring plain-linear text files in
 the end)
Date: Wed, 16 Mar 2011 13:13:29 -0700 (PDT)
Organization: http://groups.google.com
Message-ID: 
 <50792104-a9bc-4750-853f-3281f5faef29@i39g2000prd.googlegroups.com>
References: <op.vpfsjkfdule2fv@garhos>
 <24418fa4-8843-4fe6-8c2f-026ea6009b68@g26g2000vbz.googlegroups.com>
 <87lj2ido9j.fsf@mid.deneb.enyo.de> <4D35F6C8.2060100@obry.net>
 <4d3608ab$0$7664$9b4e6d93@newsspool1.arcor-online.net>
 <ih539t$7e4$1@munin.nbi.dk>
 <4d3634a5$0$7664$9b4e6d93@newsspool1.arcor-online.net>
 <op.vpi6pgmlule2fv@garhos>
 <4d36b748$0$6977$9b4e6d93@newsspool4.arcor-online.net>
 <op.vpjz4nfaule2fv@garhos>
 <4d36e484$0$6769$9b4e6d93@newsspool3.arcor-online.net>
 <op.vsf79rhwule2fv@index.ici>
NNTP-Posting-Host: 174.28.172.140
Mime-Version: 1.0
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: quoted-printable
X-Trace: posting.google.com 1300306409 21627 127.0.0.1 (16 Mar 2011 20:13:29
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Wed, 16 Mar 2011 20:13:29 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: i39g2000prd.googlegroups.com; posting-host=174.28.172.140;
 posting-account=lJ3JNwoAAAAQfH3VV9vttJLkThaxtTfC
User-Agent: G2/1.0
X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 6.0; en-US; rv:1.9.2.15)
 Gecko/20110303 Firefox/3.6.15 ( .NET CLR 3.5.30729; .NET4.0E),gzip(gfe)
Xref: g2news2.google.com comp.lang.ada:19226
Date: 2011-03-16T13:13:29-07:00
List-Id: <comp.lang.ada>

On Mar 16, 12:28=A0pm, Yannick Duch=EAne (Hibou57)
<yannick_duch...@yahoo.fr> wrote:
> Le Wed, 19 Jan 2011 14:17:56 +0100, Georg Bauhaus =A0
> <rm.dash-bauh...@futureapps.de> a =E9crit:
>
> > On 19.01.11 12:42, Yannick Duch=EAne (Hibou57) wrote:
>
> >> According to the authoritative FunnelWeb documentation, which you can =
=A0
> >> access
> >> here:
> >>http://www.ross.net/funnelweb/tutorial/intro_hello.html
> >> the body of a macros, whose purpose is to expand into program text, is=
 =A0
> >> exactly
> >> the same as the one you suggested!
>
> > No, no, the brackets @{ @}, or the line-of-code indicator @@ are much
> > simpler than FunnelWeb. =A0For one thing, the Ada programmer only needs
> > to understand Ada and =A0will not think about typesetting or macros or
> > line endings.
>
> Still in this area of annotations and rich documenting, I found another =
=A0
> more or less standard which could be of interest :http://en.wikipedia.org=
/wiki/Epydochttp://epydoc.sourceforge.net/http://epydoc.sourceforge.net/man=
ual-fields.html
>
> Wikipedia says> Epydoc is a documentation generator that processes its ow=
n lightweight
> > markup language Epytext for Python documentation strings. As opposed to
> > freeform Python docstrings, reStructured Text (both also supported) and
> > other markup languages for docstrings, Epytext supports linking between
> > different pieces of documentation.
>
> What I particularly enjoy here, is the part =93supports linking between =
=A0
> different pieces of documentation=94.
>
> While there are multiple standards covering similar things (I would like =
=A0
> one single standard, not many), there is at least one aspect which seems =
=A0
> there all the time : the meaning of =93@=94 as introducing annotations. Y=
ou =A0
> got it in Java, C, Python, FunnelWeb, among others. That's widely used =
=A0
> enough. At least a step to something standard=85 (I still miss many and m=
any =A0
> things).
>
> --
> Si les chats miaulent et font autant de vocalises bizarres, c=92est pas p=
our =A0
> les chiens.
>
> =93I am fluent in ASCII=94 [Warren 2010]

And in the TP-world '@' is the "address of" operator.