(RFC) GCC minor document change: gcc.1

[ishikawa at yk dot rim dot or dot jp]

I would like to propose a minor document change for gcc/doc/gcc.1

This is prompted by a change of GCC 3.3 (from 3.2.3)
that breaks GNU Emacs
installation, but the documentation is not clear enough IMHO.

Please see bugzilla 11386 entry for the background:
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11386

The file is gcc/doc/gcc.1
If there are other popular programs that are affected,
I think their names should be explicitly mentioned.
(By doing so, we can save many debugging hours.)

I hope that similar clear warning is
incorporated into GNU Emacs's etc/MACHINES
document although future versions of GNU emacs
is probably free from the problem
thanks to Paul's patches. 
However, there may be people who needed to
compile and install 21.3 and older versions
due to some reasons.

*** gcc.1.saved	2003-07-15 08:35:10.000000000 +0900
--- gcc.1	2003-07-15 08:36:10.000000000 +0900
***************
*** 3284,3290 ****
  are initialized to zero into \s-1BSS\s0.  This can save space in the resulting
  code.
  .Sp
! This option turns off this behavior because some programs explicitly
  rely on variables going to the data section.  E.g., so that the
  resulting executable can find the beginning of that section and/or make
  assumptions based on that.
--- 3284,3292 ----
  are initialized to zero into \s-1BSS\s0.  This can save space in the resulting
  code.
  .Sp
! This option turns off this behavior because some programs, most
! notably
! GNU Emacs 21.3 and its prior versions,  explicitly
  rely on variables going to the data section.  E.g., so that the
  resulting executable can find the beginning of that section and/or make
  assumptions based on that.




Happy Hacking,

Ishikawa, Chiaki

PS: Sorry for some "message unavailable" missing
links in the related thread in emacs-devel.
I think this is due to my bounced messages.

I found out that my e-mail set up (for GNU emacs mail buffer) was
screwed up and that is why my previous attempt to post to
emacs-*@gnu.org bounced. GNU mailing list software is strict in that
From: address contains reachable address, I think.

I only realized the problem when I see my e-mail address was quoted as
ishikawa@bogus.example.com in a message posted by Paul (I cc:ed to
Paul.)

I am hoping this time, it works.