the doc at the top is a red herring. it describes the problem, but hasn't been updated based on the rest of the discussion i had with myself in that thread