Improve documentation of Function pointer issues. Minor updates to portability guidelines