manual: document comments and extra fields.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>