From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1NAH2V-000570-4O for garchives@archives.gentoo.org; Tue, 17 Nov 2009 05:55:43 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id AD9B7E064E; Tue, 17 Nov 2009 05:55:41 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 6EF8CE064E for ; Tue, 17 Nov 2009 05:55:41 +0000 (UTC) Received: from stork.gentoo.org (stork.gentoo.org [64.127.104.133]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id 14A0367A59 for ; Tue, 17 Nov 2009 05:55:41 +0000 (UTC) Received: from nightmorph by stork.gentoo.org with local (Exim 4.69) (envelope-from ) id 1NAH2S-0002tJ-LX for gentoo-commits@lists.gentoo.org; Tue, 17 Nov 2009 05:55:40 +0000 From: "Joshua Saddler (nightmorph)" To: gentoo-commits@lists.gentoo.org Reply-To: gentoo-dev@lists.gentoo.org, nightmorph@gentoo.org Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-x86+amd64-bootloader.xml X-VCS-Repository: gentoo X-VCS-Files: hb-install-x86+amd64-bootloader.xml X-VCS-Directories: xml/htdocs/doc/en/handbook X-VCS-Committer: nightmorph X-VCS-Committer-Name: Joshua Saddler Content-Type: text/plain; charset=utf8 Message-Id: Sender: Joshua Saddler Date: Tue, 17 Nov 2009 05:55:40 +0000 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: dbaec19d-66fc-4552-85e8-347a235dd0cf X-Archives-Hash: 147269a14c6511b10cc9d8fc8fc8174a nightmorph 09/11/17 05:55:40 Modified: hb-install-x86+amd64-bootloader.xml Log: ripped out VESA/VGA stuff in favor of only uvesafb, as it's in all kern= els, not just gentoo-sources. bug 293455 Revision Changes Path 1.15 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-boot= loader.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/hand= book/hb-install-x86+amd64-bootloader.xml?rev=3D1.15&view=3Dmarkup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/hand= book/hb-install-x86+amd64-bootloader.xml?rev=3D1.15&content-type=3Dtext/p= lain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/hand= book/hb-install-x86+amd64-bootloader.xml?r1=3D1.14&r2=3D1.15 Index: hb-install-x86+amd64-bootloader.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+a= md64-bootloader.xml,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- hb-install-x86+amd64-bootloader.xml 24 Sep 2009 20:26:50 -0000 1.14 +++ hb-install-x86+amd64-bootloader.xml 17 Nov 2009 05:55:40 -0000 1.15 @@ -4,12 +4,12 @@ =20 - + =20 =20 -6.4 -2009-09-24 +6.5 +2009-11-16 =20
Making your Choice @@ -49,76 +49,19 @@

If you have configured your kernel with framebuffer support (or y= ou used genkernel default kernel configuration), you can activate it by a= dding a -vga and/or a video statement to your bootloader configurat= ion -file. +a video statement to your bootloader configuration file.

=20

-First of all, you need to know what type of framebuffer device you're us= ing. If -you use a Gentoo patched kernel tree (such as gentoo-sources) you= will -have had the possibility of selecting uvesafb as the VESA driv= er. -If this is the case, you are using uvesafb and do not need= to set -a vga statement. Otherwise you are using the vesafb driver= and -need to set the vga statement. +First of all, you need to know your framebuffer device. You should have = used +uvesafb as the VESA driver.

=20

-The vga statement controls the resolution and color depth of your -framebuffer screen for vesafb. As stated in -/usr/src/linux/Documentation/fb/vesafb.txt (which gets inst= alled -when you install a kernel source package), you need to pass the VESA num= ber -corresponding to the requested resolution and color depth to it. -

- -

-The following table lists the available resolutions and color depths and -matches those against the value that you need to pass on to the vga -statement. -

- - - - - - - - - - - - 0x301 - 0x303 - 0x305 - 0x307 - - - - 0x310 - 0x313 - 0x316 - 0x319 - - - - 0x311 - 0x314 - 0x317 - 0x31A - - - - 0x312 - 0x315 - 0x318 - 0x31B - -
640x480800x6001024x7681280x1024
256
32k
64k
16M
- -

The video statement controls framebuffer display options. It need= s to be given the framebuffer driver followed by the control statements you wish= to enable. All variables are listed in -/usr/src/linux/Documentation/fb/vesafb.txt. The most-used o= ptions +/usr/src/linux/Documentation/fb/uvesafb.txt. The most-used = options are:

=20 @@ -148,7 +91,6 @@ mode - (uvesafb only)
Set up the resolution, color depth and refresh rate. For instance, 1024x768-32@85 for a resolution of 1024x768, 32 bit color dep= th and a refresh rate of 85 Hz. @@ -157,8 +99,7 @@ =20

-The result of those two statements could be something like vga=3D0x31= 8 -video=3Dvesafb:mtrr:3,ywrap or +The result could be something like video=3Duvesafb:mtrr:3,ywrap,1024x768-32@85. Write this setting d= own; you will need it shortly.

@@ -185,7 +126,7 @@ The most critical part of understanding GRUB is getting comfortable with= how GRUB refers to hard drives and partitions. Your Linux partition /dev/sda1 will most likely be called (hd0,0) u= nder -GRUB. Notice the parentheses around the hd0,0 - they are +GRUB. Notice the parentheses around the hd0,0 - they are required.

=20 @@ -338,11 +279,11 @@

=20

-If you need to pass any additional options to the kernel, simply add -them to the end of the kernel command. We're already passing one option +If you need to pass any additional options to the kernel, simply add the= m to the +end of the kernel command. We're already passing one option (root=3D/dev/sda3 or real_root=3D/dev/sda3), but you can p= ass others -as well, such as the video and/or vga statements for frame= buffer -as we discussed previously. +as well, such as the video> statement for framebuffer as we discu= ssed +previously.

=20

@@ -605,7 +546,7 @@ label=3Dgentoo read-only root=3D/dev/sda3 - append=3D"video=3Dvesafb:mtrr,ywrap,1024x768-32@85" + append=3D"video=3Duvesafb:mtrr,ywrap,1024x768-32@85" =20