public inbox for gcc-prs@sourceware.org
help / color / mirror / Atom feed
From: Simon Wright <simon@pushface.org>
To: bje@gcc.gnu.org
Cc: gcc-prs@gcc.gnu.org,
Subject: Re: ada/9406: Documentation suggestion
Date: Thu, 20 Feb 2003 21:46:00 -0000 [thread overview]
Message-ID: <20030220214601.23204.qmail@sources.redhat.com> (raw)
The following reply was made to PR ada/9406; it has been noted by GNATS.
From: Simon Wright <simon@pushface.org>
To: bosch@gcc.gnu.org, bje@gcc.gnu.org, gcc-bugs@gcc.gnu.org,
gcc-prs@gcc.gnu.org, simon@pushface.org, gcc-gnats@gcc.gnu.org
Cc: bje@gcc.gnu.org, gcc-bugs@gcc.gnu.org, gcc-prs@gcc.gnu.org
Subject: Re: ada/9406: Documentation suggestion
Date: Thu, 20 Feb 2003 21:35:16 GMT
> X-Envelope-To: simon@pushface.org
> X-Forwarding-To: simon@pushface.org
> Date: 19 Feb 2003 20:56:15 -0000
> From: bosch@gcc.gnu.org
> Reply-To: bosch@gcc.gnu.org, bje@gcc.gnu.org, gcc-bugs@gcc.gnu.org,
> gcc-prs@gcc.gnu.org, simon@pushface.org, gcc-gnats@gcc.gnu.org
>
> Synopsis: Documentation suggestion
>
> State-Changed-From-To: feedback->closed
> State-Changed-By: bosch
> State-Changed-When: Wed Feb 19 20:56:15 2003
> State-Changed-Why:
> Suggestion inconsistent with wording in language standard and rest of documentation. Furthermore the term "entry unit" is confusing as both "entry" and "unit" are terms defined in the Ada reference manual.
>
> http://gcc.gnu.org/cgi-bin/gnatsweb.pl?cmd=view%20audit-trail&database=gcc&pr=9406
You are of course entirely welcome to reject the suggested
rewording. However,
(a) the first part of the patch corrected a grammatical error.
(b) the second part begins "Run the Ada binder on the Ada main
program." but ----
we are in a section of the manual which begins "If the main
program is in some language other than Ada"!!!!!!!
(c) (I missed this) the next para has the same error, it begins "Link
the Ada main program".
So there is a problem with the manual.
My suggestion was to say "run the Ada binder on the Ada entry units"
but I suppose you could be all formal and say "run the Ada binder on
all the Ada units that contain subprograms that are called directly or
indirectly by the non-Ada main program". I think I would have
understood the former better. I certainly didn't understand the
present wording!
(by the way, what about non-subprogram entities such as variables?)
next reply other threads:[~2003-02-20 21:46 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2003-02-20 21:46 Simon Wright [this message]
-- strict thread matches above, loose matches on Subject: below --
2003-02-27 14:16 Ben Elliston
2003-02-23 14:56 Geert Bosch
2003-02-23 12:26 Simon Wright
2003-02-20 22:46 Geert Bosch
2003-02-19 20:56 bosch
2003-02-18 14:06 bje
2003-02-18 12:09 bje
2003-01-22 20:56 simon
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20030220214601.23204.qmail@sources.redhat.com \
--to=simon@pushface.org \
--cc=bje@gcc.gnu.org \
--cc=gcc-prs@gcc.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).