wikibase-cli 19.4.2 → 20.1.0

package/metadata/edit-entity.js

@@ -8,23 +8,23 @@ export default {
   examples: [
     {
       args: "'{\"id\":\"Q4115189\",\"labels\":{\"en\":\"a label\",\"fr\":\"un label\"},\"descriptions\":{\"en\":\"some description\",\"fr\":\"une description\"},\"claims\":{\"P1775\":[\"Q3576110\",\"Q12206942\"],\"P2002\":\"bulgroz\"}}'",
-      comment: 'pass data as JSON',
+      comment: 'Pass data as JSON',
     },
     {
       args: './existing_item_data.json',
-      comment: 'pass data as a JSON file path',
+      comment: 'Pass data as a JSON file path',
     },
     {
       args: './existing_item_data.js',
-      comment: 'pass data from a JS module exporting an object',
+      comment: 'Pass data from a JS module exporting an object',
     },
     {
       args: './existing_item_data.js Q123 abc 456',
-      comment: 'pass data from a JS module exporting a function (the additional arguments will be passed to the function)',
+      comment: 'Pass data from a JS module exporting a function (the additional arguments will be passed to the function)',
     },
     {
       args: './existing_item_data.json --instance http://some/wikibase/instance/w/api.php --sparql-endpoint http://some/sparql/endpoint',
-      comment: 'in case you use are not editing wikidata.org, make sure to specify the custom Wikibase instance and its SPARQL endpoint, as claims formatting and validation will depend on properties types that are retrieved from the SPARQL endpoint',
+      comment: 'In case you use are not editing wikidata.org, make sure to specify the custom Wikibase instance and its SPARQL endpoint, as claims formatting and validation will depend on properties types that are retrieved from the SPARQL endpoint',
     },
   ],
 }

package/metadata/generate-template.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'gt',
   args: '<entity>',
-  description: "output the pre-formatted item's data optimized for edition with `wd edit-item`",
+  description: "Output the pre-formatted item's data optimized for edition with `wd edit-item`",
   options: {
     lang: false,
     verbose: false,
@@ -11,10 +11,10 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Q123', comment: 'get Q123 pre-formatted data' },
-    { args: 'Q123 --props claims,sitelinks', comment: 'only get data required to edit the claims and sitelinks' },
-    { args: 'Q123 --props claims.P31,sitelinks.frwiki', comment: 'only get data required to edit the P31 claims and the frwiki sitelink' },
-    { args: 'Q123 --format js', comment: 'get the template in JS (easier to edit manually than JSON and still compatible with create-entity and edit-entity commands)' },
-    { args: 'Q123 Q124 Q125', comment: 'get several templates at once as NDJSON' },
+    { args: 'Q123', comment: 'Get Q123 pre-formatted data' },
+    { args: 'Q123 --props claims,sitelinks', comment: 'Only get data required to edit the claims and sitelinks' },
+    { args: 'Q123 --props claims.P31,sitelinks.frwiki', comment: 'Only get data required to edit the P31 claims and the frwiki sitelink' },
+    { args: 'Q123 --format js', comment: 'Get the template in JS (easier to edit manually than JSON and still compatible with create-entity and edit-entity commands)' },
+    { args: 'Q123 Q124 Q125', comment: 'Get several templates at once as NDJSON' },
   ],
 }

package/metadata/graph-path.js

@@ -0,0 +1,18 @@
+export default {
+  alias: 'gp',
+  args: '<subject> <property> <object>',
+  description: 'Find the path between a subject and an object via a given property, on the entities relations graph',
+  options: {
+    lang: true,
+    verbose: true,
+    clipboard: false,
+    json: false,
+    instance: false,
+    sparqlEndpoint: true,
+  },
+  examples: [
+    { args: 'Q336 P279 Q5891', comment: 'Find by which path science (Q336) is a subclass of (P279) philosophy (Q5891)' },
+    { args: 'Q336 P279 Q5891,Q2198855,Q3326717,Q968159', comment: 'Find by which path science (Q336) is a subclass of (P279) either philosophy (Q5891), literary movement (Q3326717), or art movement (Q968159)' },
+    { args: 'wd gp Q506259 P279 Q2509280 --format mermaid | mermaid-ascii -f -', comment: 'Output graph in the [mermaid format](https://mermaid.js.org/) and pipe it to [mermaid-ascii](https://github.com/AlexanderGrooff/mermaid-ascii) to visualize the graph in the terminal' },
+  ],
+}

