[Bug c/62273] New: doc: Invoke.texi -mkernel mentions undocumented option

[joel at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=62273

            Bug ID: 62273
           Summary: doc: Invoke.texi -mkernel mentions undocumented option
           Product: gcc
           Version: 4.7.4
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: c
          Assignee: unassigned at gcc dot gnu.org
          Reporter: joel at gcc dot gnu.org

As best I can tell, this is broken in every version from the tail of the
4.7-branch to the head today. 

-mkernel is documented as:

     Enable kernel development mode.  The '-mkernel' option sets
     '-static', '-fno-common', '-fno-cxa-atexit', '-fno-exceptions',
     '-fno-non-call-exceptions', '-fapple-kext', '-fno-weak' and
     '-fno-rtti' where applicable.  This mode also sets '-mno-altivec',
     '-msoft-float', '-fno-builtin' and '-mlong-branch' for PowerPC
     targets.


Unfortunately, -fapple-kext does not appear anywhere in the manual.  It is
listed in darwin.opt with this:

fapple-kext
Target Report C++ Var(flag_apple_kext)
Generate code for darwin loadable kernel extensions

I assume someone responsible for the Darwin configuration knows enough to add a
line or two of documentation.