From 526231812ff5c97dc17b17aed2c77bb49eea15fe Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <mitchell.hashimoto@gmail.com>
Date: Mon, 13 Jan 2014 22:29:10 -0800
Subject: [PATCH] website/docs: better docs

---
 .../rsync/command/rsync_auto.rb               |  1 +
 website/docs/source/v2/cli/rsync-auto.html.md | 24 +++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/plugins/synced_folders/rsync/command/rsync_auto.rb b/plugins/synced_folders/rsync/command/rsync_auto.rb
index 42d9e4e55..f7a6b1ae7 100644
--- a/plugins/synced_folders/rsync/command/rsync_auto.rb
+++ b/plugins/synced_folders/rsync/command/rsync_auto.rb
@@ -40,6 +40,7 @@ module VagrantPlugins
               hostpath = File.expand_path(hostpath, machine.env.root_path)
               paths[hostpath] ||= []
               paths[hostpath] << {
+                id: id,
                 machine: machine,
                 opts:    folder_opts,
               }
diff --git a/website/docs/source/v2/cli/rsync-auto.html.md b/website/docs/source/v2/cli/rsync-auto.html.md
index a19e3efd8..9eec9dfc0 100644
--- a/website/docs/source/v2/cli/rsync-auto.html.md
+++ b/website/docs/source/v2/cli/rsync-auto.html.md
@@ -14,3 +14,27 @@ not exit until an interrupt is received.
 
 The change detection is optimized to use platform-specific APIs to listen
 for filesystem changes, and does not simply poll the directory.
+
+## Machine State Changes
+
+The `rsync-auto` command does not currently handle machine state changes
+gracefully. For example, if you start the `rsync-auto` command, then
+halt the guest machine, then make changes to some files, then boot it
+back up, `rsync-auto` will not attempt to resync.
+
+To ensure that the command works properly, you should start `rsync-auto`
+only when the machine is running, and shut it down before any machine
+state changes.
+
+You can always force a resync with the [rsync](/v2/cli/rsync.html) command.
+
+## Vagrantfile Changes
+
+If you change or move your Vagrantfile, the `rsync-auto` command will have
+to be restarted. For example, if you add synced folders to the Vagrantfile,
+or move the directory that contains the Vagrantfile, the `rsync-auto`
+command will either not pick up the changes or may begin experiencing
+strange behavior.
+
+Before making any such changes, it is recommended that you turn off
+`rsync-auto`, then restart it afterwards.