environment: clarify docstring

This commit is contained in:
Georg Brandl 2013-03-30 12:33:31 +01:00
parent 1f79ba7e74
commit 2f03bb5f12

View File

@ -309,8 +309,9 @@ class BuildEnvironment:
"""Return paths to a file referenced from a document, relative to
documentation root and absolute.
Absolute filenames are relative to the source dir, while relative
filenames are relative to the dir of the containing document.
In the input "filename", absolute filenames are taken as relative to the
source dir, while relative filenames are relative to the dir of the
containing document.
"""
if filename.startswith('/') or filename.startswith(os.sep):
rel_fn = filename[1:]