package/metadata/id.js

@@ -1,6 +1,6 @@
 export default {
   args: '<title>',
-  description: 'get a Wikidata id from a Wikipedia article title',
+  description: 'Get a Wikidata id from a Wikipedia article title',
   options: {
     lang: true,
     verbose: true,
@@ -10,7 +10,7 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Cantabria', comment: 'get the Wikidata id corresponding to the article "Cantabria" in Wikipedia' },
-    { args: 'science politique --lang fr', comment: 'get the Wikidata id corresponding to the article "science politique" in the French Wikipedia' },
+    { args: 'Cantabria', comment: 'Get the Wikidata id corresponding to the article "Cantabria" in Wikipedia' },
+    { args: 'science politique --lang fr', comment: 'Get the Wikidata id corresponding to the article "science politique" in the French Wikipedia' },
   ],
 }

package/metadata/label.js

@@ -3,11 +3,11 @@ import { entityAttributeCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'l',
   args: '<entity>',
-  description: "display the entity's label",
+  description: "Display the entity's label",
   options: entityAttributeCommandsOptions,
   examples: [
-    { args: 'Q123', comment: 'fetch the label for the entity Q123' },
-    { args: 'Q123 --lang ja', comment: 'fetch the label for the entity Q123 in Japanese' },
-    { args: 'Q1 Q2 Q3 P6', comment: 'fetch labels for several entities' },
+    { args: 'Q123', comment: 'Fetch the label for the entity Q123' },
+    { args: 'Q123 --lang ja', comment: 'Fetch the label for the entity Q123 in Japanese' },
+    { args: 'Q1 Q2 Q3 P6', comment: 'Fetch labels for several entities' },
   ],
 }

package/metadata/lang.js

@@ -1,6 +1,6 @@
 export default {
   args: '<language code or wikidata id>',
-  description: 'identify language code and return associated data',
+  description: 'Identify language code and return associated data',
   options: {
     lang: false,
     verbose: false,
@@ -10,7 +10,7 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'ak', comment: 'find data associated with the Akan language from its language code' },
-    { args: 'Q28026', comment: 'find data associated with the Akan language from its Wikidata item id' },
+    { args: 'ak', comment: 'Find data associated with the Akan language from its language code' },
+    { args: 'Q28026', comment: 'Find data associated with the Akan language from its Wikidata item id' },
   ],
 }

package/metadata/lemma.js

@@ -2,10 +2,10 @@ import { entityAttributeCommandsOptions } from '#lib/common_options'
 
 export default {
   args: '<lexeme>',
-  description: "display the lexeme's lemma",
+  description: "Display the lexeme's lemma",
   options: entityAttributeCommandsOptions,
   examples: [
-    { args: 'L525', comment: 'fetch the lemma for the lexeme L525' },
-    { args: 'L525 --lang ja', comment: 'fetch the lemma for the lexeme L525 in Japanese' },
+    { args: 'L525', comment: 'Fetch the lemma for the lexeme L525' },
+    { args: 'L525 --lang ja', comment: 'Fetch the lemma for the lexeme L525 in Japanese' },
   ],
 }

package/metadata/merge-entity.js

@@ -8,7 +8,7 @@ export default {
   examples: [
     {
       args: 'Q1 Q2',
-      comment: 'merge Q1 into Q2',
+      comment: 'Merge Q1 into Q2',
     },
   ],
 }

package/metadata/move-claim.js

@@ -3,14 +3,14 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'mc',
   args: '<guid|property-claims-id> <target-entity-id> <target-property-id>',
