Add a description of when to use a manual page reference and when to
use <command> to markup commands in SGML docbook.

PR: docs/52467
Submitted by: Simon L.Nielsen <simon@nitro.dk>
Discussed on: -doc