path: root/doc/write_mkpath.txt
diff options
authorTom Ryder <tom@sanctum.geek.nz>2019-05-31 22:47:59 +1200
committerTom Ryder <tom@sanctum.geek.nz>2019-05-31 23:03:10 +1200
commit474c68e5125f5dbe12a85220c591c21fea85e547 (patch)
treed3a36d98cd081954795374d6a5992c98972ea1af /doc/write_mkpath.txt
parentSuppress potentially confusing :file output (diff)
Document Vim < 7.2 caveat
Diffstat (limited to 'doc/write_mkpath.txt')
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/write_mkpath.txt b/doc/write_mkpath.txt
index 8ba3709..c4713f8 100644
--- a/doc/write_mkpath.txt
+++ b/doc/write_mkpath.txt
@@ -18,6 +18,15 @@ REQUIREMENTS *write_mkpath-requirements*
This plugin only loads if 'compatible' is not set.
+CAVEATS *write_mkpath-caveats*
+In Vim 7.0 and 7.1, the path will be created relative to Vim's working
+directory at the time of the write operation, which might not be the same as
+the working directory when the buffer was first created, e.g. after a |:cd|
+change. This is worked around safely in Vim 7.2 and newer by calculating an
+absolute path for new buffers with nonexistent relative paths, but filename
+escaping bugs in earlier versions preclude the same fix in older versions.
AUTHOR *write_mkpath-author*
Written and maintained by Tom Ryder <tom@sanctum.geek.nz>.