Straight from the 'overlays' reference:
Any negative number may be used in place of FLOAT_LAYER (which happens to be -1). They all cause the same "floating" behavior. However, the overlays are ordered amongst themselves according to their own relative layer values (-2 below -1 and so on).
Numbered Steps to Reproduce Problem:
1) Make an overlay FLOAT_LAYER
2) Make another overlay FLOAT_LAYER-1
Logically, FLOAT_LAYER-1 would be below FLOAT_LAYER, as described in the reference. However, not the case.
Code Snippet (if applicable) to Reproduce Problem:
obj
hair
icon='hair.dmi'
layer=FLOAT_LAYER
aura
icon='aura.dmi'
layer=FLOAT_LAYER-1
Expected Results:
Hair to be over the Aura when used as overlays.
Actual Results:
Aura is over the hair.
Funny thing is, even if 'hair' in this case were 'FLOAT_LAYER-2', the Aura would still be on top of it.
This made me suspect something wrong with my code applying overlays somewhere. So if no one else gets this kind of behavior, off to Code Problems I go.