-  description: 'move claims from an entity to another and/or from a property to another',
+  description: 'Move claims from an entity to another and/or from a property to another',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q4115189 P20", comment: 'change the property of a claim (without changing entity)' },
-    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q13406268 P19", comment: 'move the claim to another entity (without changing the property)' },
-    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q13406268 P20", comment: 'move the claim to another entity and another property' },
-    { args: "'Q4115189#P19' Q4115189 P20", comment: 'move all Q4115189 P19 claims to P20 (without changing entity)' },
-    { args: "'Q4115189#P19' Q13406268 P19", comment: 'move all Q4115189 P19 claims to Q13406268 (without changing the property)' },
-    { args: "'Q4115189#P19' Q13406268 P20", comment: 'move all Q4115189 P19 claims to Q13406268 P20' },
+    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q4115189 P20", comment: 'Change the property of a claim (without changing entity)' },
+    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q13406268 P19", comment: 'Move the claim to another entity (without changing the property)' },
+    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' Q13406268 P20", comment: 'Move the claim to another entity and another property' },
+    { args: "'Q4115189#P19' Q4115189 P20", comment: 'Move all Q4115189 P19 claims to P20 (without changing entity)' },
+    { args: "'Q4115189#P19' Q13406268 P19", comment: 'Move all Q4115189 P19 claims to Q13406268 (without changing the property)' },
+    { args: "'Q4115189#P19' Q13406268 P20", comment: 'Move all Q4115189 P19 claims to Q13406268 P20' },
   ],
 }

package/metadata/move-qualifier.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'mq',
   args: '<guid> [hash] <old-property-id> <new-property-id>',
-  description: 'move qualifiers of a claim from one property to another',
+  description: 'Move qualifiers of a claim from one property to another',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' P2310 P2311", comment: 'move all P2310 qualifiers of this claim to P2311' },
-    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' 90b9b567dc01112e7d9dee98eb5f5ad50ae803bb P2310 P2311", comment: 'move only the P2310 qualifier with this hash to P2311' },
+    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' P2310 P2311", comment: 'Move all P2310 qualifiers of this claim to P2311' },
+    { args: "'Q4115189$13681798-47F7-4D51-B3B4-BA8C7E044E1F' 90b9b567dc01112e7d9dee98eb5f5ad50ae803bb P2310 P2311", comment: 'Move only the P2310 qualifier with this hash to P2311' },
   ],
 }

package/metadata/open.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'o',
   args: '<entity>',
-  description: "open the entity's page on Wikidata website",
+  description: "Open the entity's page on Wikidata website",
   options: {
     lang: true,
     verbose: true,
@@ -11,16 +11,16 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Q44559', comment: 'open https://www.wikidata.org/entity/Q44559 in your default browser' },
-    { args: 'P123', comment: 'open https://www.wikidata.org/entity/P123' },
-    { args: 'L525', comment: 'open https://www.wikidata.org/entity/L525' },
-    { args: 'L525-F1', comment: 'open https://www.wikidata.org/entity/L525-F1' },
-    { args: 'L525-S1', comment: 'open https://www.wikidata.org/entity/L525-S1' },
-    { args: 'Q44559 --history', comment: 'open the entity history page' },
-    { args: 'Q44559 --revision 942578737', comment: 'open the entity page at a given revision' },
-    { args: 'Q44559 --wikipedia', comment: 'open the article on Exoplanets in Wikipedia' },
-    { args: 'Q44559 --wikipedia --lang pt', comment: 'open the article on Exoplanets in the Portugese Wikipedia' },
-    { args: 'Q44559 --url', comment: 'outputs the URL without opening the browser' },
-    { args: 'Q44559 L525 P123', comment: 'open several pages at once' },
+    { args: 'Q44559', comment: 'Open https://www.wikidata.org/entity/Q44559 in your default browser' },
+    { args: 'P123', comment: 'Open https://www.wikidata.org/entity/P123' },
+    { args: 'L525', comment: 'Open https://www.wikidata.org/entity/L525' },
+    { args: 'L525-F1', comment: 'Open https://www.wikidata.org/entity/L525-F1' },
+    { args: 'L525-S1', comment: 'Open https://www.wikidata.org/entity/L525-S1' },
+    { args: 'Q44559 --history', comment: 'Open the entity history page' },
+    { args: 'Q44559 --revision 942578737', comment: 'Open the entity page at a given revision' },
+    { args: 'Q44559 --wikipedia', comment: 'Open the article on Exoplanets in Wikipedia' },
+    { args: 'Q44559 --wikipedia --lang pt', comment: 'Open the article on Exoplanets in the Portugese Wikipedia' },
+    { args: 'Q44559 --url', comment: 'Outputs the URL without opening the browser' },
+    { args: 'Q44559 L525 P123', comment: 'Open several pages at once' },
   ],
 }

package/metadata/props.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'p',
   args: '',
