Merge pull request #520 from abergeron/fix_doc2

Fix documentation build

Author: abergeron

.travis.yml

@@ -23,7 +23,7 @@ before_install:
   - export PREFIX=$HOME/.local
   - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then brew update && brew install doxygen; fi
   - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then export PYTHONUSERBASE=$PREFIX; fi
-  - pip install --user breathe sphinx==1.5.1 sphinx_rtd_theme cython numpy 'mako>=0.7' six
+  - pip install --user breathe sphinx==1.6.3 sphinx_rtd_theme cython numpy 'mako>=0.7' six
   - export PATH=$PATH:$PREFIX/bin
   - export CPATH=$CPATH:$PREFIX/include
   - export LIBRARY_PATH=$LIBRARY_PATH:$PREFIX/lib

doc/c_api/group/group__context__flags.rst

@@ -57,10 +57,17 @@
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
+
+# We need this hokey-pokey because versioneer needs the current
+# directory to be the root of the project to work.
+_curpath = os.getcwd()
+os.chdir(os.path.dirname(os.path.dirname(__file__)))
 # The full version, including alpha/beta/rc tags.
 release = versioneer.get_version()
 # The short X.Y version.
 version = '.'.join(release.split('.')[:2])
+os.chdir(_curpath)
+del _curpath
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -144,10 +151,6 @@ def setup(app):
 # using the given strftime format.
 html_last_updated_fmt = '%b %d, %Y'
 
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-html_use_smartypants = True
-
 # Custom sidebar templates, maps document names to template names.
 #html_sidebars = {}
 

doc/conf.py

@@ -170,6 +170,7 @@ GPUARRAY_PUBLIC int gpucontext_props_set_single_stream(gpucontext_props *p);
  * shared drives.
  *
  * \param p properties object
+ * \param path desired location of the kernel cache
  *
  * \returns GA_NO_ERROR or an error code if an error occurred.
  */
@@ -214,8 +215,6 @@ GPUARRAY_PUBLIC void gpucontext_props_del(gpucontext_props *p);
  *
  * \param res a pointer to a location that will be allocated
  * \param name the backend name.
- * \param dev the device number.  The precise meaning of the device
- *            number is backend-dependent
  * \param props a properties object for the context.  Can be NULL for
  *              defaults.
  *