Input: create a book with Linux Input documentation
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Wed, 5 Apr 2017 00:51:04 +0000 (17:51 -0700)
committerDmitry Torokhov <dmitry.torokhov@gmail.com>
Wed, 5 Apr 2017 22:45:07 +0000 (15:45 -0700)
Now that all files under Documentation/input follows the ReST markup
language, rename them to *.rst and create a book for the Linux Input
subsystem.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
34 files changed:
Documentation/conf.py
Documentation/input/alps.rst [moved from Documentation/input/alps.txt with 100% similarity]
Documentation/input/amijoy.rst [moved from Documentation/input/amijoy.txt with 100% similarity]
Documentation/input/appletouch.rst [moved from Documentation/input/appletouch.txt with 100% similarity]
Documentation/input/atarikbd.rst [moved from Documentation/input/atarikbd.txt with 100% similarity]
Documentation/input/bcm5974.rst [moved from Documentation/input/bcm5974.txt with 100% similarity]
Documentation/input/cd32.rst [moved from Documentation/input/cd32.txt with 100% similarity]
Documentation/input/cma3000_d0x.rst [moved from Documentation/input/cma3000_d0x.txt with 100% similarity]
Documentation/input/conf.py [new file with mode: 0644]
Documentation/input/cs461x.rst [moved from Documentation/input/cs461x.txt with 100% similarity]
Documentation/input/edt-ft5x06.rst [moved from Documentation/input/edt-ft5x06.txt with 100% similarity]
Documentation/input/elantech.rst [moved from Documentation/input/elantech.txt with 100% similarity]
Documentation/input/event-codes.rst [moved from Documentation/input/event-codes.txt with 100% similarity]
Documentation/input/ff.rst [moved from Documentation/input/ff.txt with 100% similarity]
Documentation/input/gamepad.rst [moved from Documentation/input/gamepad.txt with 100% similarity]
Documentation/input/gameport-programming.rst [moved from Documentation/input/gameport-programming.txt with 100% similarity]
Documentation/input/gpio-tilt.rst [moved from Documentation/input/gpio-tilt.txt with 100% similarity]
Documentation/input/iforce-protocol.rst [moved from Documentation/input/iforce-protocol.txt with 100% similarity]
Documentation/input/index.rst [new file with mode: 0644]
Documentation/input/input-programming.rst [moved from Documentation/input/input-programming.txt with 100% similarity]
Documentation/input/input.rst [moved from Documentation/input/input.txt with 92% similarity]
Documentation/input/joystick-api.rst [moved from Documentation/input/joystick-api.txt with 100% similarity]
Documentation/input/joystick-parport.rst [moved from Documentation/input/joystick-parport.txt with 100% similarity]
Documentation/input/joystick.rst [moved from Documentation/input/joystick.txt with 100% similarity]
Documentation/input/multi-touch-protocol.rst [moved from Documentation/input/multi-touch-protocol.txt with 100% similarity]
Documentation/input/notifier.rst [moved from Documentation/input/notifier.txt with 100% similarity]
Documentation/input/ntrig.rst [moved from Documentation/input/ntrig.txt with 100% similarity]
Documentation/input/rotary-encoder.rst [moved from Documentation/input/rotary-encoder.txt with 100% similarity]
Documentation/input/sentelic.rst [moved from Documentation/input/sentelic.txt with 100% similarity]
Documentation/input/userio.rst [moved from Documentation/input/userio.txt with 100% similarity]
Documentation/input/walkera0701.rst [moved from Documentation/input/walkera0701.txt with 100% similarity]
Documentation/input/xpad.rst [moved from Documentation/input/xpad.txt with 100% similarity]
Documentation/input/yealink.rst [moved from Documentation/input/yealink.txt with 100% similarity]
MAINTAINERS

index 7fadb3b..fef209e 100644 (file)
@@ -348,6 +348,8 @@ latex_documents = [
      'The kernel development community', 'manual'),
     ('driver-api/index', 'driver-api.tex', 'The kernel driver API manual',
      'The kernel development community', 'manual'),
