start reorganizing docs, write more docs, shift plugin docs, to proper documentation,

use sphinx, remove old docs ... work in progress.

--HG--
branch : trunk

example/funcarg/mysetup/__init__.py

@@ -0,0 +1 @@
+# XXX this file should not need to be here but is here for proper sys.path mangling

example/funcarg/mysetup/conftest.py

@@ -0,0 +1,9 @@
+
+from mysetup.myapp import MyApp
+
+def pytest_funcarg__mysetup(request):
+    return MySetup()
+
+class MySetup:
+    def myapp(self):
+        return MyApp()

example/funcarg/mysetup/myapp.py

@@ -0,0 +1,5 @@
+
+class MyApp:
+    def question(self):
+        return 6 * 9
+

example/funcarg/mysetup/test_sample.py

@@ -0,0 +1,5 @@
+
+def test_answer(mysetup):
+    app = mysetup.myapp()
+    answer = app.question()
+    assert answer == 42