I suggest we add "Use an absolute file name if you need an absolute path.  Use `sys.libdir` (absolute library path), `sys.local_libdir` (library path relative to the current masterfiles), and `this.promise_dirname` (the directory of the currently processed file) to avoid hard-coding paths."

Should we give examples for each usage?  The `this.promise_dirname` in particular is tricky.