-  description: 'output the list of all Wikidata properties',
+  description: 'Output the list of all Wikidata properties',
   options: {
     lang: true,
     verbose: true,
@@ -11,14 +11,14 @@ export default {
     sparqlEndpoint: true,
   },
   examples: [
-    { args: '', comment: 'output all the properties and their labels' },
-    { args: '--type', comment: 'output all properties, with their labels, types' },
-    { args: '--details', comment: 'output all properties, with their labels, types, descriptions, and aliases' },
-    { args: 'image', comment: 'filter the properties to keep only those with labels matching "image"' },
-    { args: '--type Url', comment: 'filter the properties to keep only those of type Url (other possible types: ExternalId, String, WikibaseItem, WikibaseProperty, Time, Monolingualtext, Quantity, CommonsMedia, GlobeCoordinate)' },
-    { args: '--type Url ref', comment: 'filter the properties to keep only those of type Url matching the pattern "ref"' },
-    { args: '--lang sv', comment: 'output all the properties with their label in Swedish' },
-    { args: '--no-cache', comment: 'ignore properties cache: fetch properties from the SPARQL endpoint, even if already cached' },
-    { args: '--reset', comment: 'delete all the cached properties files to get fresh versions on the next execution' },
+    { args: '', comment: 'Output all the properties and their labels' },
+    { args: '--type', comment: 'Output all properties, with their labels, types' },
+    { args: '--details', comment: 'Output all properties, with their labels, types, descriptions, and aliases' },
+    { args: 'image', comment: 'Filter the properties to keep only those with labels matching "image"' },
+    { args: '--type Url', comment: 'Filter the properties to keep only those of type Url (other possible types: ExternalId, String, WikibaseItem, WikibaseProperty, Time, Monolingualtext, Quantity, CommonsMedia, GlobeCoordinate)' },
+    { args: '--type Url ref', comment: 'Filter the properties to keep only those of type Url matching the pattern "ref"' },
+    { args: '--lang sv', comment: 'Output all the properties with their label in Swedish' },
+    { args: '--no-cache', comment: 'Ignore properties cache: fetch properties from the SPARQL endpoint, even if already cached' },
+    { args: '--reset', comment: 'Delete all the cached properties files to get fresh versions on the next execution' },
   ],
 }

package/metadata/query.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'q',
   args: '',
