Re: AWS Coding Styles (and about boring plain-linear text files in the end)

[Shark8 <onewingedshark@gmail.com>]

On Mar 16, 12:28 pm, Yannick Duchêne (Hibou57)
<yannick_duch...@yahoo.fr> wrote:
> Le Wed, 19 Jan 2011 14:17:56 +0100, Georg Bauhaus  
> <rm.dash-bauh...@futureapps.de> a écrit:
>
> > On 19.01.11 12:42, Yannick Duchêne (Hibou57) wrote:
>
> >> According to the authoritative FunnelWeb documentation, which you can  
> >> 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  
> >> exactly
> >> the same as the one you suggested!
>
> > No, no, the brackets @{ @}, or the line-of-code indicator @@ are much
> > simpler than FunnelWeb.  For one thing, the Ada programmer only needs
> > to understand Ada and  will not think about typesetting or macros or
> > line endings.
>
> Still in this area of annotations and rich documenting, I found another  
> more or less standard which could be of interest :http://en.wikipedia.org/wiki/Epydochttp://epydoc.sourceforge.net/http://epydoc.sourceforge.net/manual-fields.html
>
> Wikipedia says> Epydoc is a documentation generator that processes its own 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 “supports linking between  
> different pieces of documentation”.
>
> While there are multiple standards covering similar things (I would like  
> one single standard, not many), there is at least one aspect which seems  
> there all the time : the meaning of “@” as introducing annotations. You  
> got it in Java, C, Python, FunnelWeb, among others. That's widely used  
> enough. At least a step to something standard… (I still miss many and many  
> things).
>
> --
> Si les chats miaulent et font autant de vocalises bizarres, c’est pas pour  
> les chiens.
>
> “I am fluent in ASCII” [Warren 2010]

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