Changes to samples.xml, adding documentation, reordering for clarity.

Cleaning up samples.xml.   Changes are done as small commits and should make this file easier for people to gather information.
Could you revert these appendix to master?
(When these appendix are shown in Preferences, the white space and * mark are needed for visibility.)