+    ('input/index', 'linux-input.tex', 'The Linux input driver subsystem',
+     'The kernel development community', 'manual'),
     ('kernel-documentation', 'kernel-documentation.tex', 'The Linux Kernel Documentation',
      'The kernel development community', 'manual'),
     ('process/index', 'development-process.tex', 'Linux Kernel Development Documentation',
diff --git a/Documentation/input/conf.py b/Documentation/input/conf.py
new file mode 100644 (file)
index 0000000..d2352fd
--- /dev/null
@@ -0,0 +1,10 @@
+# -*- coding: utf-8; mode: python -*-
+
+project = "The Linux input driver subsystem"
+
+tags.add("subproject")
+
+latex_documents = [
+    ('index', 'linux-input.tex', project,
+     'The kernel development community', 'manual'),
+]
diff --git a/Documentation/input/index.rst b/Documentation/input/index.rst
new file mode 100644 (file)
index 0000000..153f0d4
--- /dev/null
@@ -0,0 +1,77 @@
+=============================
+The Linux Input Documentation
+=============================
+
+Disclaimer
+==========
+
+This program is free software; you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by the Free
+Software Foundation; either version 2 of the License, or (at your option)
+any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+more details.
+
+You should have received a copy of the GNU General Public License along
+with this program; if not, write to the Free Software Foundation, Inc., 59
+Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+For your convenience, the GNU General Public License version 2 is included
+in the package: See the file COPYING.
+
+
+Core API
+========
+
+.. toctree::
+   :maxdepth: 2
+   :numbered:
+
+   input
+   input-programming
+   event-codes
+   joystick
+   joystick-api
+   multi-touch-protocol
+   gamepad
+   gameport-programming
+   ff
+   notifier
+   userio
+
+Input drivers
+=============
+
+.. toctree::
+   :maxdepth: 2
+   :numbered:
+
+   alps
+   amijoy
+   appletouch
+   atarikbd
+   bcm5974
+   cd32
+   cma3000_d0x
+   cs461x
+   edt-ft5x06
+   elantech
+   iforce-protocol
+   joystick-parport
+   gpio-tilt
+   ntrig
+   rotary-encoder
+   sentelic
+   walkera0701
+   xpad
+   yealink
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
similarity index 92%
rename from Documentation/input/input.txt
rename to Documentation/input/input.rst
index fda995e..ac7669a 100644 (file)
@@ -6,30 +6,10 @@ Linux Input drivers
 
 :Copyright: |copy| 1999-2001 Vojtech Pavlik <vojtech@ucw.cz> - Sponsored by SuSE
 
-Disclaimer
-==========
-
-This program is free software; you can redistribute it and/or modify it
-under the terms of the GNU General Public License as published by the Free
-Software Foundation; either version 2 of the License, or (at your option)
-any later version.
-
-This program is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
-or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
-more details.
-
-You should have received a copy of the GNU General Public License along
-with this program; if not, write to the Free Software Foundation, Inc., 59
-Temple Place, Suite 330, Boston, MA 02111-1307 USA
-
 Should you need to contact me, the author, you can do so either by e-mail
 - mail your message to <vojtech@ucw.cz>, or by paper mail: Vojtech Pavlik,
 Simunkova 1594, Prague 8, 182 00 Czech Republic
 
-For your convenience, the GNU General Public License version 2 is included
-in the package: See the file COPYING.
-
 Introduction
 ============
 
index 1b0a87f..092de1d 100644 (file)
@@ -6488,7 +6488,7 @@ INPUT MULTITOUCH (MT) PROTOCOL
 M:     Henrik Rydberg <rydberg@bitmath.org>
 L:     linux-input@vger.kernel.org
 S:     Odd fixes
-F:     Documentation/input/multi-touch-protocol.txt
+F:     Documentation/input/multi-touch-protocol.rst
 F:     drivers/input/input-mt.c
 K:     \b(ABS|SYN)_MT_
 
@@ -13812,7 +13812,7 @@ YEALINK PHONE DRIVER
 M:     Henk Vergonet <Henk.Vergonet@gmail.com>
 L:     usbb2k-api-dev@nongnu.org
 S:     Maintained
-F:     Documentation/input/yealink.txt
+F:     Documentation/input/yealink.rst
 F:     drivers/input/misc/yealink.*
 
 Z8530 DRIVER FOR AX.25