expanded documentatio; made corrections
partially implemented eastern/western ordering in getName calls.