-  description: "generate and run a simple SPARQL query by passing a statement's subject, property, or object, or a couple of those",
+  description: "Generate and run a simple SPARQL query by passing a statement's subject, property, or object, or a couple of those",
   options: {
     lang: true,
     verbose: true,
@@ -11,20 +11,20 @@ export default {
     sparqlEndpoint: true,
   },
   examples: [
-    { args: '--property P2002 --object timberners_lee', comment: 'find out which entity as the twitter username (P2002) "timberners_lee"' },
-    { args: '--property P921 --object Q44559 --labels', comment: 'find out which works have exoplanets (Q44559) for main subject (P921)\n    # and include labels' },
-    { args: '--property P7476 --count', comment: 'get a list of all the claims using the property (P7476)' },
-    { args: '-p P921 -o Q44559 -a', comment: 'as always, you can also use the short options syntax' },
-    { args: "-p P921 -o Q44559 -a | jq '.[]' -cr", comment: 'the output is valid JSON, so you can pipe it to any JSON parser you like\n    # (here jq https://jqlang.github.io/jq/)' },
-    { args: '-s Q15228 -p P674 -a', comment: 'find out which are the characters (P674) in The Lord of The Ring (Q15228)' },
-    { args: '-s Q15228 -o Q177499 -a', comment: 'find out which property link The Lord of The Ring (Q15228) and Gandalf (Q177499)' },
-    { args: '-s Q177499 -a', comment: 'get the properties and objects for all the triples (subject, property, object) having Gandalf (Q177499) as subject' },
-    { args: '.-p P31 -o Q44559 --format csv', comment: "set an alternative output format: json, xml, tsv, csv, binrdf, table. Default: 'table' when 1 value is selected, 'json' otherwise" },
-    { args: '-p P31 -o Q44559 --limit 5', comment: 'use the limit option to get only 5 instances of exoplanets (Q44559)' },
-    { args: '-p P31 -o Q44559 --limit 5 --verbose', comment: 'use the verbose option to see the generated SPARQL and the generated query URL' },
-    { args: '-p P31 -o Q44559 --limit 5 --dry', comment: 'simply output the generated SPARQL, without running the query' },
-    { args: '-p P31 -o Q44559 --limit 5 --open', comment: 'open the query in the Query Service GUI' },
+    { args: '--property P2002 --object timberners_lee', comment: 'Find out which entity as the twitter username (P2002) "timberners_lee"' },
+    { args: '--property P921 --object Q44559 --labels', comment: 'Find out which works have exoplanets (Q44559) for main subject (P921)\n    # and include labels' },
+    { args: '--property P7476 --count', comment: 'Get a list of all the claims using the property (P7476)' },
+    { args: '-p P921 -o Q44559 -a', comment: 'As always, you can also use the short options syntax' },
+    { args: "-p P921 -o Q44559 -a | jq '.[]' -cr", comment: 'The output is valid JSON, so you can pipe it to any JSON parser you like\n    # (here jq https://jqlang.github.io/jq/)' },
+    { args: '-s Q15228 -p P674 -a', comment: 'Find out which are the characters (P674) in The Lord of The Ring (Q15228)' },
+    { args: '-s Q15228 -o Q177499 -a', comment: 'Find out which property link The Lord of The Ring (Q15228) and Gandalf (Q177499)' },
+    { args: '-s Q177499 -a', comment: 'Get the properties and objects for all the triples (subject, property, object) having Gandalf (Q177499) as subject' },
+    { args: '.-p P31 -o Q44559 --format csv', comment: "Set an alternative output format: json, xml, tsv, csv, binrdf, table. Default: 'table' when 1 value is selected, 'json' otherwise" },
+    { args: '-p P31 -o Q44559 --limit 5', comment: 'Use the limit option to get only 5 instances of exoplanets (Q44559)' },
+    { args: '-p P31 -o Q44559 --limit 5 --verbose', comment: 'Use the verbose option to see the generated SPARQL and the generated query URL' },
+    { args: '-p P31 -o Q44559 --limit 5 --dry', comment: 'Simply output the generated SPARQL, without running the query' },
+    { args: '-p P31 -o Q44559 --limit 5 --open', comment: 'Open the query in the Query Service GUI' },
     { args: '--sample --sparql-endpoint https://bnb.data.bl.uk/sparql --format table', comment: 'Get a sample of triples from a triple store' },
-    { args: '--sparql-endpoint https://bnb.data.bl.uk/sparql --describe http://bnb.data.bl.uk/id/person/OBrienJim1950- --format table', comment: 'make a DESCRIBE request' },
+    { args: '--sparql-endpoint https://bnb.data.bl.uk/sparql --describe http://bnb.data.bl.uk/id/person/OBrienJim1950- --format table', comment: 'Make a DESCRIBE request' },
   ],
 }

package/metadata/remove-alias.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'ra',
   args: '<entity> <language> <aliases>',
-  description: 'remove one or several aliases from the list of aliases of an entity in a given language',
+  description: 'Remove one or several aliases from the list of aliases of an entity in a given language',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q4115189 fr foo', comment: "remove 'foo' from the Sandbox entity (Q4115189) French aliases" },
-    { args: 'Q4115189 fr "foo|bar|buzz', comment: "remove 'foo', 'bar', and 'buzz' from the Sandbox entity (Q4115189) French aliases" },
+    { args: 'Q4115189 fr foo', comment: "Remove 'foo' from the Sandbox entity (Q4115189) French aliases" },
+    { args: 'Q4115189 fr "foo|bar|buzz', comment: "Remove 'foo', 'bar', and 'buzz' from the Sandbox entity (Q4115189) French aliases" },
   ],
 }

package/metadata/remove-badge.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rb',
   args: '<entity> <site> [badges]',
-  description: 'remove badges on an existing sitelink',
+  description: 'Remove badges on an existing sitelink',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 enwikiquote Q17437796,Q17437798', comment: 'Remove Q17437796 and Q17437798 badges on Q4115189 enwikiquote sitelink' },

package/metadata/remove-claim.js

@@ -3,9 +3,9 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rc',
   args: '<guids>',
-  description: 'remove claims by their GUIDs',
+  description: 'Remove claims by their GUIDs',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q71$BD9A4A9F-E3F9-43D4-BFDB-484984A87FD7', comment: 'remove this claim made on Q71' },
+    { args: 'Q71$BD9A4A9F-E3F9-43D4-BFDB-484984A87FD7', comment: 'Remove this claim made on Q71' },
   ],
 }

