tweaking doco and adding omitLinearCombos function