Revert "Revert "Add fs.relative_to()""

This reverts commit 84c8905d527893bedc673e8a036b8b2ec89368b4.

Fixed the cygwin failure...

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/markdown/Fs-module.md b/docs/markdown/Fs-module.md
index cc67355b5..7ba4832a0 100644
--- a/docs/markdown/Fs-module.md
+++ b/docs/markdown/Fs-module.md
@@ -224,6 +224,20 @@ fs.stem('foo/bar/baz.dll.a')  # baz.dll
    project. If the file specified by `path` is a `files()` object it
    cannot refer to a built file.
 
+### relative_to
+
+*Since 1.3.0*
+
+Return a relative filepath. In the event a relative path could not be found, the
+absolute path of `to` is returned. Relative path arguments will be assumed to be
+relative to `meson.current_source_dir()`.
+
+Has the following positional arguments:
+   - to `str | file | custom_tgt | custom_idx | build_tgt`: end path
+   - from `str | file | custom_tgt | custom_idx | build_tgt`: start path
+
+returns:
+   - a string
 
 ### copyfile