Fix absolute class reference inside a namespace scope

This should resolve #56 without as many breaking changes.

Author: markstory

sphinxcontrib/phpdomain.py

@@ -269,6 +269,14 @@ def handle_signature(self, sig, signode):
                 classname = ""
                 fullname = name
 
+            # A leading \ means the name is fully qualified
+            # and should not inherit the current namespace.
+            if fullname.startswith(NS) and namespace:
+                add_module = False
+                name = name[1:]
+                fullname = fullname[1:]
+                namespace = None
+
         signode["namespace"] = namespace
         signode["class"] = self.class_name = classname
         signode["fullname"] = fullname
@@ -302,6 +310,7 @@ def handle_signature(self, sig, signode):
                     signode += addnodes.desc_addname(nodetext, nodetext)   
 
         signode += addnodes.desc_name(name, name)
+
         if not arglist:
             if self.needs_arglist():
                 # for callables, add an empty parameter list

test/unit/test_doc2.rst

@@ -42,3 +42,16 @@ No indexing errors or links should point to this namespace.
 
     Another class in a reused namespace
 
+
+.. php:class:: \Foo\Data\Thing
+
+    A class is with an absolute namespace.
+
+
+Test link generation
+====================
+
+:php:class:`Imagine\\Draw\\DrawerInterface`
+:php:class:`LibraryName\\OtherClass`
+:php:class:`LibraryName\\ThirdClass`
+:php:class:`Foo\\Data\\Thing`