linkage code tidy

Major code tidy, and a little bit of TLC to the look'n'feel (but not too much).
Mostly trying to align the project with code standards.

linkage

The first offering .... I hope it serves you well.