godoc/vfs: improve implementation of RootType

- Removed the StandAlone and Asset root types as they were just there
for other vfses to satisfy the FileSystem interface and causing unnecessary
confusion. Returning just empty strings in those scenarios now to clarify
that it is a dummy placeholder.

- Removed the prefix "Fs" from RootType as it was unnecessary.

- Using the RootType type to pass down to the html templates
instead of converting to string. The templates are capable of converting
to the actual string representation when comparing the value.

Change-Id: Iadc039f1354ecd814eec0af1e52cdbaaeff0cc89
Reviewed-on: https://go-review.googlesource.com/106196
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>

godoc/dirtrees.go

@@ -31,7 +31,7 @@ type Directory struct {
 	Name     string       // directory name
 	HasPkg   bool         // true if the directory contains at least one package
 	Synopsis string       // package documentation, if any
-	FsRootType string       // string representation of vfs.RootType
+	RootType vfs.RootType // root type of the filesystem containing the directory
 	Dirs     []*Directory // subdirectories
 }
 
@@ -203,7 +203,7 @@ func (b *treeBuilder) newDirTree(fset *token.FileSet, path, name string, depth i
 		Name:     name,
 		HasPkg:   hasPkgFiles && show, // TODO(bradfitz): add proper Hide field?
 		Synopsis: synopsis,
-		FsRootType: string(b.c.fs.RootType(path)),
+		RootType: b.c.fs.RootType(path),
 		Dirs:     dirs,
 	}
 }
