added performStop option

performStop added - see docs for more details
changed doc style
Updated the documentation

Updated the code docs to use DOX as documentation tool
Unmerged problems