Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-x86+amd64-bootloader.xml
Date: Tue, 17 Nov 2009 05:55:48
Message-Id: E1NAH2S-0002tB-GK@stork.gentoo.org
1 nightmorph 09/11/17 05:55:40
2
3 Modified: hb-install-x86+amd64-bootloader.xml
4 Log:
5 ripped out VESA/VGA stuff in favor of only uvesafb, as it's in all kernels, not just gentoo-sources. bug 293455
6
7 Revision Changes Path
8 1.15 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.15&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.15&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?r1=1.14&r2=1.15
13
14 Index: hb-install-x86+amd64-bootloader.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
17 retrieving revision 1.14
18 retrieving revision 1.15
19 diff -u -r1.14 -r1.15
20 --- hb-install-x86+amd64-bootloader.xml 24 Sep 2009 20:26:50 -0000 1.14
21 +++ hb-install-x86+amd64-bootloader.xml 17 Nov 2009 05:55:40 -0000 1.15
22 @@ -4,12 +4,12 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.14 2009/09/24 20:26:50 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v 1.15 2009/11/17 05:55:40 nightmorph Exp $ -->
28
29 <sections>
30
31 -<version>6.4</version>
32 -<date>2009-09-24</date>
33 +<version>6.5</version>
34 +<date>2009-11-16</date>
35
36 <section>
37 <title>Making your Choice</title>
38 @@ -49,76 +49,19 @@
39 <p>
40 <e>If</e> you have configured your kernel with framebuffer support (or you used
41 <c>genkernel</c> default kernel configuration), you can activate it by adding a
42 -<c>vga</c> and/or a <c>video</c> statement to your bootloader configuration
43 -file.
44 +a <c>video</c> statement to your bootloader configuration file.
45 </p>
46
47 <p>
48 -First of all, you need to know what type of framebuffer device you're using. If
49 -you use a Gentoo patched kernel tree (such as <c>gentoo-sources</c>) you will
50 -have had the possibility of selecting <c>uvesafb</c> as the <e>VESA driver</e>.
51 -If this is the case, you are using <c>uvesafb</c> and <e>do not need</e> to set
52 -a <c>vga</c> statement. Otherwise you are using the <c>vesafb</c> driver and
53 -<e>need</e> to set the <c>vga</c> statement.
54 +First of all, you need to know your framebuffer device. You should have used
55 +<c>uvesafb</c> as the <e>VESA driver</e>.
56 </p>
57
58 <p>
59 -The <c>vga</c> statement controls the resolution and color depth of your
60 -framebuffer screen for <c>vesafb</c>. As stated in
61 -<path>/usr/src/linux/Documentation/fb/vesafb.txt</path> (which gets installed
62 -when you install a kernel source package), you need to pass the VESA number
63 -corresponding to the requested resolution and color depth to it.
64 -</p>
65 -
66 -<p>
67 -The following table lists the available resolutions and color depths and
68 -matches those against the value that you need to pass on to the <c>vga</c>
69 -statement.
70 -</p>
71 -
72 -<table>
73 -<tr>
74 - <ti></ti>
75 - <th>640x480</th>
76 - <th>800x600</th>
77 - <th>1024x768</th>
78 - <th>1280x1024</th>
79 -</tr>
80 -<tr>
81 - <th>256</th>
82 - <ti>0x301</ti>
83 - <ti>0x303</ti>
84 - <ti>0x305</ti>
85 - <ti>0x307</ti>
86 -</tr>
87 -<tr>
88 - <th>32k</th>
89 - <ti>0x310</ti>
90 - <ti>0x313</ti>
91 - <ti>0x316</ti>
92 - <ti>0x319</ti>
93 -</tr>
94 -<tr>
95 - <th>64k</th>
96 - <ti>0x311</ti>
97 - <ti>0x314</ti>
98 - <ti>0x317</ti>
99 - <ti>0x31A</ti>
100 -</tr>
101 -<tr>
102 - <th>16M</th>
103 - <ti>0x312</ti>
104 - <ti>0x315</ti>
105 - <ti>0x318</ti>
106 - <ti>0x31B</ti>
107 -</tr>
108 -</table>
109 -
110 -<p>
111 The <c>video</c> statement controls framebuffer display options. It needs to be
112 given the framebuffer driver followed by the control statements you wish to
113 enable. All variables are listed in
114 -<path>/usr/src/linux/Documentation/fb/vesafb.txt</path>. The most-used options
115 +<path>/usr/src/linux/Documentation/fb/uvesafb.txt</path>. The most-used options
116 are:
117 </p>
118
119 @@ -148,7 +91,6 @@
120 <tr>
121 <ti><c>mode</c></ti>
122 <ti>
123 - (<c>uvesafb</c> only)<br/>
124 Set up the resolution, color depth and refresh rate. For instance,
125 <c>1024x768-32@85</c> for a resolution of 1024x768, 32 bit color depth and a
126 refresh rate of 85 Hz.
127 @@ -157,8 +99,7 @@
128 </table>
129
130 <p>
131 -The result of those two statements could be something like <c>vga=0x318
132 -video=vesafb:mtrr:3,ywrap</c> or
133 +The result could be something like
134 <c>video=uvesafb:mtrr:3,ywrap,1024x768-32@85</c>. Write this setting down; you
135 will need it shortly.
136 </p>
137 @@ -185,7 +126,7 @@
138 The most critical part of understanding GRUB is getting comfortable with how
139 GRUB refers to hard drives and partitions. Your Linux partition
140 <path>/dev/sda1</path> will most likely be called <path>(hd0,0)</path> under
141 -GRUB. Notice the parentheses around the <path>hd0,0</path> - they are
142 +GRUB. Notice the parentheses around the <path>hd0,0</path> - they are
143 required.
144 </p>
145
146 @@ -338,11 +279,11 @@
147 </p>
148
149 <p>
150 -If you need to pass any additional options to the kernel, simply add
151 -them to the end of the kernel command. We're already passing one option
152 +If you need to pass any additional options to the kernel, simply add them to the
153 +end of the kernel command. We're already passing one option
154 (<c>root=/dev/sda3</c> or <c>real_root=/dev/sda3</c>), but you can pass others
155 -as well, such as the <c>video</c> and/or <c>vga</c> statements for framebuffer
156 -as we discussed previously.
157 +as well, such as the <c>video</c>> statement for framebuffer as we discussed
158 +previously.
159 </p>
160
161 <p>
162 @@ -605,7 +546,7 @@
163 label=gentoo
164 read-only
165 root=/dev/sda3
166 - <i>append="video=vesafb:mtrr,ywrap,1024x768-32@85"</i>
167 + <i>append="video=uvesafb:mtrr,ywrap,1024x768-32@85"</i>
168 </pre>
169
170 <p>