@@ -308,7 +308,7 @@ type DirEntry struct {
 	Name     string       // directory name
 	HasPkg   bool         // true if the directory contains at least one package
 	Synopsis string       // package documentation, if any
-	FsRootType string // string representation of vfs.RootType
+	RootType vfs.RootType // root type of the filesystem containing the direntry
 }
 
 type DirList struct {
@@ -320,7 +320,7 @@ type DirList struct {
 // the standard library or not.
 func hasThirdParty(list []DirEntry) bool {
 	for _, entry := range list {
-		if entry.FsRootType == string(vfs.RootTypeGoPath) {
+		if entry.RootType == vfs.RootTypeGoPath {
 			return true
 		}
 	}
@@ -375,7 +375,7 @@ func (root *Directory) listing(skipRoot bool, filter func(string) bool) *DirList
 		p.Name = d.Name
 		p.HasPkg = d.HasPkg
 		p.Synopsis = d.Synopsis
-		p.FsRootType = d.FsRootType
+		p.RootType = d.RootType
 		list = append(list, p)
 	}
 

godoc/static/packageroot.html

@@ -48,7 +48,7 @@
 
 						{{range .List}}
 							<tr>
-							{{if eq .FsRootType "GOROOT"}}
+							{{if eq .RootType "GOROOT"}}
 							{{if $.DirFlat}}
 								{{if .HasPkg}}
 										<td class="pkg-name">
@@ -87,7 +87,7 @@
 
 						{{range .List}}
 							<tr>
-								{{if eq .FsRootType "GOPATH"}}
+								{{if eq .RootType "GOPATH"}}
 								{{if $.DirFlat}}
 									{{if .HasPkg}}
 											<td class="pkg-name">

godoc/static/static.go

@@ -1951,7 +1951,7 @@ function cgAddChild(tree, ul, cgn) {
 
 						{{range .List}}
 							<tr>
-							{{if eq .FsRootType "GOROOT"}}
+							{{if eq .RootType "GOROOT"}}
 							{{if $.DirFlat}}
 								{{if .HasPkg}}
 										<td class="pkg-name">
@@ -1990,7 +1990,7 @@ function cgAddChild(tree, ul, cgn) {
 
 						{{range .List}}
 							<tr>
-								{{if eq .FsRootType "GOPATH"}}
+								{{if eq .RootType "GOPATH"}}
 								{{if $.DirFlat}}
 									{{if .HasPkg}}
 											<td class="pkg-name">

godoc/vfs/emptyvfs.go

@@ -58,7 +58,7 @@ func (e *emptyVFS) String() string {
 }
 
 func (e *emptyVFS) RootType(path string) RootType {
-	return RootTypeStandAlone
+	return ""
 }
 
 // These functions below implement os.FileInfo for the single

godoc/vfs/gatefs/gatefs_test.go

@@ -17,7 +17,7 @@ func TestRootType(t *testing.T) {
 	goPath := os.Getenv("GOPATH")
 	var expectedType vfs.RootType
 	if goPath == "" {
-		expectedType = vfs.RootTypeStandAlone
+		expectedType = ""
 	} else {
 		expectedType = vfs.RootTypeGoPath
 	}
@@ -27,7 +27,7 @@ func TestRootType(t *testing.T) {
 	}{
 		{runtime.GOROOT(), vfs.RootTypeGoRoot},
 		{goPath, expectedType},
-		{"/tmp/", vfs.RootTypeStandAlone},
+		{"/tmp/", ""},
 	}
 
 	for _, item := range tests {

godoc/vfs/mapfs/mapfs.go

@@ -29,11 +29,8 @@ type mapFS map[string]string
 
 func (fs mapFS) String() string { return "mapfs" }
 
-// RootType directly returns vfs.RootTypeAsset because
-// mapFs is only used to return static assets and not for
-// resolving Go files.
 func (fs mapFS) RootType(p string) vfs.RootType {
-	return vfs.RootTypeAsset
+	return ""
 }
 
 func (fs mapFS) Close() error { return nil }

godoc/vfs/namespace.go

@@ -392,7 +392,7 @@ func (ns NameSpace) RootType(path string) RootType {
 			return m.fs.RootType(path)
 		}
 	}
-	return RootTypeStandAlone
+	return ""
 }
 
 // byName implements sort.Interface.

godoc/vfs/os.go

@@ -26,8 +26,6 @@ func OS(root string) FileSystem {
 		t = RootTypeGoRoot
 	case isGoPath(root):
 		t = RootTypeGoPath
-	default:
-		t = RootTypeStandAlone
 	}
 	return osFS{rootPath: root, rootType: t}
 }

godoc/vfs/os_test.go

@@ -16,7 +16,7 @@ func TestRootType(t *testing.T) {
 	goPath := os.Getenv("GOPATH")
 	var expectedType vfs.RootType
 	if goPath == "" {
-		expectedType = vfs.RootTypeStandAlone
+		expectedType = ""
 	} else {
 		expectedType = vfs.RootTypeGoPath
 	}
@@ -26,7 +26,7 @@ func TestRootType(t *testing.T) {
 	}{
 		{runtime.GOROOT(), vfs.RootTypeGoRoot},
 		{goPath, expectedType},
-		{"/tmp/", vfs.RootTypeStandAlone},
+		{"/tmp/", ""},
 	}
 
 	for _, item := range tests {

godoc/vfs/vfs.go

@@ -14,14 +14,14 @@ import (
 
 // RootType indicates the type of files contained within a directory.
 //
-// The two main types are a GOROOT or a GOPATH directory.
+// It is used to indicate whether a directory is the root
+// of a GOROOT, a GOPATH, or neither.
+// An empty string represents the case when a directory is neither.
 type RootType string
 
 const (
 	RootTypeGoRoot RootType = "GOROOT"
 	RootTypeGoPath RootType = "GOPATH"
-	RootTypeStandAlone RootType = "StandAlone" // used by emptyvfs
-	RootTypeAsset      RootType = "Assets"     // serves static assets using mapfs
 )
 
 // The FileSystem interface specifies the methods godoc is using

godoc/vfs/zipfs/zipfs.go

@@ -91,8 +91,6 @@ func (fs *zipFS) RootType(abspath string) vfs.RootType {
 		t = vfs.RootTypeGoRoot
 	case isGoPath(abspath):
 		t = vfs.RootTypeGoPath
-	default:
-		t = vfs.RootTypeStandAlone
 	}
 	return t
 }