Can you explain how documentation is cryptic?

I skipped reading DESCRIPTION and just tried all the examples in the documentation

EXAMPLES
      xml_split foo.xml             # split at level 1
      xml_split -l 2 foo.xml        # split at level 2
      xml_split -c section foo.xml  # a file is generated for each sec
+tion element
                                    # nested sections are split proper
+ly
[download]

The 3rd example was what I (or the OP) wanted .