shell files updates, README fixes