[Bug other/3386] Undocumented target macros in 3.0

[Bug other/3386] Undocumented target macros in 3.0

[pinskia@physics.uc.edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


pinskia@physics.uc.edu changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Last reconfirmed|0000-00-00 00:00:00         |2003-05-24 23:08:59
               date|                            |


------- Additional Comments From pinskia@physics.uc.edu  2003-05-24 23:08 -------
The following where fixed in at least mainline (20030524):
ASM_OUTPUT_DWARF_PCREL
MAX_LONG_DOUBLE_TYPE_SIZE
MD_FALLBACK_FRAME_STATE_FOR
TARGET_ESC

The ones fixed are by:
2002-09-12  Stan Shebs  <shebs@apple.com>

        * doc/tm.texi (TARGET_TERMINATE_DW2_EH_FRAME_INFO): Document.
        (ASM_OUTPUT_DWARF_DELTA): Ditto.
        (ASM_OUTPUT_DWARF_OFFSET): Ditto.
        (ASM_OUTPUT_DWARF_PCREL): Ditto.

2001-06-26  Jim Wilson  <wilson@redhat.com> (even though 
NTEL_EXTENDED_IEEE_FORMAT is now undocumented)

        * doc/tm.texi (MAX_LONG_DOUBLE_TYPE_SIZE, 
INTEL_EXTENDED_IEEE_FORMAT):
        Document.

2001-07-08  Richard Henderson  <rth@redhat.com>

        * doc/tm.texi (Exception Handling): New subnode of Stack and Calling.
        Document MD_FALLBACK_FRAME_STATE_FOR.

2001-06-27  Neil Booth  <neil@cat.daikokuya.demon.co.uk>

        * doc/tm.texi: Document TARGET_ESC.




------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug other/3386] Undocumented target macros in 3.0

[pinskia@physics.uc.edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


pinskia@physics.uc.edu changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Priority|P3                          |P2
   Target Milestone|---                         |3.4





------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug other/3386] Undocumented target macros in 3.0

[hans-peter.nilsson@axis.com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From hans-peter.nilsson@axis.com  2003-06-02 15:05 -------
Subject: Re:  Undocumented target macros in 3.0

> Date: 28 May 2003 00:17:21 -0000
> From: "pinskia@physics.uc.edu" <gcc-bugzilla@gcc.gnu.org>

> Adding the people who introduced these undocumented target marcos:

> hp@axis.com: TDESC_SECTION_ASM_OP (even though he said in the ChangeLog for 
> which added this one, it was documented).

I'm an innocent bystander: I did not introduce
TDESC_SECTION_ASM_OP.  I see a ChangeLog(.4) entry of mine
vaguely related to TDESC_SECTION_ASM_OP, dated 2000-09-25: a
large patch where I added leading and trailing TAB characters to
most *ASM_OP macros.  Perhaps you meant some other macro?

brgds, H-P




------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug other/3386] Undocumented target macros in 3.0

[pinskia@physics.uc.edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


pinskia@physics.uc.edu changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|hp@axis.com                 |


------- Additional Comments From pinskia@physics.uc.edu  2003-06-02 15:14 -------
I removed hp@axis.com from the CC as he really is an innocent bystander, I should have read the 
changelog more closely.



------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug other/3386] Undocumented target macros in 3.0

