From e620798d33346187005b44ab0ff96decd5b5e95a Mon Sep 17 00:00:00 2001
From: wim glenn <hey@wimglenn.com>
Date: Sun, 19 Aug 2018 23:11:31 -0500
Subject: [PATCH] more autodocs for pytester

---
 changelog/3833.doc.rst  |  1 +
 doc/en/reference.rst    |  2 +-
 src/_pytest/pytester.py | 20 ++++++++++++--------
 3 files changed, 14 insertions(+), 9 deletions(-)
 create mode 100644 changelog/3833.doc.rst

diff --git a/changelog/3833.doc.rst b/changelog/3833.doc.rst
new file mode 100644
index 00000000000..d74ee10b2a2
--- /dev/null
+++ b/changelog/3833.doc.rst
@@ -0,0 +1 @@
+Added missing docs for ``pytester.Testdir``
\ No newline at end of file
diff --git a/doc/en/reference.rst b/doc/en/reference.rst
index 86d92cf07bf..484c755da01 100644
--- a/doc/en/reference.rst
+++ b/doc/en/reference.rst
@@ -460,7 +460,7 @@ To use it, include in your top-most ``conftest.py`` file::
 
 
 .. autoclass:: Testdir()
-    :members: runpytest,runpytest_subprocess,runpytest_inprocess,makeconftest,makepyfile
+    :members:
 
 .. autoclass:: RunResult()
     :members:
diff --git a/src/_pytest/pytester.py b/src/_pytest/pytester.py
index 5b42b81eedf..b40a9e267b3 100644
--- a/src/_pytest/pytester.py
+++ b/src/_pytest/pytester.py
@@ -550,18 +550,22 @@ def to_text(s):
         return ret
 
     def makefile(self, ext, *args, **kwargs):
-        """Create a new file in the testdir.
+        r"""Create new file(s) in the testdir.
 
-        ext: The extension the file should use, including the dot, e.g. `.py`.
-
-        args: All args will be treated as strings and joined using newlines.
+        :param str ext: The extension the file(s) should use, including the dot, e.g. `.py`.
+        :param list[str] args: All args will be treated as strings and joined using newlines.
            The result will be written as contents to the file.  The name of the
            file will be based on the test function requesting this fixture.
-           E.g. "testdir.makefile('.txt', 'line1', 'line2')"
-
-        kwargs: Each keyword is the name of a file, while the value of it will
+        :param kwargs: Each keyword is the name of a file, while the value of it will
            be written as contents of the file.
-           E.g. "testdir.makefile('.ini', pytest='[pytest]\naddopts=-rs\n')"
+
+        Examples:
+
+        .. code-block:: python
+
+            testdir.makefile(".txt", "line1", "line2")
+
+            testdir.makefile(".ini", pytest="[pytest]\naddopts=-rs\n")
 
         """
         return self._makefile(ext, args, kwargs)