From 2a17bdce9e6e25e9be225fede7aac0b12729d82f Mon Sep 17 00:00:00 2001
From: Charles Merriam <charles.merriam@gmail.com>
Date: Wed, 12 Feb 2014 18:11:01 -0800
Subject: [PATCH] (resubmit) Add notes about OS/X and remote daemons

Docker-DCO-1.1-Signed-off-by: Charles Merriam <charles.merriam@gmail.com> (github: merriam)
---
 docs/sources/use/working_with_volumes.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/sources/use/working_with_volumes.rst b/docs/sources/use/working_with_volumes.rst
index 34728cbd3d..c639efff4f 100644
--- a/docs/sources/use/working_with_volumes.rst
+++ b/docs/sources/use/working_with_volumes.rst
@@ -108,6 +108,16 @@ container with read only permissions as ``/var/host_logs``.
 
 .. versionadded:: v0.5.0
 
+
+Note for OS/X users and remote daemon users:
+--------------------------------------------
+ 
+OS/X users run ``boot2docker`` to create a minimalist virtual machine running the docker daemon.  That 
+virtual machine then launches docker commands on behalf of the OS/X command line.   The means that ``host
+directories`` refer to directories in the ``boot2docker`` virtual machine, not the OS/X filesystem.
+
+Similarly, anytime when the docker daemon is on a remote machine, the ``host directories`` always refer to directories on the daemon's machine.
+
 Known Issues
 ............