This is the mail archive of the gcc-patches@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: Patch to docs of Cimplementation-defined behavior


"Joseph S. Myers" <jsm@polyomino.org.uk> writes:

> On Thu, 29 Jul 2004, Zack Weinberg wrote:
>
>> Cut-and-paste error?  Did you mean to insert an xref to the
>> preprocessor manual?
>
> I put the xref at the top of that section and only put it under the
> individual items for those in other sections for which it seemed
> appropriate.

Ah, OK.

>> I am thinking that having the preprocessor's i-d behavior off in its
>> own document is suboptimal, and maybe that section ought to be split
>> out to a separate .texi file that could be included into the GCC
>> manual as well as the preprocessor manual.
>
> That makes sense (as with cppenv.texi and cppopts.texi).  There's also a
> cross-reference to the cpp manual for the common GCC pragmas, which could
> usefully receive the same treatment.

Would you be interested in doing this?  I get lost in all the @include
and @ifset stuff these days.

> I'm not sure the preprocessor manual does cover all the listed items
> adequately (e.g. the value of multi-character wide character constants),
> though it does cover those for which I removed text in favour of a
> cross-reference.

Well, that's something that could be improved.  There is a whole bunch
of commentary in libcpp/charset.c that might be helpful (but you're
going to have to fix the GFDL before you copy it over).

zw


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