user guide formatting and links

added a few missing hyperlinks, and styled code as java (for coloring) and minor tweakd for emphasis