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: a07f3367d7,429176cb92b1b825 X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,CP1252 Path: g2news1.google.com!postnews.google.com!f20g2000vbc.googlegroups.com!not-for-mail From: Shark8 Newsgroups: comp.lang.ada Subject: Re: AWS Coding Styles (and about boring plain-linear text files in the end) Date: Sun, 16 Jan 2011 22:43:11 -0800 (PST) Organization: http://groups.google.com Message-ID: References: NNTP-Posting-Host: 174.28.171.62 Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable X-Trace: posting.google.com 1295246591 12919 127.0.0.1 (17 Jan 2011 06:43:11 GMT) X-Complaints-To: groups-abuse@google.com NNTP-Posting-Date: Mon, 17 Jan 2011 06:43:11 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: f20g2000vbc.googlegroups.com; posting-host=174.28.171.62; 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.13) Gecko/20101203 Firefox/3.6.13 ( .NET CLR 3.5.30729; .NET4.0E),gzip(gfe) Xref: g2news1.google.com comp.lang.ada:16473 Date: 2011-01-16T22:43:11-08:00 List-Id: On Jan 16, 10:07=A0pm, Yannick Duch=EAne (Hibou57) wrote: > Hi happy night workers, > > If ever Pascal or his peer for that project is around the place=85 I get = AWS =A0 > source, not to compile nor use it, but just to have a look (I enjoy =A0 > reading others literatures, and especially surrounding design =A0 > documentations). There are things about I have questions. > > The file style-guide.html says > > In =933.5 Comments=94 : > > =A0 =A0 > The only exception to this rule (i.e. one space is > =A0 =A0 > tolerated) is when the comment ends with -- > > =A0 =A0 Q: Why a comment could ends with =93--=94 ? What could this mean = ? You'd do that if you're "boxing" in your comments, like so: ------------------------------------------------------ -- This comment describes the key realization for -- -- proving Huffman-encoding as the/a space-optimal -- -- encoding; if two message frequencies are equal -- -- then their encodings may be swiched without any -- -- change to the final length of the encoding. -- ------------------------------------------------------ ps, you'll need to use a monospaced font for that to look right.