added isFarkled for semantics
renamed a var and doc'd for clarity. no functional changes.