doc: use @math{}
doc: use @ref{} as opposed to @code{} when referring to an option
reporting: @report: throw explicit error if user has not passed compiler option on Windows
reporting: @report: add compiler option to compile() as alternative method to pass compiler information
doc: comment example & and spacing to make more legible
reporting: aesthetic change