Settings: add documentation

The search_path attribute is now inside __init__() so it shows properly
in the generated documentation.

Author: carlosmn

docs/index.rst

@@ -45,6 +45,7 @@ Usage guide:
    config
    remotes
    blame
+   settings
 
 
 Indices and tables

docs/settings.rst

@@ -0,0 +1,8 @@
+**********************************************************************
+Settings
+**********************************************************************
+
+.. contents::
+
+.. autoclass:: pygit2.Settings
+   :members:

pygit2/settings.py

@@ -38,17 +38,25 @@ def __setitem__(self, key, value):
         option(GIT_OPT_SET_SEARCH_PATH, key, value)
 
 class Settings(object):
+    """Library-wide settings"""
 
     __slots__ = []
 
     _search_path = SearchPathList()
 
     @property
     def search_path(self):
+        """Configuration file search path.
+
+        This behaves like an array whose indices correspond to the
+        GIT_CONFIG_LEVEL_* values.  The local search path cannot be
+        changed.
+        """
         return self._search_path
 
     @property
     def mwindow_size(self):
+        """Maximum mmap window size"""
         return option(GIT_OPT_GET_MWINDOW_SIZE)
 
     @mwindow_size.setter