Improve documentation of Function pointer issues. Minor updates to portability guidelines
FP issues now ready for review. Interacting with code now ready for review. Minor changes to the others.
Merge pull request #2736 from hamishwillee/incoming

Updates to interacting with code and function pointer issues