This is the mail archive of the gcc-help@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: When did -Wmaybe-unitialized make its appearance?


On 31/07/15 12:33, Jeffrey Walton wrote:
Do you have a particular format in mind?
     -WnonnullWarn (GCC 4.8)
           about passing a null pointer for arguments marked
           as requiring a non-null value by the nonnull function
           attribute.

If we are into bike-shedding :), I'd prefer something like:

-Wnonnull 				  	   (since GCC 4.8)
            Warn about passing a null pointer for arguments marked
            as requiring a non-null value by the nonnull function
            attribute.

perhaps with a smaller font and some color, like the annotations here:

http://en.cppreference.com/w/cpp/container/map/insert

but see below.

I need this intersection often. I can submit a patch every time I find
one that's not documented. Its so small, its hard to claim its too
hard to review :)

The place to add them to the manual is: gcc/doc/invoke.texi

You can also submit a patch that adds just one or two to discuss the format first and see what kind of feedback you get. As pointed out here https://gcc.gnu.org/wiki/Community (point 10): the only people whose opinion matters are the people who can review and approve your patch. Thus, CC the documentation co-maintainers: you can find them in the MAINTAINERS file.

Follow: https://gcc.gnu.org/wiki/GettingStarted#Basics:_Contributing_to_GCC_in_10_easy_steps although most things there are not required for documentation changes. It should be obvious which ones, otherwise, please ask.

Cheers,

Manuel.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]