From 200fcc70f451e2fae1ad0003ed8f67f12a7111dd Mon Sep 17 00:00:00 2001 From: Danilo Bargen Date: Sun, 19 Dec 2021 17:50:14 +0100 Subject: [PATCH] Client spec: Introduce --list-all as replacement for "all" platform This is the cleaner approach, and it's easier to implement by the clients. It also avoids ambiguities in behavior in combination with other subcommands, see discussion in #7528. --- CLIENT-SPECIFICATION.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CLIENT-SPECIFICATION.md b/CLIENT-SPECIFICATION.md index 73e92e399c4eb1..671dba7335ea28 100644 --- a/CLIENT-SPECIFICATION.md +++ b/CLIENT-SPECIFICATION.md @@ -38,7 +38,8 @@ Option | Required? | Meaning `-v`, `--version` | Yes | Shows the current version of the client, and the version of this specification that it implements. `-p`, `--platform` | Yes | Specifies the platform to be used to perform the action (either listing or searching) as an argument. If this option is specified, the selected platform MUST be checked first instead of the current platform as described below. `-u`, `--update` | Conditional | Updates the offline cache of pages. MUST be implemented if cache is supported. -`-l`, `--list` | No | Lists all the pages in the current platform to the standard output. If the special platform `all` is specified a list of all pages in all platforms MUST be displayed. +`-l`, `--list` | No | Lists all the pages in the current platform to the standard output. + `--list-all` | No | Lists all the pages in all platforms to the standard output. `-L`, `--language` | No | Specifies the preferred language for the page returned. Overrides other language detection mechanisms. See the [language section](#language) for more information. Clients MAY choose to only implement the short version of an option, ignoring the long form.