[Bug c++/14178] doc bug: -fabi-version=2 is now default (not 1)

["thome at lix dot polytechnique dot fr" <gcc-bugzilla at gcc dot gnu dot org>]

------- Additional Comments From thome at lix dot polytechnique dot fr  2004-02-19 14:32 -------

I would do more extensive cleanup, if there were a consensus on what to do with
these very scattered comments. Most (if not all) comments about flags are
duplicated (c-common.c , c-common.h, toplev.c, flags.h, only to mention those).

It would really be nicer if one single rule could determine where to find a
terse comment about some particular variable (.c or .h ? I vote for .c since
[ec]tags goes easier right to it). I've checked the sources, there seems to be
no such rule. Therefore, producing a patch which brings in sync the dozens of
disagreeing comments would be not very fascinating housekeeping job, and bound
to be somewhat useless (no reason to expect the situation would be any better 6
months from now).

I would prefer to decide that terse comments have no place in, say, the .h
files, and synchronize them in the .c files ; but doing such a thing requires a
consensus, I'm not going to submit anything on my own otherwise.

The previous patch updates the comment about abi_version for 3.4.0, which is
enough for the current PR. For the rest of the code cleanup, it certainly can wait.

E.

-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=14178