#3222 fixed layout of figures
#3222 many small fixes to docu. Mainly layout and figure numbering