Re: [Ada] Corrections to gnat-style.texi

[Florian Weimer <fw at deneb dot enyo dot de>]

"Joseph S. Myers" <jsm28@cam.ac.uk> writes:

> On Sat, 22 Dec 2001, Florian Weimer wrote:
>
>>         etc.), and @syntax for ARM grammar elements. Use @r for English
>>         text in comments.  Use @emph for emphasis.  Change "if-statements"
>
> I was told by brosgol@gnat.com (working on fixing the issues I pointed out
> in gnat_rm.texi) that they preferred to use the standard Ada convention of
> italics for comments, via a @cmt{} macro.

@cmt{} macro?  I cant find this one in the Texinfo documentation.

>> + * gnat-syle: (gnat-syle).      GNAT Coding Style
>
> gnat-style, not gnat-syle (twice in this line).

Argh, thanks.  Fixed in my local copy.

>>   @author Ada Core Technologies, Inc.
>
> The GNU Coding Standards say that
>
>    Please credit the principal human writers of the manual as the
>    authors, on the title page of the manual. If a company sponsored the
>    work, thank the company in a suitable place in the manual, but do not
>    cite the company as an author.
>
> This probably needs to go on your list of open issues for someone to fix.

Yes, I agree.  (However, this is not the only place in which referring
to Ada Core Technologies contradicts GNU recommendations.)