[pinskia@physics.uc.edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From pinskia@physics.uc.edu  2003-06-04 12:58 -------
TDESC_SECTION_ASM_OP is gone cross that one off the list.



------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[pinskia at physics dot uc dot edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


pinskia at physics dot uc dot edu changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Severity|normal                      |critical
           Keywords|                            |documentation
           Priority|P2                          |P1
   Last reconfirmed|2003-05-24 23:08:59         |2003-06-28 19:01:38
               date|                            |
            Summary|Undocumented target macros  |[3.3/3.4 Regression]
                   |in 3.0                      |Undocumented target macros
                   |                            |in 3.0
   Target Milestone|3.4                         |3.3.1


------- Additional Comments From pinskia at physics dot uc dot edu  2003-06-28 19:01 -------
Chaning this to a regression because these should fixed soon.

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[steven at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


steven at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mark at codesourcery dot com
   Target Milestone|3.3.1                       |3.4


------- Additional Comments From steven at gcc dot gnu dot org  2003-07-11 23:33 -------
This PR is targeted for 3.3.1, but I believe it is not reasonable to expect this
to be fixed before then; this PR is important for 3.4 and it really, _really_,
__REALLY__ should be fixed for 3.4.  But certainly not for 3.3.1.  So I moved
the target milestone.

Is the list of undocumented macros still up to date?  Is there a way to check
this quickly?

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[pinskia at physics dot uc dot edu]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From pinskia at physics dot uc dot edu  2003-07-11 23:38 -------
There really is no easy way to find out what are the new ones that got not documented, I 
tried to update the list that was there and add people who added some of the patches 
which added the target macros.

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[mark at codesourcery dot com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From mark at codesourcery dot com  2003-07-11 23:40 -------
Subject: Re:  [3.3/3.4 Regression] Undocumented target
	macros in 3.0

On Fri, 2003-07-11 at 16:33, steven at gcc dot gnu dot org wrote:
> PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.
> 
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=3386
> 
> 
> steven at gcc dot gnu dot org changed:
> 
>            What    |Removed                     |Added
> ----------------------------------------------------------------------------
>                  CC|                            |mark at codesourcery dot com
>    Target Milestone|3.3.1                       |3.4

I'd prefer we leave this for 3.3.2, rather than 3.4, so that it shows up
on everyone's radar when they search for bugs to kill for the next
release.

Thanks,

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[neroden at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


neroden at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|3.4                         |3.3.2

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[jsm at polyomino dot org dot uk]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From jsm at polyomino dot org dot uk  2003-07-12 00:10 -------
Subject: Re:  [3.3/3.4 Regression] Undocumented target macros
 in 3.0

On Sat, 11 Jul 2003, steven at gcc dot gnu dot org wrote:

> Is the list of undocumented macros still up to date?  Is there a way to check
> this quickly?

The list in the bug report is a subset of my longer list (of the same
vintage) <http://gcc.gnu.org/ml/gcc/2001-06/msg00507.html> (linked to from
projects/beginner.html), from which I extracted those that weren't in 2.95
so that the bug was a regression.  That message describes the methodology
- that the macro is defined in a target header, used somewhere else in the
compiler, and not mentioned in the manual - the implementation was
probably a perl+shell one-liner on the command line with some subsequent
manual editing.

Other similar checks that can be done:

* Macros that are documented but not defined by any targets, or defined 
only with one default value (in which case the default should at least go 
to defaults.h if there is thought to be value in retaining the macro).

* Macros that are documented but not used in the compiler (whether or not
defined by targets).

* Macros that are defined in a target header but not used in the compiler 
(including in that config directory), whether or not documented.

* Macros that are tested in the compiler but not defined anywhere and not
documented.

I.e., if DOC is the set of all documented target macros (extracted from 
the manual), DEF is the set of those that are defined (or defined with 
nondefault values, ideally), extracted from target headers and USE is the 
set of all identifiers used in the compiler that might possibly be macros 
(this generates much too big a set and in some cases should include those 
used in target headers, in some cases shouldn't; it also needs to cover 
#ifdef / #ifndef), then:

* Anything in DOC should be in DEF intersect USE.

* Anything in DEF intersect USE should be in DOC.

* Anything in DEF should be in the bigger version of USE (including uses 
within that target directory).

* Anything in USE that is used _as a macro_ (meaning in preprocessor
conditional tests) should be in a bigger version of DEF that includes
defines outside target headers and autoconf-generated defines.

A lot of such checks may generate false positives in practice.  But
perhaps robust scripts to generate DOC, the two versions of DEF and the
three versions of USE would help people do these tests.

[Bug other/3386] [3.3/3.4 Regression] Undocumented target macros in 3.0

[mmitchel at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


mmitchel at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|3.3.2                       |---


------- Additional Comments From mmitchel at gcc dot gnu dot org  2003-09-05 05:45 -------
I've decided to clear the target milestone for this PR.

Realistically, this bug just isn't ever going to hold up any release, ever.

[Bug other/3386] Undocumented target macros in 3.0

[steven at gcc dot gnu dot org]

-- 

steven at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         AssignedTo|steven at gcc dot gnu dot   |unassigned at gcc dot gnu
                   |org                         |dot org
             Status|ASSIGNED                    |NEW


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