From 5f124721b7c791c579062d9e3649b2b3646ccc8b Mon Sep 17 00:00:00 2001 From: Todd Leonhardt Date: Wed, 29 Jan 2020 00:57:49 -0500 Subject: Attempt to make "help -v" more discoverable by changing the default help text --- docs/features/help.rst | 8 ++++---- docs/features/initialization.rst | 2 ++ docs/features/os.rst | 4 ++-- 3 files changed, 8 insertions(+), 6 deletions(-) (limited to 'docs/features') diff --git a/docs/features/help.rst b/docs/features/help.rst index 03e0867b..920516f5 100644 --- a/docs/features/help.rst +++ b/docs/features/help.rst @@ -12,15 +12,15 @@ Categorizing Commands By default, the ``help`` command displays:: - Documented commands (type help ): - ======================================== + Documented commands (use 'help -v' for verbose/'help ' for details): + =========================================================================== alias help ipy py run_pyscript set shortcuts edit history macro quit run_script shell If you have a large number of commands, you can optionally group your commands into categories. Here's the output from the example ``help_categories.py``:: - Documented commands (type help ): + Documented commands (use 'help -v' for verbose/'help ' for details): Application Management ====================== @@ -90,7 +90,7 @@ Using the ``categorize()`` function: The ``help`` command also has a verbose option (``help -v`` or ``help --verbose``) that combines the help categories with per-command Help Messages:: - Documented commands (type help ): + Documented commands (use 'help -v' for verbose/'help ' for details): Application Management ================================================================================ diff --git a/docs/features/initialization.rst b/docs/features/initialization.rst index c5df5af8..46b4ecd2 100644 --- a/docs/features/initialization.rst +++ b/docs/features/initialization.rst @@ -108,6 +108,8 @@ override: support commands that are only available during specific states of the application. This dictionary's keys are the command names and its values are DisabledCommand objects. +- **doc_header**: Set the header used for the help function's listing of + documented functions - **echo**: if ``True``, each command the user issues will be repeated to the screen before it is executed. This is particularly useful when running scripts. This behavior does not occur when running a command at the prompt. diff --git a/docs/features/os.rst b/docs/features/os.rst index 40a7cbf4..b6f9b61f 100644 --- a/docs/features/os.rst +++ b/docs/features/os.rst @@ -49,8 +49,8 @@ loop:: $ python examples/example.py help - Documented commands (type help ): - ======================================== + Documented commands (use 'help -v' for verbose/'help ' for details): + =========================================================================== alias help macro orate quit run_script set shortcuts edit history mumble py run_pyscript say shell speak -- cgit v1.2.1