From: Ian Lance Taylor <iant@golang.org>
Date: Sat, 2 Nov 2024 04:50:12 +0000 (-0700)
Subject: io/fs: clarify that "." may only be used for root
X-Git-Tag: go1.24rc1~480
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=d92e8fe25cd617257942e564c16ce367de46640b;p=gostls13.git

io/fs: clarify that "." may only be used for root

For #70155

Change-Id: I648791c484e19bb12c6e4f84e2dc42eaaa4db546
Reviewed-on: https://go-review.googlesource.com/c/go/+/624595
Reviewed-by: Damien Neil <dneil@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Ian Lance Taylor <iant@golang.org>
Reviewed-by: David Chase <drchase@google.com>
---

diff --git a/src/io/fs/fs.go b/src/io/fs/fs.go
index 6583bcd7b9..9e19e6a797 100644
--- a/src/io/fs/fs.go
+++ b/src/io/fs/fs.go
@@ -44,7 +44,7 @@ type FS interface {
 // Path names passed to open are UTF-8-encoded,
 // unrooted, slash-separated sequences of path elements, like “x/y/z”.
 // Path names must not contain an element that is “.” or “..” or the empty string,
-// except for the special case that the root directory is named “.”.
+// except for the special case that the name "." may be used for the root directory.
 // Paths must not start or end with a slash: “/x” and “x/” are invalid.
 //
 // Note that paths are slash-separated on all systems, even Windows.