package/metadata/remove-description.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rd',
   args: '<entity> <language>',
-  description: 'remove a description on an entity for a given language',
+  description: 'Remove a description on an entity for a given language',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 it', comment: 'Remove Q4115189 description in Italian' },

package/metadata/remove-label.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rl',
   args: '<entity> <language>',
-  description: 'remove a label on an entity for a given language',
+  description: 'Remove a label on an entity for a given language',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 it', comment: 'Remove Q4115189 label in Italian' },

package/metadata/remove-qualifier.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rq',
   args: '<claim-guid> <qualifiers-hashes>',
-  description: 'remove qualifiers from a claim',
+  description: 'Remove qualifiers from a claim',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '24aa18192de7051f81d88d1ab514826002d51c14'", comment: 'remove a qualifier from this claim' },
-    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '24aa18192de7051f81d88d1ab514826002d51c14|f6c14e4eebb3d4f7595f0952c1ece0a34d85368b'", comment: 'remove several qualifiers from this claim' },
+    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '24aa18192de7051f81d88d1ab514826002d51c14'", comment: 'Remove a qualifier from this claim' },
+    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '24aa18192de7051f81d88d1ab514826002d51c14|f6c14e4eebb3d4f7595f0952c1ece0a34d85368b'", comment: 'Remove several qualifiers from this claim' },
   ],
 }

package/metadata/remove-reference.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rr',
   args: '<claim-guid> <references-hashes>',
-  description: 'remove references from a claim',
+  description: 'Remove references from a claim',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '72ea3cdd27062da9f0971c1feab6df32d729ecb3'", comment: 'remove a reference from this claim' },
-    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '72ea3cdd27062da9f0971c1feab6df32d729ecb3|5e9840f6896948b13d6e9c6328169643229aa3db'", comment: 'remove several references from this claim' },
+    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '72ea3cdd27062da9f0971c1feab6df32d729ecb3'", comment: 'Remove a reference from this claim' },
+    { args: "'Q4115189$E51978A1-D13A-4916-800E-74ACD2466970' '72ea3cdd27062da9f0971c1feab6df32d729ecb3|5e9840f6896948b13d6e9c6328169643229aa3db'", comment: 'Remove several references from this claim' },
   ],
 }

package/metadata/remove-sitelink.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'rs',
   args: '<entity> <site>',
-  description: 'remove a sitelink on an entity for a given site',
+  description: 'Remove a sitelink on an entity for a given site',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 enwikiquote', comment: 'Remove the link from Q4115189 to any article in the English Wikiquote' },

package/metadata/revisions.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'r',
   args: '<entity>',
-  description: "output the entity's revisions data",
+  description: "Output the entity's revisions data",
   options: {
     lang: false,
     verbose: false,
@@ -11,9 +11,9 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Q3548931', comment: "fetch Q3548931's revisions data" },
-    { args: 'Q3548931 -p content,user,ids,comment,timestamp,flags,oresscores', comment: "fetch only certain attributes from Q3548931's revisions data" },
-    { args: 'Q3548931 -u InventaireBot', comment: "fetch Q3548931's revisions data from the user InventaireBot" },
-    { args: 'Property:P31', comment: "fetch P31's revisions data" },
+    { args: 'Q3548931', comment: "Fetch Q3548931's revisions data" },
+    { args: 'Q3548931 -p content,user,ids,comment,timestamp,flags,oresscores', comment: "Fetch only certain attributes from Q3548931's revisions data" },
+    { args: 'Q3548931 -u InventaireBot', comment: "Fetch Q3548931's revisions data from the user InventaireBot" },
+    { args: 'Property:P31', comment: "Fetch P31's revisions data" },
   ],
 }

package/metadata/search.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'f',
   args: '<search>',
