From d3dd672640f3c8c11919a78884004959644d1176 Mon Sep 17 00:00:00 2001
From: Nick Craig-Wood <nick@craig-wood.com>
Date: Sat, 18 Jun 2016 14:12:47 +0100
Subject: [PATCH] Document recursion requirements for Fses

---
 fs/fs.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/fs/fs.go b/fs/fs.go
index 2d8206816..32bddac99 100644
--- a/fs/fs.go
+++ b/fs/fs.go
@@ -105,6 +105,9 @@ type ListFser interface {
 	//
 	// This should return ErrDirNotFound (using out.SetError())
 	// if the directory isn't found.
+	//
+	// Fses must support recursion levels of fs.MaxLevel and 1.
+	// They may return ErrorLevelNotSupported otherwise.
 	List(out ListOpts, dir string)
 }