path: add more examples for path.Clean

Clarify that the function path.Clean only normalises paths and does not
protect against directory-traversal attacks.

Change-Id: I66f1267ac15900ac0cb6011ace0c79aabaebc68b
GitHub-Last-Rev: d669e1edf6221e7c8e0a9aa7bf46493c8ea85ba0
GitHub-Pull-Request: golang/go#74397
Reviewed-on: https://go-review.googlesource.com/c/go/+/684376
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Mark Freeman <markfreeman@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Rob Pike <r@golang.org>
Reviewed-by: Sean Liao <sean@liao.dev>
Auto-Submit: Sean Liao <sean@liao.dev>

diff --git a/src/path/example_test.go b/src/path/example_test.go
index e30ebd13dcd739c32657e8a8b482d1d6503822e1..479241a3820ab76e8b37a31aa30ee8d5b9e1e7c5 100644 (file)
--- a/src/path/example_test.go
+++ b/src/path/example_test.go
@@ -25,6 +25,8 @@ func ExampleClean() {
                "a//c",
                "a/c/.",
                "a/c/b/..",
+               "../a/c",
+               "../a/b/../././/c",
                "/../a/c",
                "/../a/b/../././/c",
                "",
@@ -39,6 +41,8 @@ func ExampleClean() {
        // Clean("a//c") = "a/c"
        // Clean("a/c/.") = "a/c"
        // Clean("a/c/b/..") = "a/c"
+       // Clean("../a/c") = "../a/c"
+       // Clean("../a/b/../././/c") = "../a/c"
        // Clean("/../a/c") = "/a/c"
        // Clean("/../a/b/../././/c") = "/a/c"
        // Clean("") = "."