| Summary: | [TRACKER] 2008.0 Handbook Changes | ||
|---|---|---|---|
| Product: | [OLD] Docs on www.gentoo.org | Reporter: | nm (RETIRED) <nightmorph> |
| Component: | Installation Handbook | Assignee: | nm (RETIRED) <nightmorph> |
| Status: | RESOLVED FIXED | ||
| Severity: | normal | CC: | alpha, amd64, arm, docs-team, hppa, ia64, mips, ppc64, ppc, releng, sparc, swift, uberlord, x86 |
| Priority: | Highest | Keywords: | Tracker |
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | Linux | ||
| URL: | http://www.gentoo.org/proj/en/gdp/doc/handbook-release.xml | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
| Bug Depends on: | 179796, 208738 | ||
| Bug Blocks: | |||
|
Description
nm (RETIRED)
2007-11-01 20:41:02 UTC
...nice... thanks for the date leak... What part of "this is private information" wasn't clear in my email to -core? I don't even know why I try sometimes. Oh well, I'll just direct people to you when they ask what's going on when the date slips. There's one set of changes that I'm sure you'll need. I've changed dolvm2 and doevms2 to dolvm and doevms. The older ones will still work, but are deprecated. We're using baselayout-1.12.9-r2 for the release unless there's some bug/change that we need between now and the release. locking bug to devs Thanks Chris for the boot info; I changed it in the appropriate networkless handbooks, which is the only place I found it listed. However, I did notice that the regular networked handbooks for at least x86/amd64 do mention "nolvm2" and "noevms2" or whatever; should those also be changed? * * * MIPS (and GDP): I kicked out the extraneous hb-install-mips-system file, opting to instead use a conditional "profile" key to display when browsing the main hb-install-system file that all the other arches use. Less maintenance headache, but do let me know if this is indeed okay. We already talk about profiles in the Gentoo Upgrading Guide, anyway. I'd like to kick out the mips-stage file too, but after review it looks quite hard to clean up to fit in to the all-arches stage.xml file, so it will stay in for this release. (In reply to comment #3) > Thanks Chris for the boot info; I changed it in the appropriate networkless > handbooks, which is the only place I found it listed. However, I did notice > that the regular networked handbooks for at least x86/amd64 do mention "nolvm2" > and "noevms2" or whatever; should those also be changed? They should. Everything has a do*/no* pair. In most cases, only one or the other is "usable" since things are either defaulted to on or off, with everything enabled that won't potentially cause lock-ups. It wasn't November the 9th so no need to conceal the bug. For x86/amd64 GTK+ frontend section: * Remove the following sections: - Welcome - Network mounts - make.conf - Kernel sources - Daemons - Bootloader * Umm, that's about it. The only thing that really changed was networkless is now not a choice, so all the options for non-networkless are gone. The same basic info as Andrew just posted goes for the gli-dialog as well. Networkless mode is now no-longer a choice, and neither is there an "advanced" mode. The installer is now much simpler and harder for a user to screw up. Doing a manual test installation (maybe I find time to test the installer) worked fine...I tried to read the handbook :) and actually found no errors...just fyi. Status report: -x86/amd64 Updated boot parameters (comment #4) Updated gtkfe handbook (comment #6) Updated dialog handbook (comment #7) There are more updates pending for the Sparc and IA64 handbooks. - MIPS: what's up? Any changes? - PPC/PPC64: Still want to merge the handbooks for this release? I'd at least like to get the content changes in and worry about the internal formatting afterward. I don't mind continued partial duplication. Well, not all that much. - Alpha: I got an email indicating that you'll have networkless media for this release. If this is indeed the case, then I need you to review the 2006.1 networkless handbook (http://www.gentoo.org/doc/en/handbook/2006.1/handbook-alpha.xml) and report any changes to be made, ASAP. - ARM: vapier, anything new? (In reply to comment #8) > Doing a manual test installation (maybe I find time to test the installer) > worked fine...I tried to read the handbook :) and actually found no > errors...just fyi. Much appreciated. Thanks for your feedback. (In reply to comment #7) > The same basic info as Andrew just posted goes for the gli-dialog as well. > Networkless mode is now no-longer a choice, and neither is there an "advanced" > mode. The installer is now much simpler and harder for a user to screw up. Since the 20xx.y/* handbooks are specifically linked to for networkless installs, it's about time we ditched those handbooks. All they need is a mention in the regular handbook, something like "If you are using the LiveCD, now either start the installer and follow the on-screen instructions or keep on reading to perform a regular manual installation." Configuring the Kernel: http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=7 There should be an option here, possibly part of the manual, that explains how to use genkernel on an existing .config. If you follow the manual steps on this chapter, you will not get an initramfs. Creating one manually is time consuming and unnecessary, since genkernel will do it. An alternative to "make && make modules_install" would be to do "genkernel --no-clean --install-all", or at least point the user to look at the genkernel options to use it to build with an existing .config. It was a little unhelpful for me, as I was installing luks/lvm on the root partition and needed a custom kernel (and did not realize genkernel could do what it did for me). There were some instructions on luks in other places, but they were unnecessarily tedious. All I had to do was configure in the right kernel options and do: genkernel --no-clean --luks --lvm2 --no-splash --install all Thanks. Indeed. Only amd64/x86 use the installer currently, but I'd like to eventually change that. Most architectures haven't been shipping GRP packages, anyway, so only the distfiles on the Universal are usable for a networkless install. (In reply to comment #11) > There should be an option here, possibly part of the manual, that explains how > to use genkernel on an existing .config. If you follow the manual steps on > this chapter, you will not get an initramfs. Creating one manually is time > consuming and unnecessary, since genkernel will do it. . . . except the handbook is about *initial* installation, without a previous .config from a prior install/existing installation. We don't need to cover using genkernel for these corner cases. A better place for such information would be the genkernel guide at http://www.gentoo.org/doc/en/genkernel.xml. Most of the stuff you mentioned is already present in that guide. However, since we haven't had any content updates for the guide in a few years, we had to mark it "obsolete". If someone cares to do a thorough review & rewrite for all the genkernel changes since 2005, we'd be happy to update it with new stuff. Until then, though . . . > An alternative to "make && make modules_install" would be to do "genkernel > --no-clean --install-all", or at least point the user to look at the genkernel > options to use it to build with an existing .config. Did you notice that there's a separate section with separate install instructions for genkernel? Search for "genkernel all". RESO WONTFIX. Renamed the bug. Also, I need a GDP member to (sanely) rename all our 2007.1/ directories in CVS and move 'em over to 2008.0. Or to just call the thing "networkless" and not bother to archive them ever again. Which I am all in favor for; it would make updates far, far easier. Along with that is the usual s/2007.1/2008.0 for the text inside the files. There are a few global changes on top of what we had for 2007.1: * new kernel (currently 2.6.23-gentoo-r8) * new genkernel initramfs options: - dosshd (starts sshd) - passwd=foo (sets whatever is after the = as the root password) * new profile structure The new profile structure is the doosey. Chris will be able to give you a lot more details on the profiles. Actually, the profiles are easy. I changed default-linux to default/linux. If you were using: default-linux/amd64/2007.0/desktop you would now use: default/linux/amd64/2008.0/desktop It isn't much of a change from the way things are done now. What *has* changed fairly dramatically is the layout of the profiles and their inheritance structure, which is transparent to the end user. Can we also get rid of using `USE="foo" emerge bar` in 2008.0 handbook in favour of using package.use file? I mean listing 4.1 in Installing Necessary System Tools chapter: # USE="-gtk" emerge evms (In reply to comment #17) > Can we also get rid of using `USE="foo" emerge bar` in 2008.0 handbook in > favour of using package.use file? I mean listing 4.1 in Installing Necessary > System Tools chapter: > > # USE="-gtk" emerge evms > The use of USE environment variable is quite correct during the instalation, when the user wants to install something without installing all X packages. But later, when they system is installed, they'll want to use USE="gtk X" and such. GDP: Today (Feb 29) is our deadline to get at least the networkless & Portage handbooks done. I'll have to tarball them up by the end of the day and send them off to releng. (We ship an everything-on-one-page handbook for the appropriate arch). I need one of you to make the appropriate 2007.1 --> 2008.0 version number changes in each file. It's just a small thing, but this small thing will drive me crazy. I could really use the help. I'll see about handling the *content* changes; I just need someone to fix the version numbers. Arch teams, especially alpha, hppa, ia64, sparc: Who has a networkless release this year? Any other info that needs changing? Like kernel versions on the install media. PPC/PPC64: you guys have been completely silent this whole time on what needs changing. What's up? MIPS: Any changes for you? Drop the handbook completely? What? Status report: - Networkless handbooks are done. Emailed tarballs to releng. - Portage handbooks are done - Updated kernel versions and renamed everything to to 2008.0 (comments 14, 15, 19) - Added new boot options (comment #15) - Updated profiles from default-linux/ to default/linux/ (comment #16) - No change (comment #17) Most of the networked handbooks are done too. Biggest thing for them is bug 179796, since it's listed as a blocker. TODO: non-handbook files in /doc/en/ - gentoo-upgrading.xml - metadoc.xml Also: - /main/en/where.xml In 2008.0/index.xml there's a bunch of links to 2008.0 national handbooks. The problem is that some of them don't exist yet and I doubt some of them will ever be created. Link not found - /doc/id/handbook/2008.0/ Link not found - /doc/it/handbook/2008.0/ Link not found - /doc/zh_cn/handbook/2008.0/ Please fix this page to have only links to existent documents. We will add them when translators actually create them. (In reply to comment #21) > In 2008.0/index.xml there's a bunch of links to 2008.0 national handbooks. > Please fix this page to have only links to existent documents. We will add them > when translators actually create them. Did you lose your commit rights? Nope. I just prefer to tell people before I start touching their things. /doc/it/handbook/2008.0/* online 8) Sorry for the delay. (i've seen that /doc/zn_ch/handbook/2008.0/* is ready, too) nightmorph, I believe you had mentioned getting us updated docs tarballs for the beta. Should we still be waiting on that, or should we just use what you gave us previously? (In reply to comment #25) > nightmorph, I believe you had mentioned getting us updated docs tarballs for > the beta. Should we still be waiting on that, or should we just use what you > gave us previously? Yeah, just use the ones I originally sent in. I took another look at 'em, and there weren't really any showstopping procedural changes, mostly just internal XML stuff. I'll send you updated tarballs for the final release by the 26th, as per the timeline. Just a quick note, current stable gentoo-sources on x86 is 2.6.24-r3. Sorry for bugspam, think you would like to refer bug #213283 for more info about other architectures. (In reply to comment #24) > /doc/it/handbook/2008.0/* online 8) > > Sorry for the delay. > > (i've seen that /doc/zn_ch/handbook/2008.0/* is ready, too) > PING I wouldn't open a new bug for this thing, like #214347. Please, can you also add the link to Italian 2008.0 Handbook? It's ready to rock from several days 8) Alright, the beta is released, so the handbooks are published. Note that they're still marked with disclaimer="draft", until it's time for the final release. However, they are live. You may commit changes and fixes to them as usual, though there shouldn't be any ATM. We're back to normal version/date bumps, too, since I already made the major version bump. (In reply to comment #27) > Just a quick note, current stable gentoo-sources on x86 is 2.6.24-r3. > And from this kernel on, IDE disks are handled differently than before, so the following: "Code Listing 3.4: Activating DMA Device Drivers ---> ATA/ATAPI/MFM/RLL support ---> [*] Generic PCI bus-master DMA support" should be removed from "Configuring the Kernel" as it is no longer there in 2.6.24 (In reply to comment #31) Fixed. In hb-install-x86+amd64-medium.xml in the section on "Booting the Installation CD", gentoo-nofb is not listed as one of the available kernels for the amd64. It is listed for the x86 and it is an available kernel option on the amd64 2008.0_beta1 minimal cd. (In reply to comment #33) > In hb-install-x86+amd64-medium.xml in the section on "Booting the Installation > CD", gentoo-nofb is not listed as one of the available kernels for the amd64. > > It is listed for the x86 and it is an available kernel option on the amd64 > 2008.0_beta1 minimal cd. Actually, we already mention it: "Specifying a kernel? Yes, we provide several kernels on our Installation CDs. The default one is gentoo. Other kernels are for specific hardware needs and the -nofb variants which disable framebuffer." . . . it's just not listed in the table. Fixed in both handbooks. In chapter Choosing the Right Installation Medium for Alpha (file hb-install-alpha-medium.xml) for network-based installation in 2.a section (subsection: Booting the Installation CD) there is a link to taviso's web site which doesn't exist any more (In reply to comment #35) > In chapter Choosing the Right Installation Medium for Alpha (file > hb-install-alpha-medium.xml) for network-based installation in 2.a section > (subsection: Booting the Installation CD) there is a link to taviso's web site > which doesn't exist any more I removed the link to taviso's devspace; he retired some time ago. Alpha guys: is there any alternative for getting precompiled MILO images? Since we lack the ability to test MILO stuff, we really don't quite support it anymore. If a user comes up with a problem, we'll try to help, but beyond that, no. So nuke the reference (and it's direct descendants) without replacement. in hb-working-use.xml line 141 the 2004.3 profile's use flags are shown. don't you think this is a little outdated? :) (In reply to comment #38) > in hb-working-use.xml line 141 the 2004.3 profile's use flags are shown. don't > you think this is a little outdated? :) > same file, line 334 "These are the packages that would be merged, in order:" instead of "These are the packages that I would merge, in order:" Can we close this bug now? (In reply to comment #40) > Can we close this bug now? > No. I'll leave it open for awhile in case there are some release document-related issues that pop up. No issues reported; closing. |
