cep17 final draft revision...

I think it is more or less in its final state. @scopatz - what is the next step?