doc update + allow empty tweens + allow NULL equations