diff --git a/CLIENT-SPECIFICATION.md b/CLIENT-SPECIFICATION.md index 671dba7335ea28..eadc45a4e8b54c 100644 --- a/CLIENT-SPECIFICATION.md +++ b/CLIENT-SPECIFICATION.md @@ -38,8 +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. - `--list-all` | No | Lists all the pages in all platforms to the standard output. +`-l`, `--list` | No | Lists all the pages in the current platform to the standard output. It is RECOMMENDED that the pages are sorted alphanumerically. + `--list-all` | No | Lists all the pages in all platforms to the standard output. It is RECOMMENDED that the pages are sorted alphanumerically. `-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.