From ee953490e8ec1ac4ffa98bb67f810617b03e8d46 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tobias=20Nie=C3=9Fen?= Date: Thu, 18 Jan 2024 17:10:17 +0100 Subject: [PATCH] doc: note that path.normalize deviates from POSIX --- doc/api/path.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/api/path.md b/doc/api/path.md index d58fc044476bb9..c7a999cbb1ec22 100644 --- a/doc/api/path.md +++ b/doc/api/path.md @@ -361,6 +361,14 @@ instance of the platform-specific path segment separator (`/` on POSIX and If the `path` is a zero-length string, `'.'` is returned, representing the current working directory. +On POSIX, the types of normalization applied by this function do not strictly +adhere to the POSIX specification. For example, this function will replace two +leading forward slashes with a single slash as if it was a regular absolute +path, whereas a few POSIX systems assign special meaning to paths beginning with +exactly two forward slashes. Similarly, other substitutions performed by this +function, such as removing `..` segments, may change how the underlying system +resolves the path. + For example, on POSIX: ```js