--- a/src/hotspot/share/runtime/os.hpp	Fri Jun 15 13:57:32 2018 -0400
+++ b/src/hotspot/share/runtime/os.hpp	Tue Jun 19 09:34:41 2018 +0200
@@ -558,6 +558,9 @@
   static FILE* fopen(const char* path, const char* mode);
   static int close(int fd);
   static jlong lseek(int fd, jlong offset, int whence);
+  // This function, on Windows, canonicalizes a given path (see os_windows.cpp for details).
+  // On Posix, this function is a noop: it does not change anything and just returns
+  // the input pointer.
   static char* native_path(char *path);
   static int ftruncate(int fd, jlong length);
   static int fsync(int fd);