better documentation; long line removal
lattice and grid are suggested rather than depended