Gentoo Archives: gentoo-doc-cvs

From: Joshua Saddler <nightmorph@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: usb-guide.xml
Date: Sun, 22 Jun 2008 01:13:08
Message-Id: E1KAE8c-0005UN-Ec@stork.gentoo.org
1 nightmorph 08/06/22 01:13:02
2
3 Modified: usb-guide.xml
4 Log:
5 updated USB HID config location. this update covers the handbooks and the USB guide. for the latter, i removed the section on kernel 2.4 configuration, as there are no 2.4 kernels supported by gentoo.
6
7 Revision Changes Path
8 1.18 xml/htdocs/doc/en/usb-guide.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?rev=1.18&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?rev=1.18&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?r1=1.17&r2=1.18
13
14 Index: usb-guide.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v
17 retrieving revision 1.17
18 retrieving revision 1.18
19 diff -u -r1.17 -r1.18
20 --- usb-guide.xml 19 May 2008 21:04:48 -0000 1.17
21 +++ usb-guide.xml 22 Jun 2008 01:13:02 -0000 1.18
22 @@ -1,6 +1,5 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v 1.17 2008/05/19 21:04:48 swift Exp $ -->
25 -
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v 1.18 2008/06/22 01:13:02 nightmorph Exp $ -->
27 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
28
29 <guide link="/doc/en/usb-guide.xml">
30 @@ -19,8 +18,8 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>1.13</version>
35 -<date>2007-04-09</date>
36 +<version>1.14</version>
37 +<date>2008-06-21</date>
38
39 <chapter>
40 <title>Introduction</title>
41 @@ -148,13 +147,6 @@
42 <title>Getting the kernel</title>
43 <body>
44
45 -<note>
46 -Since the 2005.0 release, Gentoo Linux uses 2.6 as the default kernel. Unless
47 -you are specifically using the 2.4 profile, <c>gentoo-sources</c> will be a
48 -2.6 kernel on <e>most</e> architectures. Please check your kernel version and
49 -then proceed with the configuration accordingly.
50 -</note>
51 -
52 <p>
53 First emerge the kernel sources of your choice. Here we'll use the
54 <c>gentoo-sources</c>. For more information on the various kernel sources
55 @@ -182,15 +174,13 @@
56
57 </body>
58 </section>
59 -<section id="newkernelconfig">
60 -<title>Config options for the 2.6.x kernel</title>
61 +<section>
62 +<title>Config options for the kernel</title>
63 <body>
64
65 <p>
66 -Now we will look at some of the options we will have to enable in the 2.6
67 -kernel to ensure proper USB support for our devices. If you are using a 2.4
68 -kernel, please proceed with <uri link="#oldkernelconfig">Config options for the
69 -2.4.x kernel</uri>.
70 +Now we will look at some of the options we will have to enable in the kernel to
71 +ensure proper USB support for our devices.
72 </p>
73
74 <note>
75 @@ -205,7 +195,7 @@
76 files accordingly.
77 </note>
78
79 -<pre caption="make menuconfig options for 2.6 kernels">
80 +<pre caption="make menuconfig options">
81 Device Drivers ---&gt;
82 SCSI device support ---&gt;
83
84 @@ -236,13 +226,6 @@
85 &lt;*&gt; USB Printer support
86 &lt;*&gt; USB Mass Storage support
87
88 -<comment>(Then the HID bits.
89 -You have to select HID input support if you have a USB keyboard,
90 -mouse, joystick or any other USB input device)</comment>
91 ---- USB Input Devices
92 -&lt;*&gt; USB Human Interface Device (full HID) support
93 - [*] HID input layer support
94 -
95 <comment>(If you have a USB Network Card like the RTL8150, you'll need this)</comment>
96 USB Network Adapters --->
97 &lt;*&gt; USB RTL8150 based ethernet device support (EXPERIMENTAL)
98 @@ -254,82 +237,22 @@
99 </pre>
100
101 <p>
102 -Now that your options are set, you can (re)compile the kernel and USB support
103 -should be functional once you reboot into the new kernel. You can now proceed
104 -to <uri link="#postkern">Seeing USB at work</uri> and see if everything is
105 -working as it should.
106 +If you have a USB keyboard, mouse, joystick, or any other input device, you need
107 +to enable HID support. Go back one level to "Device drivers" and enable HID
108 +support as shown:
109 </p>
110
111 -</body>
112 -</section>
113 -<section id="oldkernelconfig">
114 -<title>Config options for the 2.4.x kernel</title>
115 -<body>
116 -
117 -<p>
118 -We will look at the options the we will have to enable in the 2.4 kernel to
119 -ensure proper USB support for our devices. If you are using a 2.6 kernel,
120 -please look at <uri link="#newkernelconfig">Config options for the 2.6.x
121 -kernel</uri>.
122 -</p>
123 -
124 -<note>
125 -Examples in this document will show configuration options for basic USB
126 -support as well as those needed commonly, for example a USB mass storage
127 -device (most cameras and USB pen drives). If you have a specific USB device
128 -that needs to be configured, please look up your device's manual or search
129 -online to see if that device has support built-in into the kernel or custom
130 -drivers that you can use. Please note that for the sake of ease, all examples
131 -have the options compiled into the kernel. If you would like to have a modular
132 -kernel, ensure that you note down the various modules and adjust your config
133 -files accordingly.
134 -</note>
135 -
136 -<pre caption="make menuconfig options for 2.4 kernels">
137 -<comment>(This immediate config is only for those who have USB input devices.
138 -Input core support is needed by USB HID later.)</comment>
139 -Input core support ---&gt;
140 - &lt;*&gt; Input core support
141 - &lt; &gt; Keyboard support
142 - &lt; &gt; Mouse support
143 - &lt; &gt; Event interface support
144 -
145 -USB support ---&gt;
146 -
147 -<comment>(This is the root hub and is required for USB support.
148 -If you'd like to compile this as a module, it will be called usbcore.o)</comment>
149 -&lt;*&gt; Support for USB
150 -
151 -<comment>(Enable this option to see your USB devices in /proc/bus/usb.
152 -This is recommended.)</comment>
153 - [*] Preliminary USB device filesystem
154 -
155 -<comment>(Select at least one of the HCDs. If you are unsure, picking all is fine.)</comment>
156 ---- USB Host Controller Drivers
157 -&lt;*&gt; UHCI Alternate Driver (JE) support
158 -&lt; &gt; OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support
159 -
160 -<comment>(This is the device section. Select only what you need.)</comment>
161 ---- USB Device Class drivers
162 -&lt; &gt; USB Audio support
163 -&lt;*&gt; USB Mass Storage support
164 -&lt; &gt; USB Modem (CDC ACM) support
165 -&lt;*&gt; USB Printer support
166 -
167 -<comment>(Followed by the HID section. This is needed if you have an USB based input device.)</comment>
168 ---- USB Human Interface Devices (HID)
169 -&lt;*&gt; USB Human Interface Device (full HID) support
170 - [*] HID input layer support
171 -
172 -<comment>(If you have a serial to USB converter like the Prolific 2303, you'll need this)</comment>
173 -USB Serial Converter support --->
174 - &lt;*&gt; USB Serial Converter support
175 - &lt;*&gt; USB Prolific 2303 Single Port Serial Driver (NEW)
176 +<pre caption="Enabling HID support">
177 +Device Drivers ---&gt;
178 + [*] HID Devices ---&gt;
179 + &lt;*&gt; USB Human Interface Device (full HID) support
180 </pre>
181
182 <p>
183 -Now that the options are set, you can (re)compile the kernel and USB support
184 -should be functional once you reboot into the new kernel.
185 +Now that your options are set, you can (re)compile the kernel and USB support
186 +should be functional once you reboot into the new kernel. You can now proceed
187 +to <uri link="#postkern">Seeing USB at work</uri> and see if everything is
188 +working as it should.
189 </p>
190
191 </body>
192
193
194
195 --
196 gentoo-doc-cvs@l.g.o mailing list