-  description: 'search entities',
+  description: 'Search entities',
   options: {
     lang: true,
     verbose: true,
@@ -11,10 +11,10 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Ligo', comment: 'displays a list of entities matching "Ligo"' },
-    { args: 'Harry Potter --limit 25', comment: 'displays up to 25 results matching "Harry Potter"' },
-    { args: 'Harry Potter --verbose', comment: 'display rich results (aka summaries)' },
-    { args: 'Harry Potter --properties P577,P935', comment: 'request additional properties (separated by a comma) to be added to the results summaries' },
+    { args: 'Ligo', comment: 'Displays a list of entities matching "Ligo"' },
+    { args: 'Harry Potter --limit 25', comment: 'Displays up to 25 results matching "Harry Potter"' },
+    { args: 'Harry Potter --verbose', comment: 'Display rich results (aka summaries)' },
+    { args: 'Harry Potter --properties P577,P935', comment: 'Request additional properties (separated by a comma) to be added to the results summaries' },
     { args: 'date --type property', comment: 'Search properties (but `wb props` might be doing a better job)' },
     { args: 'date --type lexeme', comment: 'Search lexemes' },
     { args: 'code --type form', comment: 'Search forms' },

package/metadata/set-alias.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'sa',
   args: '<entity> <language> <aliases>',
-  description: 'set the list of aliases of an entity in a given language',
+  description: 'Set the list of aliases of an entity in a given language',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q4115189 fr foo', comment: "replaces the Sandbox entity (Q4115189) French aliases by 'foo'" },
-    { args: 'Q4115189 fr "foo|bar|buzz', comment: "replaces the Sandbox entity (Q4115189) French aliases by foo', 'bar', and 'buzz'" },
+    { args: 'Q4115189 fr foo', comment: "Replaces the Sandbox entity (Q4115189) French aliases by 'foo'" },
+    { args: 'Q4115189 fr "foo|bar|buzz', comment: "Replaces the Sandbox entity (Q4115189) French aliases by foo', 'bar', and 'buzz'" },
   ],
 }

package/metadata/set-description.js

@@ -3,9 +3,9 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'sd',
   args: '<entity> <language> <description>',
-  description: 'set a description on an entity in a given language',
+  description: 'Set a description on an entity in a given language',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q4115189 fr "description du Bac à sable bulgroz"', comment: "set the description 'description du Bac à sable bulgroz' to the Sandbox entity (Q4115189) in French" },
+    { args: 'Q4115189 fr "description du Bac à sable bulgroz"', comment: "Set the description 'description du Bac à sable bulgroz' to the Sandbox entity (Q4115189) in French" },
   ],
 }

package/metadata/set-label.js

@@ -3,9 +3,9 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'sl',
   args: '<entity> <language> <label>',
-  description: 'set a label on an entity in a given language',
+  description: 'Set a label on an entity in a given language',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q4115189 fr "Bac à sable bulgroz"', comment: "set the label 'Bac à sable bulgroz' to the Sandbox entity (Q4115189) in French" },
+    { args: 'Q4115189 fr "Bac à sable bulgroz"', comment: "Set the label 'Bac à sable bulgroz' to the Sandbox entity (Q4115189) in French" },
   ],
 }

package/metadata/set-sitelink.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'ss',
   args: '<entity> <site> <title> [badges]',
-  description: 'set a sitelink on an entity for a given site',
+  description: 'Set a sitelink on an entity for a given site',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 enwikiquote "The Sandbox"', comment: "Link Q4115189 to the article 'The Sandbox' on the English Wikiquote" },

package/metadata/sparql.js

