Re: Why does -Wabi-tag complain when -std=c++03?

[Jonathan Wakely <jwakely dot gcc at gmail dot com>]

On 24 March 2016 at 16:08, Jeffrey Walton <noloader@gmail.com> wrote:
> On Thu, Mar 24, 2016 at 12:03 PM, Jonathan Wakely <jwakely.gcc@gmail.com> wrote:
>> On 24 March 2016 at 15:24, Jeffrey Walton wrote:
>>> Here's the actionable item to remove the ambiguity from ABI_CHANGE:
>>>
>>> #ifdef MYLIB_ABI_CHANGE
>>> inline namespace abi2 __attribute ((abi_tag)) {
>>>   class MyType { ... };
>>>   MyType fn();
>>> }
>>> #endif
>>>
>>> That way, its clear the define is local to the library, and its not
>>> coming from GCC or the runtime.
>>
>> ABI_CHANGE is not a valid name for a non-standard macro coming from
>> GCC or the runtime, because it's not in the reserved namespace.
>>
>> Maybe you're trying to use the blog post as a tutorial for how to
>> achieve what you want, but it isn't that, it's just a brief
>> introduction to the topic. If it doesn't hold your hand through every
>> step that's because that wasn't its goal. Trying to follow it like a
>> tutorial isn't going to work.
>
> That's fine.
>
> Where is the [nearly] complete documentation on the subject? I'm
> guessing it does not exist, and we are left to struggle through it
> (q.v.).
>
> If you don't provide the necessary documentation, you should not
> complain when users come with questions.

You're the one complaining, not me.

And nobody else has complained about the lack of that documentation,
**because generally nobody needs to do it**. I advise against what
you're trying to do. If the ramifications and the steps needed to do
it are not clear to you, then you probably don't need to do it.

The only person I know who has had to do this is me, for libstdc++
itself, and the instructions for making it work are the libstdc++
makefiles.