haddock comments for parseWithHeuristics