diff options
author | Todd Leonhardt <todd.leonhardt@gmail.com> | 2019-09-21 12:22:53 -0400 |
---|---|---|
committer | Todd Leonhardt <todd.leonhardt@gmail.com> | 2019-09-21 12:22:53 -0400 |
commit | b45fec9859533f8a1dcab3f5524945cb3b9c11a2 (patch) | |
tree | b2f385058c2758500077543e43f364485ea30354 /docs/features | |
parent | efadff391032482b139524c96dfc4130fc631f9c (diff) | |
download | cmd2-git-b45fec9859533f8a1dcab3f5524945cb3b9c11a2.tar.gz |
Minor spelling and grammar fixes
Diffstat (limited to 'docs/features')
-rw-r--r-- | docs/features/commands.rst | 16 | ||||
-rw-r--r-- | docs/features/disable_commands.rst | 2 |
2 files changed, 9 insertions, 9 deletions
diff --git a/docs/features/commands.rst b/docs/features/commands.rst index 196944b5..823c3ca6 100644 --- a/docs/features/commands.rst +++ b/docs/features/commands.rst @@ -112,7 +112,7 @@ terminator For many simple commands, like the ``echo`` command above, you can ignore the ``Statement`` object and all of it's attributes and just use the passed value as a string. You might choose to use the ``argv`` attribute to do more -sophisticated argument processing. Before you go to far down that path, you +sophisticated argument processing. Before you go too far down that path, you should check out the :ref:`features/argument_processing:Argument Processing` functionality included with ``cmd2``. @@ -120,7 +120,7 @@ functionality included with ``cmd2``. Return Values ------------- -Most commands should return nothing (either my omitting a ``return`` statement, +Most commands should return nothing (either by omitting a ``return`` statement, or by ``return None``. This indicates that your command is finished (with or without errors), and that ``cmd2`` should prompt the user for more input. @@ -142,7 +142,7 @@ The ``cmd2.Cmd`` object sets an ``exit_code`` attribute to zero when it is instantiated. The value of this attribute is returned from the ``cmdloop()`` call. Therefore, if you don't do anything with this attribute in your code, ``cmdloop()`` will (almost) always return zero. There are a few built-in -``cmd2`` commands which set ``exit_code`` to ``-1`` if an error occers. +``cmd2`` commands which set ``exit_code`` to ``-1`` if an error occurs. You can use this capability to easily return your own values to the operating system shell:: @@ -157,7 +157,7 @@ system shell:: def do_bail(self, line): """Exit the application"" - self.poutput("fatal error, exiting") + self.perror("fatal error, exiting") self.exit_code = 2 return true @@ -178,7 +178,7 @@ the following interaction:: Exception Handling ------------------ -You may choose you may choose to catch and handle any exceptions which occur in +You may choose to catch and handle any exceptions which occur in a command method. If the command method raises an exception, ``cmd2`` will catch it and display it for you. The `debug` :ref:`setting <features/settings:Settings>` controls how the exception is displayed. If @@ -193,6 +193,6 @@ Disabling or Hiding Commands See :ref:`features/disable_commands:Disabling Commands` for details of how to: -- removing commands included in ``cmd2`` -- hiding commands from the help menu -- disabling and re-enabling commands at runtime +- remove commands included in ``cmd2`` +- hide commands from the help menu +- disable and re-enable commands at runtime diff --git a/docs/features/disable_commands.rst b/docs/features/disable_commands.rst index 78d214bb..397fa88d 100644 --- a/docs/features/disable_commands.rst +++ b/docs/features/disable_commands.rst @@ -4,7 +4,7 @@ Disabling Commands ``cmd2`` allows a developer to: - remove commands included in ``cmd2`` -- prevent commands from appearing in the help menu (hiding commands) +- prevent commands from appearing in the help menu (hide commands) - disable and re-enable commands at runtime |