nushell/crates/nu-protocol/src
Stefan Holderbach 95b78eee25
Change the usage misnomer to "description" (#13598)
# Description
    
The meaning of the word usage is specific to describing how a command
function is *used* and not a synonym for general description. Usage can
be used to describe the SYNOPSIS or EXAMPLES sections of a man page
where the permitted argument combinations are shown or example *uses*
are given.
Let's not confuse people and call it what it is a description.

Our `help` command already creates its own *Usage* section based on the
available arguments and doesn't refer to the description with usage.

# User-Facing Changes

`help commands` and `scope commands` will now use `description` or
`extra_description`
`usage`-> `description`
`extra_usage` -> `extra_description`

Breaking change in the plugin protocol:

In the signature record communicated with the engine.
`usage`-> `description`
`extra_usage` -> `extra_description`

The same rename also takes place for the methods on
`SimplePluginCommand` and `PluginCommand`

# Tests + Formatting
- Updated plugin protocol specific changes
# After Submitting
- [ ] update plugin protocol doc
2024-08-22 12:02:08 +02:00
..
ast Fix $in in range expressions (#13447) 2024-07-25 18:28:44 +08:00
config Add completions.sort option (#13311) 2024-08-05 20:30:10 -04:00
debugger Overhaul $in expressions (#13357) 2024-07-17 16:02:42 -05:00
engine Change the usage misnomer to "description" (#13598) 2024-08-22 12:02:08 +02:00
errors Parse time type checking for range (#13595) 2024-08-13 15:05:34 +08:00
ir Make plugins able to find and call other commands (#13407) 2024-07-19 13:54:21 +08:00
pipeline Add --raw switch to print for binary data (#13597) 2024-08-12 17:29:25 +08:00
plugin Change the usage misnomer to "description" (#13598) 2024-08-22 12:02:08 +02:00
process Document public types in nu-protocol (#12906) 2024-07-11 13:30:12 +02:00
value Fix bugs and UB in bit shifting ops (#13663) 2024-08-22 11:54:27 +02:00
alias.rs Change the usage misnomer to "description" (#13598) 2024-08-22 12:02:08 +02:00
did_you_mean.rs Improve case insensitivity consistency (#10884) 2023-11-08 23:58:54 +01:00
eval_base.rs Overhaul $in expressions (#13357) 2024-07-17 16:02:42 -05:00
eval_const.rs Path migration part 3: $nu paths (#13368) 2024-08-01 10:16:31 +02:00
example.rs Overhaul the plugin cache file with a new msgpack+brotli format (#12579) 2024-04-21 07:36:26 -05:00
id.rs Internal representation (IR) compiler and evaluator (#13330) 2024-07-10 17:33:59 -07:00
lev_distance.rs Rework for new clippy lints (#12736) 2024-05-02 19:29:03 +02:00
lib.rs Add top-level crate documentation/READMEs (#12907) 2024-07-14 10:10:41 +02:00
module.rs Enable reloading changes to a submodule (#13170) 2024-06-25 18:33:37 -07:00
parser_path.rs Enable reloading changes to a submodule (#13170) 2024-06-25 18:33:37 -07:00
signature.rs Change the usage misnomer to "description" (#13598) 2024-08-22 12:02:08 +02:00
span.rs Document public types in nu-protocol (#12906) 2024-07-11 13:30:12 +02:00
syntax_shape.rs Make parsing for unknown args in known externals like normal external calls (#13414) 2024-07-21 01:32:36 -07:00
ty.rs Deprecate group in favor of chunks (#13377) 2024-07-16 03:49:00 +00:00