Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 366439 - The documentation(kernel-upgrade.xml) uses a bad example of $(eselect kernel) module (?)
Summary: The documentation(kernel-upgrade.xml) uses a bad example of $(eselect kernel...
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/doc/en/kernel-u...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-05-08 08:28 UTC by Boerby
Modified: 2011-05-29 00:40 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Boerby 2011-05-08 08:28:52 UTC
by using the documentation for upgradimg the kernel, it's told to update the sym link by using eselect.


lets see what the doc  (http://www.gentoo.de/doc/de/kernel-upgrade.xml  tells at point 4-1.2 both the english as the german one:
------------------------------------------------------------

(Installieren Sie eselect, wenn Sie es noch nicht haben)
# emerge eselect
(Eine Liste aller verfügbaren Kernel einsehen)
# eselect kernel list
Available kernel symlink targets:
  [1]   linux-2.6.9-gentoo-r1
  [2]   linux-2.6.9-gentoo-r2
(Auswählen des richtigen Kernels)
# eselect kernel set 1

------------------------------------------------------------


1. Why doesnt eselect show the running kernelvesion using the mark (*) ?
2. Why do we upgrade to the older Version listed at point [1] and not to the newer one listed at point [2], although  in 4-1.3 we are showed how to set the link on the latest version [2]?
   So i think the eselect should be :
   # eselect kernel set 2

lets see what the doc  (http://www.gentoo.de/doc/de/kernel-upgrade.xml  tells at point 4-1.3 both the english as the german one:

------------------------------------------------------------

# cd /usr/src
# ln -sfn linux-2.6.9-gentoo-r2 linux

------------------------------------------------------------


Reproducible: Always

Actual Results:  
by reading and following the doc for upgradeing the gentoo-sources, i bacame worried about whats the right version for setting the symlink (at the first time).
Comment 1 Panagiotis Christopoulos (RETIRED) gentoo-dev 2011-05-08 08:57:25 UTC
I don't know if this is a real bug. I think that the writer was just giving an example of how to use eselect. I"ll cc fox2mike[1] who was the one who did that change some years ago, and kernel team to properly review this. 

[1] http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml?r1=1.14&r2=1.15
Comment 2 Panagiotis Christopoulos (RETIRED) gentoo-dev 2011-05-08 08:59:45 UTC
wrt bug #113417
Comment 3 Boerby 2011-05-08 15:34:47 UTC
This I mean:
revision 1.15 version 0.4 line 20

It would be better to chnage the two lines from:


147	[1] linux-2.6.9-gentoo-r1

147	[1] linux-2.6.9-gentoo-r1 *

And mark it as the running kernel version


150	# <i>eselect kernel set 1</i>

150	# <i>eselect kernel set 2</i>


For setting the symlink to the latest version.
Comment 4 nm (RETIRED) gentoo-dev 2011-05-29 00:40:03 UTC
(In reply to comment #1)
> I don't know if this is a real bug. I think that the writer was just giving an
> example of how to use eselect.

It's not a "real" bug, no, but I took the time to add the marker. Also added an extra verification step.