1.add comments to ifShowAll parameter
2.add related reference for this