As we moved the real README file to Documentation/admin-guide/README.rst,
let's add a replacement, pointing to it, and giving the main directions
about documentation.

In the future, perhaps it would be worth to move the contents
of Documentation/00-Index into this README.

Signed-off-by: Mauro Carvalho Chehab <>
 README | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 README

diff --git a/README b/README
new file mode 100644
index 000000000000..b2ba4aaa3a71
--- /dev/null
+++ b/README
@@ -0,0 +1,18 @@
+Linux kernel
+This file was moved to Documentation/admin-guide/README.rst
+Please notice that there are several guides for kernel developers and users.
+These guides can be rendered in a number of formats, like HTML and PDF.
+In order to build the documentation, use ``make htmldocs`` or
+``make pdfdocs``.
+There are various text files in the Documentation/ subdirectory,
+several of them using the Restructured Text markup notation.
+See Documentation/00-INDEX for a list of what is contained in each file.
+Please read the Documentation/process/changes.rst file, as it contains the
+requirements for building and running the kernel, and information about
+the problems which may result by upgrading your kernel.

To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to
More majordomo info at

Reply via email to