Target-specific pragmas

[Stan Shebs <shebs at apple dot com>]

Undeterred by the embarassment of pascal strings :-), I'm sweeping on
to Apple's steamy pile of target-specific pragmas.  While it's actually
quite pleasant to redo our old pragmas with the new cpplib machinery
(thanks Zack!), some of the pragmas themselves are pretty dubious,
and I'm hoping to find that nobody uses them.  Anyway, the worthwhile
ones raise a couple questions:

1. How should target-specific pragmas be documented?  I notice that
there are many existing pragmas in targets, but the manual does not
seem to mention any of them anywhere.  Is this deliberate?

2. Some of our pragmas exist to provide per-function control over
optimization levels and flag_writable_strings.  I vaguely remember
some discussion over whether there ought to be some kind of fine
grained control over flags via pragmas and/or attributes.  Is there
a consensus on what to do here?

Stan