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/costlysetup/conftest.py

@@ -0,0 +1,16 @@
+
+def pytest_funcarg__setup(request):
+    return request.cached_setup(
+        setup=lambda: CostlySetup(),
+        teardown=lambda costlysetup: costlysetup.finalize(),
+        scope="session",
+    )
+
+class CostlySetup:
+    def __init__(self):
+        import time
+        time.sleep(5)
+        self.timecostly = 1
+
+    def finalize(self):
+        del self.timecostly

example/funcarg/costlysetup/sub1/__init__.py

@@ -0,0 +1 @@
+#

example/funcarg/costlysetup/sub1/test_quick.py

@@ -0,0 +1,3 @@
+
+def test_quick():
+    pass

example/funcarg/costlysetup/sub2/__init__.py

@@ -0,0 +1 @@
+#

example/funcarg/costlysetup/sub2/test_two.py

@@ -0,0 +1,6 @@
+def test_something(setup):
+    assert setup.timecostly == 1
+
+def test_something_more(setup):
+    assert setup.timecostly == 1
+