From 617b6323e23128c938a28c01f55ab254ffdd183d Mon Sep 17 00:00:00 2001
From: Brian Coca <bcoca@ansible.com>
Date: Tue, 28 Oct 2014 08:43:18 -0700
Subject: [PATCH] added info about new deprecated/alias plugin loading

---
 docsite/rst/developing_modules.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docsite/rst/developing_modules.rst b/docsite/rst/developing_modules.rst
index 608ac7185bc..355f402835b 100644
--- a/docsite/rst/developing_modules.rst
+++ b/docsite/rst/developing_modules.rst
@@ -465,6 +465,23 @@ a github pull request to the `extras <https://github.com/ansible/ansible-modules
 Included modules will ship with ansible, and also have a change to be promoted to 'core' status, which
 gives them slightly higher development priority (though they'll work in exactly the same way).
 
+
+Deprecating and makingm module aliases
+``````````````````````````````````````
+
+Starting in 1.8 you can deprecate modules by renaming them with a preceeding _, i.e. old_cloud.py to 
+_old_cloud.py, This will keep the module available but hide it from the primary docs and listing.
+
+You can also rename modules and keep an alias to the old name by using a symlink that starts with _.
+This example allows the stat module to be called with fileinfo, making the following examples equivalent
+
+    EXAMPLES = '''
+    ln -s stat.py _fileinfo.py
+    ansible -m stat -a "path=/tmp" localhost
+    ansible -m fileinfo -a "path=/tmp" localhost
+    '''
+
+
 .. seealso::
 
    :doc:`modules`