This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


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.

> + * gnat-syle: (gnat-syle).      GNAT Coding Style

gnat-style, not gnat-syle (twice in this line).

>   @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.

-- 
Joseph S. Myers
jsm28@cam.ac.uk


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]