forked from ~ljy/RK356X_SDK_RELEASE
blame | history | patch | commit | commitdiff
hc
2024-01-31 f70575805708cabdedea7498aaa3f710fde4d920 
 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/