doc: tell user how to read the manual
doc: change listings style