xml: Changes requested by Starbeamrainbowlabs

pages/common/xml-canonic.md

@@ -1,20 +1,20 @@
-# xml-canonic
+# xml canonic
 
 > Make XML documents canonical.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
-- Make an XML document canonical, including comments (default):
+- Make an XML document canonical, preserving comments (default behavior):
 
 `xml canonic --with-comments {{path/to/input.xml|URI}} >{{path/to/output.xml}}`
 
-- Make an XML document canonical, without comments:
+- Make an XML document canonical, removing comments:
 
 `xml canonic --without-comments {{path/to/input.xml|URI}} >{{path/to/output.xml}}`
 
-- Exclusive XML canonicalization, using an XPATH from a file:
+- Exclusive XML canonicalization, using an XPATH from a file, preserving comments:
 
 `xml canonic --exc-with-comments {{path/to/input.xml|URI}} {{path/to/c14n.xpath}}`
 
-- Display help for `canonic` subcommand:
+- Display help for the `canonic` subcommand:
 
 `xml canonic --help`

pages/common/xml-depyx.md

@@ -1,4 +1,4 @@
-# xml-depyx
+# xml depyx
 
 > Convert a PYX (ESIS - ISO 8879) document to XML format.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
@@ -7,10 +7,10 @@
 
 `xml depyx {{path/to/input.pyx|URI}} >{{path/to/output.xml}}`
 
-- Convert a PYX document from standard input to XML format:
+- Convert a PYX document from the standard input to XML format:
 
 `cat {{path/to/input.pyx}} | xml depyx >{{path/to/output.xml}}`
 
-- Display help for `depyx` subcommand:
+- Display help for the `depyx` subcommand:
 
 `xml depyx --help`

pages/common/xml-edit.md

@@ -1,4 +1,4 @@
-# xml-edit
+# xml edit
 
 > Edit an XML document.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
@@ -23,6 +23,6 @@
 
 `xml edit`
 
-- Display help for `edit` subcommand:
+- Display help for the `edit` subcommand:
 
 `xml edit --help`

pages/common/xml-elements.md

@@ -1,21 +1,21 @@
-# xml-elements
+# xml elements
 
-> Extract elements and structure of an XML document.
+> Extract elements and display structure of an XML document.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
-- Extract elements of an XML document (as XPATH expressions):
+- Extract elements from an XML document (producing XPATH expressions):
 
 `xml elements {{path/to/input.xml|URI}} >{{path/to/elements}}`
 
-- Extract elements and attributes of an XML document:
+- Extract elements and attributes from an XML document:
 
 `xml elements -a {{path/to/input.xml|URI}} >{{path/to/elements}}`
 
-- Extract elements, attributes, and their values:
+- Extract elements, attributes, and their values from an XML doc:
 
 `xml elements -v {{path/to/input.xml|URI}} >{{path/to/elements}}`
 
-- Print sorted unique elements of an XML document (to see structure):
+- Print sorted unique elements from an XML document (to see structure):
 
 `xml elements -u {{path/to/input.xml|URI}}`
 
@@ -23,6 +23,6 @@
 
 `xml elements -d{{3}} {{path/to/input.xml|URI}}`
 
-- Display help for `elements` subcommand:
+- Display help for the `elements` subcommand:
 
 `xml elements --help`

pages/common/xml-escape.md

@@ -1,16 +1,16 @@
-# xml-escape
+# xml escape
 
 > Escape special XML characters.
 > More information: <http://xmlstar.sourceforge.net/doc/xmlstarlet.pdf>.
 
 - Escape special XML characters in a string:
 
-`xml escape {{"<a1>"}}`
+`xml escape "{{<a1>}}"`
 
-- Escape special XML characters in standard input:
+- Escape special XML characters from the standard input:
 
-`echo  {{"<a1>"}} | xml escape`
+`echo  "{{<a1>}}" | xml escape`
 
-- Display help for `escape` subcommand:
+- Display help for the `escape` subcommand:
 
 `xml escape --help`

pages/common/xml-format.md

@@ -1,4 +1,4 @@
-# xml-format
+# xml format
 
 > Format an XML document.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
@@ -15,7 +15,7 @@
 
 `xml format --recover --noindent {{path/to/malformed.xml|URI}} >{{path/to/recovered.xml}}`
 
