add documentation for catkin#192

docs/advanced/catkin_shell_verbs.rst

@@ -0,0 +1,36 @@
+Shell support in ``catkin`` command
+===================================
+
+When you source the following file, you can use bash/zsh shell functions which provide added utility.
+
+.. code-block:: shell
+
+    . /opt/ros/indigo/etc/bash_completion.d/catkin_shell_verbs.{bash,zsh}
+
+Provided verbs are:
+
+- ``cd`` -- Change to package directory in source space
+- ``source`` -- Source the develspace or installspace of the containing workspace
+
+Full Command-Line Interface
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Change to package directory in source space with `cd` verb.
+
+.. code-block:: text
+
+    usage: catkin cd [ARGS...]
+
+    ARGS are any valid catkin locate arguments
+
+The `source` verb sources the develspace or installspace of the containing workspace
+
+.. code-block:: text
+
+    usage: catkin source [-w /path/to/ws]
+
+    Sources setup.sh in the workspace.
+
+    optional arguments:
+      -w [/path/to/ws] Source setup.sh from given workspace.
+

docs/index.rst

@@ -19,6 +19,7 @@ Catkin Command Line Tools
    verbs/catkin_list
    verbs/catkin_locate
    verbs/catkin_profile
+   Advanced: Shell support <advanced/catkin_shell_verbs>
    Advanced: Verb Aliasing <advanced/verb_customization>
    Advanced: Contributing Verbs <development/extending_the_catkin_command>
 .. TODO: Advanced: Workspace Chaining <advanced/workspace_chaining>
@@ -67,6 +68,12 @@ Each of the following verbs is built-in to the ``catkin`` command and has its ow
 - :doc:`list -- Find and list information about catkin packages in a workspace <verbs/catkin_list>`
 - :doc:`profile -- Manage different named configuration profiles <verbs/catkin_profile>`
 
+Shell support in ``catkin`` command
+-----------------------------------
+
+A bash/zsh user can use wrapper function, please read :doc:`development/catkin_shell_verbs`.
+
+
 Extending the ``catkin`` command
 --------------------------------