doc: p-i-d: Various updates

* Streamline markup configuration
* Switch markup from '\\' to '@'
* Reduce use of `std::endl`
* Format `bool` Attribute default values (`true`, `false`) as code

Author: Peter Barnes