Gentoo Archives: gentoo-doc-cvs

From: Josh Saddler <nightmorph@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: usb-guide.xml udev-guide.xml bluetooth-guide.xml gentoo-x86-tipsntricks.xml
Date: Tue, 10 Apr 2007 06:49:12
Message-Id: E1HbA9z-0006VH-KP@stork.gentoo.org
1 nightmorph 07/04/10 06:48:59
2
3 Modified: usb-guide.xml udev-guide.xml bluetooth-guide.xml
4 gentoo-x86-tipsntricks.xml
5 Log:
6 DIE HOTPLUG DIE. by request of cardoe.
7
8 Revision Changes Path
9 1.16 xml/htdocs/doc/en/usb-guide.xml
10
11 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?rev=1.16&view=markup
12 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?rev=1.16&content-type=text/plain
13 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/usb-guide.xml?r1=1.15&r2=1.16
14
15 Index: usb-guide.xml
16 ===================================================================
17 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v
18 retrieving revision 1.15
19 retrieving revision 1.16
20 diff -u -r1.15 -r1.16
21 --- usb-guide.xml 13 Mar 2007 01:04:29 -0000 1.15
22 +++ usb-guide.xml 10 Apr 2007 06:48:59 -0000 1.16
23 @@ -1,5 +1,5 @@
24 <?xml version='1.0' encoding="UTF-8"?>
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v 1.15 2007/03/13 01:04:29 nightmorph Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/usb-guide.xml,v 1.16 2007/04/10 06:48:59 nightmorph Exp $ -->
27
28 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
29
30 @@ -19,8 +19,8 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>1.12</version>
35 -<date>2007-03-12</date>
36 +<version>1.13</version>
37 +<date>2007-04-09</date>
38
39 <chapter>
40 <title>Introduction</title>
41 @@ -512,42 +512,6 @@
42
43 </body>
44 </section>
45 -<section>
46 -<title>Hotplug</title>
47 -<body>
48 -
49 -<p>
50 -Gentoo uses <c>sys-apps/hotplug</c> to do some magic with <e>hot-pluggable</e>
51 -devices. Just like any other magic trick, there is a simple logic behind this
52 -one too. We shall now see what that is, and in the process hopefully we will be
53 -able to understand it better.
54 -</p>
55 -
56 -<p>
57 -Firmware can be defined as the software on a piece of hardware that is loaded
58 -and executed but can't be modified easily. Many devices have firmware in them
59 -to ensure that they work properly and often firmware may contain code that is
60 -critical to ensure that the hardware performs as expected. Firmware is present
61 -in a wide variety of computer devices ranging from ROM chips to state of the
62 -art USB and PCMCIA cards. When a device is plugged in, the firmware (which may,
63 -in some cases, be the driver as well) is read and loaded onto memory after
64 -which the device can be used by the system.
65 -</p>
66 -
67 -<p>
68 -To cut the long story short, Gentoo uses <c>sys-apps/hotplug</c> to handle
69 -the firmware side of things in <e>hot-pluggable</e> devices.
70 -<c>sys-apps/hotplug</c> will use the required firmware to make that device
71 -usable. The firmware should be put in the <path>/lib/firmware</path> directory
72 -and is picked up from there. Getting it is simple; the usual emerge will do.
73 -</p>
74 -
75 -<pre caption="Installing hotplug">
76 -# <i>emerge hotplug</i>
77 -</pre>
78 -
79 -</body>
80 -</section>
81 </chapter>
82
83 <chapter>
84
85
86
87 1.39 xml/htdocs/doc/en/udev-guide.xml
88
89 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/udev-guide.xml?rev=1.39&view=markup
90 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/udev-guide.xml?rev=1.39&content-type=text/plain
91 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/udev-guide.xml?r1=1.38&r2=1.39
92
93 Index: udev-guide.xml
94 ===================================================================
95 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v
96 retrieving revision 1.38
97 retrieving revision 1.39
98 diff -u -r1.38 -r1.39
99 --- udev-guide.xml 13 Mar 2007 00:40:27 -0000 1.38
100 +++ udev-guide.xml 10 Apr 2007 06:48:59 -0000 1.39
101 @@ -1,7 +1,7 @@
102 <?xml version='1.0' encoding="UTF-8"?>
103 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
104
105 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v 1.38 2007/03/13 00:40:27 nightmorph Exp $ -->
106 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v 1.39 2007/04/10 06:48:59 nightmorph Exp $ -->
107
108 <guide link="/doc/en/udev-guide.xml">
109 <title>Gentoo udev Guide</title>
110 @@ -19,8 +19,8 @@
111
112 <license/>
113
114 -<version>0.28</version>
115 -<date>2007-03-12</date>
116 +<version>0.29</version>
117 +<date>2007-04-09</date>
118
119 <chapter>
120 <title>What is udev?</title>
121 @@ -159,12 +159,11 @@
122 <body>
123
124 <p>
125 -Every time the kernel notices an update in the device structure, it calls the
126 -<path>/sbin/hotplug</path> program. Hotplug runs the applications linked in the
127 -<path>/etc/hotplug.d/default</path> directory where you will also find a symlink
128 -to the udev application. Hotplug directs the information given by the kernel to
129 -the udev application which performs the necessary actions on the
130 -<path>/dev</path> structure (creating or deleting device files).
131 +Every time the kernel gets an event in the device structure, it asks udev to
132 +take a look. udev follows the rules in the <path>/etc/udev/rules.d/</path>
133 +directory. udev then uses the information given by the kernel to perform the
134 +necessary actions on the <path>/dev</path> structure (creating or deleting
135 +device files).
136 </p>
137
138 </body>
139 @@ -179,7 +178,7 @@
140
141 <p>
142 udev is meant to be used in combination with a 2.6 kernel (like
143 -<c>gentoo-sources</c> with the default 2005.0 profile). If you're using such a
144 +<c>gentoo-sources</c> with the default 2007.0 profile). If you're using such a
145 kernel then you just have to make sure that you have a recent
146 <c>sys-apps/baselayout</c> version. That's all you need.
147 </p>
148 @@ -189,17 +188,6 @@
149 </pre>
150
151 <p>
152 -udev will install <c>hotplug-base</c> as one of its dependencies. You do not
153 -need to install <c>hotplug</c> unless you want your modules automatically
154 -loaded when you plug devices in. <c>hotplug</c> also handles the automated
155 -bringup of network devices and firmware downloading.
156 -</p>
157 -
158 -<pre caption="Installing optional hotplug scripts">
159 -# <i>emerge hotplug</i>
160 -</pre>
161 -
162 -<p>
163 Kernelwise, be sure to activate the following options:
164 </p>
165
166 @@ -214,18 +202,6 @@
167 </pre>
168
169 <p>
170 -You can leave the <c>/dev file system support (OBSOLETE)</c> active if you
171 -wish but you have to make sure that "Automatically mount at boot" is disabled:
172 -</p>
173 -
174 -<pre caption="Don't automatically mount devfsd">
175 -File systems ---&gt;
176 - Pseudo Filesystems ---&gt;
177 - [*] /dev file system support (OBSOLETE)
178 - [ ] Automatically mount at boot
179 -</pre>
180 -
181 -<p>
182 If you use <c>genkernel</c>, don't forget to run it with the <c>--udev</c>
183 option to enable all the required kernel configuration directives. The default
184 configuration given by this <c>genkernel</c> invocation is sufficient.
185
186
187
188 1.12 xml/htdocs/doc/en/bluetooth-guide.xml
189
190 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml?rev=1.12&view=markup
191 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml?rev=1.12&content-type=text/plain
192 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml?r1=1.11&r2=1.12
193
194 Index: bluetooth-guide.xml
195 ===================================================================
196 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v
197 retrieving revision 1.11
198 retrieving revision 1.12
199 diff -u -r1.11 -r1.12
200 --- bluetooth-guide.xml 13 Mar 2007 00:40:27 -0000 1.11
201 +++ bluetooth-guide.xml 10 Apr 2007 06:48:59 -0000 1.12
202 @@ -1,7 +1,7 @@
203 <?xml version='1.0' encoding="UTF-8"?>
204
205 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
206 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.11 2007/03/13 00:40:27 nightmorph Exp $ -->
207 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bluetooth-guide.xml,v 1.12 2007/04/10 06:48:59 nightmorph Exp $ -->
208
209 <guide link="/doc/en/bluetooth-guide.xml">
210 <title>Gentoo Linux Bluetooth Guide</title>
211 @@ -32,8 +32,8 @@
212 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
213 <license/>
214
215 -<version>1.7</version>
216 -<date>2007-01-14</date>
217 +<version>1.8</version>
218 +<date>2007-04-09</date>
219
220 <chapter id="introduction">
221 <title>Introduction</title>
222 @@ -108,9 +108,8 @@
223 <p>
224 As the latest Linux stable kernel is 2.6, the configuration will be done for
225 these series of the kernel. Most Bluetooth devices are connected to a USB port,
226 -so USB will be enabled too. If you want, you can use hotplugging in case you
227 -want to use modules instead of compiling support built into the kernel. Please,
228 -refer to the <uri link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>.
229 +so USB will be enabled too. Please refer to the <uri
230 +link="/doc/en/usb-guide.xml"> Gentoo Linux USB Guide</uri>.
231 </p>
232
233 <pre caption="Configuration for 2.6 kernels">
234 @@ -213,17 +212,6 @@
235 Do not emerge <c>bluez-sdp</c> as it will break <c>bluez-utils</c>!
236 </warn>
237
238 -<p>
239 -Additionally, as we have compiled the Bluetooth subsystem as modules, we will
240 -need hotplug, which is explained in the <uri
241 -link="http://www.gentoo.org/doc/en/usb-guide.xml#doc_chap4_sect2">Gentoo Linux
242 -USB Guide</uri>.
243 -</p>
244 -
245 -<pre caption="Emerging hotplug">
246 -# <i>emerge hotplug</i>
247 -</pre>
248 -
249 </body>
250 </section>
251 <section>
252
253
254
255 1.23 xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml
256
257 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml?rev=1.23&view=markup
258 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml?rev=1.23&content-type=text/plain
259 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml?r1=1.22&r2=1.23
260
261 Index: gentoo-x86-tipsntricks.xml
262 ===================================================================
263 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml,v
264 retrieving revision 1.22
265 retrieving revision 1.23
266 diff -u -r1.22 -r1.23
267 --- gentoo-x86-tipsntricks.xml 23 Jan 2007 06:49:10 -0000 1.22
268 +++ gentoo-x86-tipsntricks.xml 10 Apr 2007 06:48:59 -0000 1.23
269 @@ -1,6 +1,6 @@
270 <?xml version='1.0' encoding="UTF-8"?>
271 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
272 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml,v 1.22 2007/01/23 06:49:10 nightmorph Exp $ -->
273 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-tipsntricks.xml,v 1.23 2007/04/10 06:48:59 nightmorph Exp $ -->
274
275 <guide link="/doc/en/gentoo-x86-tipsntricks.xml">
276 <title>Gentoo/x86 Installation Tips &amp; Tricks</title>
277 @@ -23,8 +23,8 @@
278 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
279 <license/>
280
281 -<version>1.12</version>
282 -<date>2006-10-04</date>
283 +<version>1.13</version>
284 +<date>2007-04-09</date>
285
286 <chapter>
287 <title>Introduction</title>
288 @@ -276,10 +276,9 @@
289 </pre>
290
291 <p>
292 -Make sure you <c>emerge hotplug</c> and have it added to the boot runlevel. To
293 -have all modules that are currently running (from the Installation CD) loaded during
294 -bootup of your Gentoo system, run the following command from within the chrooted
295 -environment:
296 +To have all modules that are currently running (from the Installation CD) loaded
297 +during bootup of your Gentoo system, run the following command from within the
298 +chrooted environment:
299 </p>
300
301 <pre caption="Adding all running modules to the modules.conf file">
302
303
304
305 --
306 gentoo-doc-cvs@g.o mailing list