xml: added escape, unescape, validate subcommands

pages/common/xml-escape.md

@@ -3,6 +3,14 @@
 > XMLStarlet toolkit: Escape special XML characters.
 > More information: <https://http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
 
+- Escape special XML characters in a string:
+
+`xml escape {{"<a1>"}}`
+
+- Escape special XML characters in standard input:
+
+`echo  {{"<a1>"}} | xml escape`
+
 - Display help for `escape` subcommand:
 
 `xml escape --help`

pages/common/xml-unescape.md

@@ -3,6 +3,14 @@
 > XMLStarlet toolkit: Un-escape special XML characters.
 > More information: <https://http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
 
+- Unescape special XML characters from a string:
+
+`xml unescape {{"&lt;a1&gt;"}}`
+
+- Unescape special XML characters from standard input:
+
+`echo  {{"&lt;a1&gt;"}} | xml unescape`
+
 - Display help for `unescape` subcommand:
 
 `xml escape --help`

pages/common/xml-validate.md

@@ -1,7 +1,23 @@
 # xml-validate
 
 > XMLStarlet toolkit: Validate XML documents.
-> More information: <https://http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
+> More information: <http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
+
+- Validate XML document for well-formedness only (default):
+
+`xml validate --well-formed {{path/to/input1.xml|URI}} {{input2.xml ...}}`
+
+- Validate XML document against Document Type Definition (DTD):
+
+`xml validate --dtd {{path/to/schema.dtd}} {{path/to/input1.xml|URI}} {{input2.xml ...}}`
+
+- Validate XML document against XML Schema Definition (XSD):
+
+`xml validate --xsd {{path/to/schema.xsd}} {{path/to/input1.xml|URI}} {{input2.xml ...}}`
+
+- Validate XML document against a Relax NG schema (RNG):
+
+`xml validate --relaxng {{path/to/schema.rng}} {{path/to/input1.xml|URI}} {{input2.xml ...}}`
 
 - Display help for `validate` subcommand:
 

pages/common/xml.md

@@ -2,11 +2,11 @@
 
 > XMLStarlet toolkit: Query, edit, check, and transform XML documents.
 > Subcommands: `canonic`, `edit`, `elements`, `escape`, `format`, `list`, `pyx`, `p2x`, `select`, `transform`, `unescape`, or `validate`.
-> More information: <https://http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
+> More information: <http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
 
 - Execute a subcommand with input from a file or URI and using standard output:
 
-`xml {{subcommand}} {{options}} {{xml_file_or_uri}}`
+`xml {{subcommand}} {{options}} {{path/to/input.xml|URI}}`
 
 - Execute a subcommand using standard input and standard output:
 
@@ -14,7 +14,7 @@
 
 - Execute a subcommand with input from a file or URI and output to a file:
 
-`xml {{subcommand}} {{options}} {{xml_file_or_uri}} >{{path/to/output}}`
+`xml {{subcommand}} {{options}} {{path/to/input.xml|URI}} >{{path/to/output}}`
 
 - Display help for a subcommand: