Apple Guide FAQ | Problems With Mixins

What is a mixin?
How do I decide whether to use mixins?
How do I set up and compile a mixin?
How do I control when a mixin mixes into the parent guide?
How do I use elements from the parent guide in a mixin?
Why does GuideMaker refuse to compile my mixin?
Why won't a mixin mix into the parent guide?
Why does the guide look strange when a mixin is active?

Why won't a mixin mix into the parent guide?

If you open the parent guide and the mixin changes are missing, there are several possible causes:

Is the mixin in the same folder as the parent guide?
If the mixin and parent guide have a <mixin match> command, do they match exactly (including case)?
If the mixin has a qualifier resource, are you sure you are using a configuration where the qualifier returns true? (For testing purposes, you may want to omit the qualifier from pre-release versions of the mixin; this will let you test the mixin on any machine configuration.)

Apple Guide versions before 1.2.7 have a bug that can cause Apple Guide to fail if a mixin's qualifier resource returns false. If the qualifier returns false, the mixin not only doesn't mix in, but the user can't open the parent guide at all. This bug is only present with Apple Guide 1.2.5 and before, and only on Power Macs.

Why does the guide look strange when a mixin is active?