utils: Update manpages for gsymcheck, gschlas

Update the manpages for both gsymcheck and gschlas to add the new long
format command line options, and also take the opportunity to fix some
of the formatting to align with man-pages(7) guidelines.