@@ -1,7 +1,7 @@
 export default {
   alias: 's',
   args: '<file.rq>',
-  description: 'run a SPARQL query and get its JSON output',
+  description: 'Run a SPARQL query and get its JSON output',
   options: {
     lang: false,
     verbose: true,
@@ -11,13 +11,13 @@ export default {
     sparqlEndpoint: true,
   },
   examples: [
-    { args: './path/to/query.rq', comment: 'make a SPARQL request from a file' },
-    { args: './path/to/query_template.js Q123 Q456', comment: 'generate a SPARQL request from a template' },
-    { args: './path/to/query.rq > ./results.json ', comment: 'output it in a file instead of the terminal' },
-    { args: './path/to/query.rq --raw', comment: 'get the raw JSON results as query.wikidata.org outputs them, instead of a simplified version' },
-    { args: './path/to/query.rq --format csv', comment: "set an alternative output format: json, xml, tsv, csv, binrdf, table. Default: 'table' when 1 value is selected, 'json' otherwise" },
-    { args: './path/to/query.rq --index someVariableName', comment: 'get the results indexed by one of the SELECTed variables' },
-    { args: './path/to/query.rq --dry', comment: 'output the SPARQL without running the query' },
-    { args: './path/to/query.rq --open', comment: 'open the query in the Query Service GUI' },
+    { args: './path/to/query.rq', comment: 'Make a SPARQL request from a file' },
+    { args: './path/to/query_template.js Q123 Q456', comment: 'Generate a SPARQL request from a template' },
+    { args: './path/to/query.rq > ./results.json ', comment: 'Output it in a file instead of the terminal' },
+    { args: './path/to/query.rq --raw', comment: 'Get the raw JSON results as query.wikidata.org outputs them, instead of a simplified version' },
+    { args: './path/to/query.rq --format csv', comment: "Set an alternative output format: json, xml, tsv, csv, binrdf, table. Default: 'table' when 1 value is selected, 'json' otherwise" },
+    { args: './path/to/query.rq --index someVariableName', comment: 'Get the results indexed by one of the SELECTed variables' },
+    { args: './path/to/query.rq --dry', comment: 'Output the SPARQL without running the query' },
+    { args: './path/to/query.rq --open', comment: 'Open the query in the Query Service GUI' },
   ],
 }

package/metadata/summary.js

@@ -3,11 +3,11 @@ import { entityAttributeCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'u',
   args: '<entity>',
-  description: 'display basic information on the requested entity',
+  description: 'Display basic information on the requested entity',
   options: Object.assign({ clipboard: false }, entityAttributeCommandsOptions),
   examples: [
-    { args: 'Q123', comment: 'display basic information for the entity Q123' },
-    { args: 'Q123 --lang ja', comment: 'display basic information for the entity Q123 in Japanese' },
-    { args: 'Q1 -p P3219,P2612', comment: 'display the summary with additional properties' },
+    { args: 'Q123', comment: 'Display basic information for the entity Q123' },
+    { args: 'Q123 --lang ja', comment: 'Display basic information for the entity Q123 in Japanese' },
+    { args: 'Q1 -p P3219,P2612', comment: 'Display the summary with additional properties' },
   ],
 }

package/metadata/update-claim.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'uc',
   args: '<guid> <new-value>',
-  description: "update a claim's value",
+  description: "Update a claim's value",
   options: Object.assign({ rank: true }, editCommandsOptions),
   examples: [
-    { args: 'Q4115189$bc43ae33-7525-42cb-ad31-b1e1cf3cb72d Bulgroz', comment: "update the claim identified by this id with the value 'Bulgroz'" },
-    { args: 'Q4115189 P2002 Zorglub Bulgroz', comment: "change the the Sandbox (Q4115189) Twitter account (P2002) from 'Zorglub' to 'Bulgroz'" },
+    { args: 'Q4115189$bc43ae33-7525-42cb-ad31-b1e1cf3cb72d Bulgroz', comment: "Update the claim identified by this id with the value 'Bulgroz'" },
+    { args: 'Q4115189 P2002 Zorglub Bulgroz', comment: "Change the the Sandbox (Q4115189) Twitter account (P2002) from 'Zorglub' to 'Bulgroz'" },
   ],
 }

package/metadata/update-qualifier.js

@@ -3,14 +3,14 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'uq',
   args: '<claim-guid> <property> <old-value> <new-value>',
-  description: 'update a qualifier from an existing value to a new value',
+  description: 'Update a qualifier from an existing value to a new value',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P155 'Q13406268' 'Q3576110'", comment: 'entity qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P1545 'A-123' 'B-123'", comment: 'string qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P580 '1802-02-26' ''1802-02-27'", comment: 'time qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 123 124", comment: 'quantity qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 'amount=123&unit=Q4916' 'amount=124&unit=Q4916'", comment: 'quantity qualifier with a unit' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P3132 'text=aaah&language=fr' 'text=ach sooo&language=de'", comment: 'monolingualtext qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P155 'Q13406268' 'Q3576110'", comment: 'Entity qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P1545 'A-123' 'B-123'", comment: 'String qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P580 '1802-02-26' ''1802-02-27'", comment: 'Time qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 123 124", comment: 'Quantity qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 'amount=123&unit=Q4916' 'amount=124&unit=Q4916'", comment: 'Quantity qualifier with a unit' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P3132 'text=aaah&language=fr' 'text=ach sooo&language=de'", comment: 'Monolingualtext qualifier' },
   ],
 }