spelling fix: lineUpContex -> lineUpContext
document 'trick' non-local causes of unusual measures
Merge pull request #858 from FranciscoBorges/documentation

Document unusual code, fix spelling in method's name