fix #872, with forward references and wordy description of syntax