path: document that filepath is recommended to manipulate filename paths

Fixes #17690.

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

diff --git a/src/path/path.go b/src/path/path.go
index c1d4d8aced3cc76939077af34821e02b7159cb0f..76c7814c59d8a0fa268b6d92606e46e8f1fd4275 100644 (file)
--- a/src/path/path.go
+++ b/src/path/path.go
@@ -4,6 +4,8 @@
 
 // Package path implements utility routines for manipulating slash-separated
 // paths.
+//
+// To manipulate operating system paths, use the path/filepath package.
 package path
 
 import (