https://gcc.gnu.org/bugzilla/show_bug.cgi?id=119788
Bug ID: 119788
Summary: "Known Causes of Trouble with GCC" manual chapter is
super bit-rotten
Product: gcc
Version: 15.0
Status: UNCONFIRMED
Keywords: documentation
Severity: normal
Priority: P3
Component: other
Assignee: unassigned at gcc dot gnu.org
Reporter: sandra at gcc dot gnu.org
Target Milestone: ---
The "Known Causes of Trouble with GCC" manual chapter is so bit-rotten that I'm
wondering if there is anything in there worth saving. Some examples....
- Problems with "fixincludes", if any of them still exist, should be documented
in the installation manual, not the user manual.
- The "Actual Bugs We Haven't Fixed Yet" section is pathetic anyway, given that
there are thousands of them in bugzilla. :-P
- Nowadays most/all GCC targets have a psABI that GCC conforms to. Ultrix is
certainly dead. I'm suspicious about whether the information about
SPARC/Solaris, HPPA/HPUX, and RS6000/AIX compatibility is at all accurate any
more and have no way to verify any of that.
- I suspect that some of the compatibility issues with K&R C have gone away,
and nobody cares about compatibility with PCC any more.
- SunOS 4.1.3 dates from 1992 and glibc 2.2 from 2000, so these are very poor
examples. I'd just delete these references instead of looking for other
examples that will end up getting just as bit-rotten over time.
- I think AIX has had weak symbol support for many years now (it's documented
in the 7.1 assembler manual).
