finished this pass

added ref.s, fixed figures, small edits in example.