This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Shell 3.3.3!spring-doc.cn

Help

Running a shell application often implies that the user is in a graphically limited environment. Also, while we are nearly always connected in the era of mobile phones, accessing a web browser or any other rich UI application (such as a PDF viewer) may not always be possible. This is why it is important that the shell commands are correctly self-documented, and this is where the help command comes in.spring-doc.cn

Typing help + ENTER lists all the commands known to the shell (including unavailable commands) and a short description of what they do, similar to the following:spring-doc.cn

my-shell:>help
AVAILABLE COMMANDS

Built-In Commands
       exit: Exit the shell.
       help: Display help about available commands
       stacktrace: Display the full stacktrace of the last error.
       clear: Clear the shell screen.
       quit: Exit the shell.
       history: Display or save the history of previously run commands
       completion bash: Generate bash completion script
       version: Show version info
       script: Read and execute commands from a file.

Typing help <command> shows more detailed information about a command, including the available parameters, their type, whether they are mandatory or not, and other details.spring-doc.cn

The following listing shows the help command applied to itself:spring-doc.cn

my-shell:>help help
NAME
       help - Display help about available commands

SYNOPSIS
       help --command String

OPTIONS
       --command or -C String
       The command to obtain help for.
       [Optional]

Help is templated and can be customized if needed. Settings are under spring.shell.command.help where you can use enabled to disable command, grouping-mode taking group or flat if you want to hide groups by flattening a structure, command-template to define your template for output of a command help, commands-template to define output of a command list.spring-doc.cn

If spring.shell.command.help.grouping-mode=flat is set, then help would show:spring-doc.cn

my-shell:>help help
AVAILABLE COMMANDS

exit: Exit the shell.
help: Display help about available commands
stacktrace: Display the full stacktrace of the last error.
clear: Clear the shell screen.
quit: Exit the shell.
history: Display or save the history of previously run commands
completion bash: Generate bash completion script
version: Show version info
script: Read and execute commands from a file.

Output from help and help <commmand> are both templated with a default implementation which can be changed.spring-doc.cn

Option spring.shell.command.help.commands-template defaults to classpath:template/help-commands-default.stg and is passed GroupsInfoModel as a model.spring-doc.cn

Option spring.shell.command.help.command-template defaults to classpath:template/help-command-default.stg and is passed CommandInfoModel as a model.spring-doc.cn

Table 1. GroupsInfoModel Variables
Key	Description
`showGroups`spring-doc.cn	`true` if showing groups is enabled. Otherwise, false.spring-doc.cn
`groups`spring-doc.cn	The commands variables (see GroupCommandInfoModel Variables).spring-doc.cn
`commands`spring-doc.cn	The commands variables (see CommandInfoModel Variables).spring-doc.cn
`hasUnavailableCommands`spring-doc.cn	`true` if there is unavailable commands. Otherwise, false.spring-doc.cn

Table 2. GroupCommandInfoModel Variables
Key	Description
`group`spring-doc.cn	The name of a group, if set. Otherwise, empty.spring-doc.cn
`commands`spring-doc.cn	The commands, if set. Otherwise, empty. Type is a multi value, see CommandInfoModel Variables.spring-doc.cn

Table 3. CommandInfoModel Variables
Key	Description
`name`spring-doc.cn	The name of a command, if set. Otherwise, null. Type is string and contains full command.spring-doc.cn
`names`spring-doc.cn	The names of a command, if set. Otherwise, null. Type is multi value essentially `name` splitted.spring-doc.cn
`aliases`spring-doc.cn	The possible aliases, if set. Type is multi value with strings.spring-doc.cn
`description`spring-doc.cn	The description of a command, if set. Otherwise, null.spring-doc.cn
`parameters`spring-doc.cn	The parameters variables, if set. Otherwise empty. Type is a multi value, see CommandParameterInfoModel Variables.spring-doc.cn
`availability`spring-doc.cn	The availability variables (see CommandAvailabilityInfoModel Variables).spring-doc.cn

Table 4. CommandParameterInfoModel Variables
Key	Description
`type`spring-doc.cn	The type of a parameter if set. Otherwise, null.spring-doc.cn
`arguments`spring-doc.cn	The arguments, if set. Otherwise, null. Type is multi value with strings.spring-doc.cn
`required`spring-doc.cn	`true` if required. Otherwise, false.spring-doc.cn
`description`spring-doc.cn	The description of a parameter, if set. Otherwise, null.spring-doc.cn
`defaultValue`spring-doc.cn	The default value of a parameter, if set. Otherwise, null.spring-doc.cn
`hasDefaultValue`spring-doc.cn	`true` if defaultValue exists. Otherwise, false.spring-doc.cn

Table 5. CommandAvailabilityInfoModel Variables
Key	Description
`available`spring-doc.cn	`true` if available. Otherwise, false.spring-doc.cn
`reason`spring-doc.cn	The reason if not available if set. Otherwise, null.spring-doc.cn