Document how to run locally, and make said parameter less error-prone.

Author: JulienPalard

README.txt

@@ -1,2 +1,9 @@
 This repository contains scripts for automatically building the Python
 documentation on docs.python.org.
+
+# How to test it?
+
+    $ mkdir www logs build_root
+    $ python3 -m venv build_root/venv/
+    $ build_root/venv/bin/python -m pip install -r requirements.txt
+    $ python3 ./build_docs.py --quick --build-root build_root --www-root www --log-directory logs --group $(id -g)

build_docs.py

@@ -293,6 +293,12 @@ def parse_args():
 
 def main():
     args = parse_args()
+    if args.log_directory:
+        args.log_directory = os.path.abspath(args.log_directory)
+    if args.build_root:
+        args.build_root = os.path.abspath(args.build_root)
+    if args.www_root:
+        args.www_root = os.path.abspath(args.www_root)
     if sys.stderr.isatty():
         logging.basicConfig(format="%(levelname)s:%(message)s",
                             stream=sys.stderr)