diff options
author | Oliver Kiddle <opk@users.sourceforge.net> | 2003-07-23 11:06:58 +0000 |
---|---|---|
committer | Oliver Kiddle <opk@users.sourceforge.net> | 2003-07-23 11:06:58 +0000 |
commit | c3a03617eadd35676dddbf54a73fe88381207cc1 (patch) | |
tree | fabb92ea9ed2792823964b0ce6eeaac7c95c2e4b /Etc | |
parent | 93141e69602eed4326cca3097cf0728a5ee7ec8f (diff) | |
download | zsh-c3a03617eadd35676dddbf54a73fe88381207cc1.tar.gz zsh-c3a03617eadd35676dddbf54a73fe88381207cc1.tar.xz zsh-c3a03617eadd35676dddbf54a73fe88381207cc1.zip |
18877: add note about supporting latest versions, tag names being plural etc
Diffstat (limited to 'Etc')
-rw-r--r-- | Etc/completion-style-guide | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/Etc/completion-style-guide b/Etc/completion-style-guide index e640a8b3e..ec4efe2ad 100644 --- a/Etc/completion-style-guide +++ b/Etc/completion-style-guide @@ -17,7 +17,8 @@ Coding style: isn't room for it (see the next point) in which case put it on the next line un-indented. -* Please try not to use lines longer than 79 characters. +* Please try not to use lines longer than 79 characters. Don't worry + about breaking long `_arguments' or `_values' specs though. Descriptions: @@ -49,6 +50,11 @@ for example, do not use: but use: '--timeout[specify connection timeout]:timeout (ms)' +Group descriptions should be singular because only one thing is being +completed even though many may be listed. This applies even where you +complete a list of the things. Tags, functions for completing types of +things (such as _files), and states should have plural names. + In a function, allow any descriptions passed as an argument to override the default you define. For example: _wanted directories expl directory _files -/ "$@" - @@ -65,6 +71,14 @@ matches which are completely opposite in their meaning if it shortens the completion listing provided that the names of the matches makes it clear what their effect is. +Command Versions: + +In most cases multiple versions (releases) of commands are not +supported. The functions are merely updated to reflect the latest stable +version. Exceptions to this can be made where are particular version +continues to be commonly distributed. Where there is more than one variant +of the same command however, the separate variants should be supported. + Contexts, tags and all that --------------------------- |