[Bug preprocessor/24916] New: option -O undocumented in cpp docs

[Bug preprocessor/24916] New: option -O undocumented in cpp docs

[debian-gcc at lists dot debian dot org]

[forwarded from http://bugs.debian.org/339495]

you can see[1] that cpp supports -O, -O[1-9], -Os options, and these options
are meaningful (defining macros). but this is not documented in man page[2] and
info[3].

[1]
$ cpp -dM /dev/null | grep OPT
$ cpp -dM -O /dev/null | grep OPT
#define __OPTIMIZE__ 1
$ cpp -dM -Os /dev/null | grep OPT
#define __OPTIMIZE__ 1
#define __OPTIMIZE_SIZE__ 1
$ cpp -dM -O2 /dev/null | grep OPT
#define __OPTIMIZE__ 1

[2] /usr/share/man/man1/cpp-4.0.1.gz
[3] /usr/share/info/cpp-4.0.info.gz


-- 
           Summary: option -O undocumented in cpp docs
           Product: gcc
           Version: 4.1.0
            Status: UNCONFIRMED
          Severity: minor
          Priority: P3
         Component: preprocessor
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: debian-gcc at lists dot debian dot org


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #1 from pinskia at gcc dot gnu dot org  2005-11-17 18:02 -------
The C front-end defines these.


-- 

pinskia at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
          Component|preprocessor                |c


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #2 from pinskia at gcc dot gnu dot org  2005-11-17 18:03 -------
They are documented:
http://gcc.gnu.org/onlinedocs/cpp/Common-Predefined-Macros.html


-- 


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #3 from pinskia at gcc dot gnu dot org  2005-11-17 18:04 -------
Since they are documented, I am going to close this as invalid.


-- 

pinskia at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |RESOLVED
         Resolution|                            |INVALID


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #4 from pinskia at gcc dot gnu dot org  2005-11-17 18:05 -------
And have been since 3.1:
http://gcc.gnu.org/onlinedocs/gcc-3.1/cpp/Common-Predefined-Macros.html


-- 


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

[Bug c/24916] option -O undocumented in cpp docs

[debian-gcc at lists dot debian dot org]

------- Comment #5 from debian-gcc at lists dot debian dot org  2005-11-17 18:26 -------
(In reply to comment #2)
> They are documented:
> http://gcc.gnu.org/onlinedocs/cpp/Common-Predefined-Macros.html

the point of the bug submitter was to have them documented in cpp(1).

  Matthias


-- 


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #6 from pinskia at gcc dot gnu dot org  2005-11-17 18:33 -------
(In reply to comment #5)
> the point of the bug submitter was to have them documented in cpp(1).

But they are documented in the info page:
Predefined Macros

* Standard Predefined Macros::
* Common Predefined Macros::
* System-specific Predefined Macros::
* C++ Named Operators::

Which is not what the submitted said.


-- 


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

[Bug c/24916] option -O undocumented in cpp docs

[pinskia at gcc dot gnu dot org]

------- Comment #7 from pinskia at gcc dot gnu dot org  2005-11-17 18:34 -------
(In reply to comment #6)
> (In reply to comment #5)
> > the point of the bug submitter was to have them documented in cpp(1).
> But they are documented in the info page:

I should point out the web page is generated via the same document that the
info page is generated from.


-- 


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