hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/process/submitting-drivers.rst
....@@ -5,8 +5,8 @@
55
66 This document is intended to explain how to submit device drivers to the
77 various kernel trees. Note that if you are interested in video card drivers
8
-you should probably talk to XFree86 (http://www.xfree86.org/) and/or X.Org
9
-(http://x.org/) instead.
8
+you should probably talk to XFree86 (https://www.xfree86.org/) and/or X.Org
9
+(https://x.org/) instead.
1010
1111 .. note::
1212
....@@ -16,7 +16,8 @@
1616
1717 Oh, and we don't really recommend submitting changes to XFree86 :)
1818
19
-Also read the Documentation/process/submitting-patches.rst document.
19
+Also read the :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
20
+document.
2021
2122
2223 Allocating Device Numbers
....@@ -24,10 +25,11 @@
2425
2526 Major and minor numbers for block and character devices are allocated
2627 by the Linux assigned name and number authority (currently this is
27
-Torben Mathiasen). The site is http://www.lanana.org/. This
28
+Torben Mathiasen). The site is https://www.lanana.org/. This
2829 also deals with allocating numbers for devices that are not going to
2930 be submitted to the mainstream kernel.
30
-See Documentation/admin-guide/devices.rst for more information on this.
31
+See :ref:`Documentation/admin-guide/devices.rst <admin_devices>`
32
+for more information on this.
3133
3234 If you don't use assigned numbers then when your device is submitted it will
3335 be given an assigned number even if that is different from values you may
....@@ -58,10 +60,11 @@
5860
5961 Licensing:
6062 The code must be released to us under the
61
- GNU General Public License. We don't insist on any kind
62
- of exclusive GPL licensing, and if you wish the driver
63
- to be useful to other communities such as BSD you may well
64
- wish to release under multiple licenses.
63
+ GNU General Public License. If you wish the driver to be
64
+ useful to other communities such as BSD you may release
65
+ under multiple licenses. If you choose to release under
66
+ licenses other than the GPL, you should include your
67
+ rationale for your license choices in your cover letter.
6568 See accepted licenses at include/linux/module.h
6669
6770 Copyright:
....@@ -115,9 +118,9 @@
115118 implemented") error. You should also try to make sure that your
116119 driver uses as little power as possible when it's not doing
117120 anything. For the driver testing instructions see
118
- Documentation/power/drivers-testing.txt and for a relatively
121
+ Documentation/power/drivers-testing.rst and for a relatively
119122 complete overview of the power management issues related to
120
- drivers see Documentation/driver-api/pm/devices.rst.
123
+ drivers see :ref:`Documentation/driver-api/pm/devices.rst <driverapi_pm_devices>`.
121124
122125 Control:
123126 In general if there is active maintenance of a driver by
....@@ -153,30 +156,30 @@
153156 where *country_code* == your country code, such as
154157 **us**, **uk**, **fr**, etc.
155158
156
- http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git
159
+ https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git
157160
158161 Linux kernel mailing list:
159162 linux-kernel@vger.kernel.org
160163 [mail majordomo@vger.kernel.org to subscribe]
161164
162165 Linux Device Drivers, Third Edition (covers 2.6.10):
163
- http://lwn.net/Kernel/LDD3/ (free version)
166
+ https://lwn.net/Kernel/LDD3/ (free version)
164167
165168 LWN.net:
166
- Weekly summary of kernel development activity - http://lwn.net/
169
+ Weekly summary of kernel development activity - https://lwn.net/
167170
168171 2.6 API changes:
169172
170
- http://lwn.net/Articles/2.6-kernel-api/
173
+ https://lwn.net/Articles/2.6-kernel-api/
171174
172175 Porting drivers from prior kernels to 2.6:
173176
174
- http://lwn.net/Articles/driver-porting/
177
+ https://lwn.net/Articles/driver-porting/
175178
176179 KernelNewbies:
177180 Documentation and assistance for new kernel programmers
178181
179
- http://kernelnewbies.org/
182
+ https://kernelnewbies.org/
180183
181184 Linux USB project:
182185 http://www.linux-usb.org/
....@@ -185,7 +188,7 @@
185188 http://www.fenrus.org/how-to-not-write-a-device-driver-paper.pdf
186189
187190 Kernel Janitor:
188
- http://kernelnewbies.org/KernelJanitors
191
+ https://kernelnewbies.org/KernelJanitors
189192
190193 GIT, Fast Version Control System:
191
- http://git-scm.com/
194
+ https://git-scm.com/