Update docs on shadowing.
Add a pending spec for function reordering.