fuse/nodefs: clarify types.

fuse/nodefs/api.go

@@ -23,8 +23,8 @@ type FileSystem interface {
 	SetDebug(debug bool)
 }
 
-// The Node implements the basic functionality of inodes; this is
-// where the majority of the FS code for a typical filesystem will be.
+// The Node interface implements the user-defined file system
+// functionality
 type Node interface {
 	// Inode and SetInode are basic getter/setters.  They are
 	// called by the FileSystemConnector. You get them for free by

fuse/nodefs/inode.go

@@ -7,9 +7,11 @@ import (
 	"github.com/hanwen/go-fuse/fuse"
 )
 
-// An Inode reflects the kernel's idea of the inode.  Inodes may be
-// created automatically when the kernel does lookups inode, or by
-// explicitly by calling Inode.New().
+// An Inode reflects the kernel's idea of the inode.  Inodes have IDs
+// that are communicated to the kernel, and they have a tree
+// structure: a directory Inode may contain named children.  Each
+// Inode object is paired with a Node object, which file system
+// implementers should supply.
 type Inode struct {
 	handled handled