From d97ac5e50aeaced9693d08256a430781779242ac Mon Sep 17 00:00:00 2001
From: Jeremy Stanley <fungi@yuggoth.org>
Date: Fri, 5 Oct 2018 14:00:49 +0000
Subject: [PATCH] Add note about mounting one AFS volume in another

This ate a good chunk of my day before a more AFS-savvy colleague
pointed out that a mountpoint within a volume is just a special kind
of file record and so needed the parent volume released before it
would appear in the read-only path.

Change-Id: Ic3d717d70c8bf2548447550472a52849dd85ffd3
---
 doc/source/afs.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/source/afs.rst b/doc/source/afs.rst
index d768669c0a..90e15a0ad4 100644
--- a/doc/source/afs.rst
+++ b/doc/source/afs.rst
@@ -220,6 +220,10 @@ Be sure to mount the read-write volume in AFS with::
 You may want to create read-only sites for the volume with ``vos
 addsite`` and then ``vos release``.
 
+If the volume's mountpoint lies within another volume, you may also
+need to ``vos release`` that parent volume before it will show up in
+the read-only path.
+
 You should set the volume quota with ``fs setquota``.
 
 Adding a Fileserver