Improved alias documentationf

1 files changed, 8 insertions, 0 deletions

diff --git a/docs/features/shortcuts_aliases_macros.rst b/docs/features/shortcuts_aliases_macros.rst
index b84403c8..2a2bf654 100644
--- a/docs/features/shortcuts_aliases_macros.rst
+++ b/docs/features/shortcuts_aliases_macros.rst
@@ -51,6 +51,14 @@ The syntax to create an alias is: ``alias create name command [args]``.
 
   Ex: ``alias create ls !ls -lF``
 
+Redirectors and pipes should be quoted in alias definition to prevent the
+``alias create`` command from being redirected::
+
+    alias create save_results print_results ">" out.txt
+
+Tab completion recognizes an alias, and completes as if its actual value
+was on the command line.
+
 For more details run: ``help alias create``
 
 Use ``alias list`` to see all or some of your aliases. The output of this