docco improvements

Author: nicholascar

docs/gettingstarted.rst

@@ -50,7 +50,7 @@ operations (e.g. :meth:`~rdflib.Graph.add` to add a triple) plus
 methods that search triples and return them in arbitrary order.
 
 RDFLib graphs also redefine certain built-in Python methods in order
-to behave in a predictable way: they `emulating container types
+to behave in a predictable way. They do this by `emulating container types
 <https://docs.python.org/3.7/reference/datamodel.html#emulating-container-types>`_ and
 are best thought of as a set of 3-item tuples ("triples", in RDF-speak):
 

rdflib/namespace/__init__.py

@@ -305,29 +305,36 @@ def _ipython_key_completions_(self) -> List[str]:
 
 
 class NamespaceManager(object):
-    """
-
-    Class for managing prefix => namespace mappings
-
-    Sample usage from FuXi ...
-
-    .. code-block:: python
-
-        ruleStore = N3RuleStore(additionalBuiltins=additionalBuiltins)
-        nsMgr = NamespaceManager(Graph(ruleStore))
-        ruleGraph = Graph(ruleStore,namespace_manager=nsMgr)
-
-
-    and ...
+    """Class for managing prefix => namespace mappings
+
+    This class requires an RDFlib Graph as an input parameter and may optionally have
+    the parameter bind_namespaces set. This second parameter selects a strategy which
+    is one of the following:
+
+    * core:
+        * binds several core prefixes only
+        * owl, rdf, rdfs, xsd, xml from the NAMESPACE_PREFIXES_CORE object
+        * this is detfault
+    * rdflib:
+        * binds all the namespaces shipped with RDFLib as DefinedNamespace instances
+        * all the core namespaces and all the following: brick, csvw, dc, dcat
+        * dcmitype, cdterms, dcam, doap, foaf, geo, odrl, org, prof, prov, qb, sdo
+        * sh, skos, sosa, ssn, time, vann, void
+        * see the NAMESPACE_PREFIXES_RDFLIB object for the up-to-date list
+    * cc:
+        * using prefix bindings from prefix.cc which is a online prefixes database
+
+    See the
+    Sample usage
 
     .. code-block:: pycon
 
         >>> import rdflib
         >>> from rdflib import Graph
         >>> from rdflib.namespace import Namespace, NamespaceManager
-        >>> exNs = Namespace('http://example.com/')
+        >>> EX = Namespace('http://example.com/')
         >>> namespace_manager = NamespaceManager(Graph())
-        >>> namespace_manager.bind('ex', exNs, override=False)
+        >>> namespace_manager.bind('ex', EX, override=False)
         >>> g = Graph()
         >>> g.namespace_manager = namespace_manager
         >>> all_ns = [n for n in g.namespace_manager.namespaces()]

test/test_namespacemanager.py

@@ -22,5 +22,6 @@ def test_rdflib_prefixes_bound():
     assert len(list(g.namespaces())) == \
            len(NAMESPACE_PREFIXES_CORE) + len(list(NAMESPACE_PREFIXES_RDFLIB))
 
+
 def test_cc_prefixes_bound():
     pass