It is hard to find the "actions" command and the "actions" command is misdocumented

Bug #1189159 reported by Jean-Paul Calderone
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Divmod Imaginary
Fix Committed
Undecided
Unassigned

Bug Description

This is a bad first user experience:

> help
Bad command or filename
> help help
HELP

Usage: help <command>

Provides information on the usage of the indicated command.

> commands
Bad command or filename
> command
Bad command or filename
> help commands
No help available on commands.

> list
Bad command or filename
> list commands
Bad command or filename
> help list
LIST

Usage: list <listable>

<listable> things are thus:

  thing types

See "help list <listable>" for more details.

> list thing
Bad command or filename
> list thing types
pants
shirt
thing
torch
underwear
> help list thing types
LIST THING TYPES

Usage: list thing types

Show a list of names of things which can be created with the create command.

> actions
actions bury close create describe dig drop emote equipment go help hit illuminate inventory listthingtypes look name open putin remove restore
say score scrutinize search set take wear who

> help actions
COMMANDS

Usage: commands

List all commands available to you.

(Also, the user was me).

It would be great if `help` by itself did something more useful - maybe that's not part of this bug report though. However, "commands" should almost certainly be an alias for "actions" as the former is much more guessable. And the lies in the help text for "actions" telling you to type "commands" don't help.

Related branches

Changed in imaginary:
status: New → Fix Committed
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.