-- Format an XML document from standard input, removing the DOCTYPE declaration:
+- Format an XML document from the standard input, removing the DOCTYPE declaration:
 
 `cat {{path\to\input.xml}} | xml format --dropdtd >{{path/to/output.xml}}`
 
@@ -23,6 +23,6 @@
 
 `xml format --omit-decl {{path\to\input.xml|URI}} >{{path/to/output.xml}}`
 
-- Display help for `format` subcommand:
+- Display help for the `format` subcommand:
 
 `xml format --help`

pages/common/xml-list.md

@@ -1,16 +1,16 @@
-# xml-list
+# xml list
 
-> List a directory as XML.
+> List a directory's contents in XML format.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
-- List the current directory to an XML file:
+- List the current directory's contents to an XML document:
 
 `xml list >{{path/to/dir_list.xml}}`
 
-- List the specified directory to an XML file:
+- List the specified directory's contents to an XML document:
 
 `xml list {{path/to/directory}} >{{path/to/dir_list.xml}}`
 
-- Display help for `list` subcommand:
+- Display help for the `list` subcommand:
 
 `xml list --help`

pages/common/xml-pyx.md

@@ -1,4 +1,4 @@
-# xml-pyx
+# xml pyx
 
 > Convert an XML document to PYX (ESIS - ISO 8879) format.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
@@ -7,10 +7,10 @@
 
 `xml pyx {{path/to/input.xml|URI}} >{{path/to/output.pyx}}`
 
-- Convert an XML document from standard input to PYX format:
+- Convert an XML document from the standard input to PYX format:
 
 `cat {{path/to/input.xml}} | xml pyx >{{path/to/output.pyx}}`
 
-- Display help for `pyx` subcommand:
+- Display help for the `pyx` subcommand:
 
 `xml pyx --help`

pages/common/xml-select.md

@@ -1,4 +1,4 @@
-# xml-select
+# xml select
 
 > Select from XML documents using XPATH.
 > More information: <http://xmlstar.sourceforge.net/doc/xmlstarlet.pdft>.
@@ -23,6 +23,6 @@
 
 `xml select`
 
-- Display help for `select` subcommand:
+- Display help for the `select` subcommand:
 
 `xml select --help`

pages/common/xml-transform.md

@@ -1,4 +1,4 @@
-# xml-transform
+# xml transform
 
 > Transform XML documents using XSLT.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
@@ -23,6 +23,6 @@
 
 `xml transform`
 
-- Display help for `transform` subcommand:
+- Display help for the `transform` subcommand:
 
 `xml transform --help`

pages/common/xml-unescape.md

@@ -1,16 +1,16 @@
-# xml-unescape
+# xml unescape
 
-> Un-escape special XML characters.
+> Unescape special XML characters.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
 - Unescape special XML characters from a string:
 
-`xml unescape {{"&lt;a1&gt;"}}`
+`xml unescape "{{&lt;a1&gt;}}"`
 
-- Unescape special XML characters from standard input:
+- Unescape special XML characters from the standard input:
 
-`echo  {{"&lt;a1&gt;"}} | xml unescape`
+`echo  "{{&lt;a1&gt;}}" | xml unescape`
 
-- Display help for `unescape` subcommand:
+- Display help for the `unescape` subcommand:
 
 `xml escape --help`

pages/common/xml-validate.md

@@ -1,24 +1,24 @@
-# xml-validate
+# xml validate
 
 > Validate XML documents.
 > More information: <http://xmlstar.sourceforge.net/docs.php>.
 
-- Validate XML document for well-formedness only (default):
+- Validate XML document(s) for well-formedness only (default behavior):
 
 `xml validate --well-formed {{path/to/input1.xml|URI}} {{input2.xml ...}}`
 
-- Validate XML document against Document Type Definition (DTD):
+- Validate XML document(s) against a 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):
+- Validate XML document(s) against an 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):
+- Validate XML document(s) 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:
+- Display help for the `validate` subcommand:
 
 `xml validate --help`

pages/common/xml.md

@@ -8,7 +8,7 @@
 
 `xml {{subcommand}} {{options}} {{path/to/input.xml|URI}}`
 
-- Execute a subcommand using standard input and standard output:
+- Execute a subcommand using the standard input and standard output:
 
 `xml {{subcommand}} {{options}}`