Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 86914 - The documentation in the minimal livecd (x86) is apperaing to be for the Universal Livecd.
Summary: The documentation in the minimal livecd (x86) is apperaing to be for the Univ...
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Release Media
Classification: Unclassified
Component: Everything (show other bugs)
Hardware: All Linux
: High enhancement
Assignee: Gentoo Release Team
URL:
Whiteboard:
Keywords: InVCS
: 88111 92288 (view as bug list)
Depends on:
Blocks:
 
Reported: 2005-03-27 18:05 UTC by Rajiv Battula
Modified: 2005-08-15 11:39 UTC (History)
3 users (show)

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


Attachments
Getting Online TXT document (getting-online,20.08 KB, text/plain)
2005-07-13 06:33 UTC, Sven Vermeulen (RETIRED)
Details
Getting Online (now with Alcatel Speedtouch USB support!) (getting-online.txt,21.27 KB, text/plain)
2005-07-28 08:58 UTC, Sven Vermeulen (RETIRED)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Rajiv Battula 2005-03-27 18:05:37 UTC
when I go into the docs/(html or pdf or text) and read the handbook for 2005.0. The handbook give me the instruction for the installation of universal livecd method.

Reproducible: Always
Steps to Reproduce:
1.Burn x86 Minimal Livecd for 2005.0 release
2.Incert the cd and go to the docs directory
3.Read the docs which appear to be for the universal livecd method.
Actual Results:  
the documentation was for the universal live cd method

Expected Results:  
the handboot should have contained the docs for the installation method using
the minimal livecd.

I just booted the minimal livecd and started reading the handbook when I noticed
the error
Comment 1 Chris Gianelloni (RETIRED) gentoo-dev 2005-03-28 05:58:04 UTC
Rajiv is correct.

In the future (2005.1) we'll probably want 2 docs tarballs, one for networked and one for networkless.  This really was our fault for not thinking about this sooner and helping you to get the documentation prepared for this before the release.
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2005-03-28 12:20:14 UTC
Perhaps it is more wise to have the Minimal installation CD /not/ contain any documentation and have the user go to http://www.gentoo.org/doc/en/handbook/handbook-${ARCH}.xml? I'm deadserious about this, since an install using the minimal installation CD will be an average of 3 months further then the release and many things might have changed. Especially with the network-based installations.
Comment 3 Chris Gianelloni (RETIRED) gentoo-dev 2005-03-28 12:42:52 UTC
Actually, that really is a good idea.  They're going to have to have a network anyway, so why not just point them to the online documentation?

I'll adjust catalyst's motd generation for this.

I think I would rather use http://www.gentoo.org/doc/en/handbook/index.xml as the location to point to, simply to make it more generic and allow the user to pick their preferred layout.
Comment 4 Benjamin Judas (RETIRED) gentoo-dev 2005-03-28 13:10:05 UTC
We could maybe add a bash-alias like "handbook" for "links2 http://www.gentoo.org/doc/en/handbook/handbook-x86.xml"
Comment 5 Sven Vermeulen (RETIRED) gentoo-dev 2005-03-28 14:01:38 UTC
The only thing that still needs to be documented is how to configure the network. But since net-setup is still available on the minimal installcd (dunno if it will be kept for 2005.1) that shouldn't be too hard.
Comment 6 Rajiv Battula 2005-03-28 19:59:49 UTC
Yeah having the user go to the handbook on the website is better than having it on the cd. you guys are correct the user would do a net install with the minimal livecd. thus they would need their network configured. I think there should be a command like Benjamin said. maybe there can be a simple shell script to launch links2 and go to the handbook page. thanks for your time guys
Comment 7 Xavier Neys (RETIRED) gentoo-dev 2005-03-29 00:13:47 UTC
`links2 docs.gentoo.org/handbook` will do the same and I am sure infra wouldn't mind giving us a nifty handbook.gentoo.org
Comment 8 Michael Young 2005-04-04 21:15:26 UTC
I agree that this is a problem.  I burned a minimal CD which contained instructions on a universal CD install.  I got hung up for an hour (because I'm careful & was afraid to plow ahead) on section 5 when I was told to copy the Portage snapshot & distfiles off the CD.  Thanks for looking at all our suggestions & making Gentoo's documenation great.
Comment 9 Chris Gianelloni (RETIRED) gentoo-dev 2005-04-05 20:04:12 UTC
*** Bug 88111 has been marked as a duplicate of this bug. ***
Comment 10 Chris Gianelloni (RETIRED) gentoo-dev 2005-05-12 06:10:02 UTC
*** Bug 92288 has been marked as a duplicate of this bug. ***
Comment 11 Sven Vermeulen (RETIRED) gentoo-dev 2005-07-13 06:33:38 UTC
Created attachment 63311 [details]
Getting Online TXT document

This is a dump of the "Getting Online" chapter of the handbook with minor
tweaks. Open for suggestions, be free to update. Roger55 asked me to write up a
TXT to include on the minimal Installation CDs.
Comment 12 Chris Gianelloni (RETIRED) gentoo-dev 2005-07-13 06:58:19 UTC
Sweet... I'll add this to catalyst so it gets onto the CD...
Comment 13 Jan Kundrát (RETIRED) gentoo-dev 2005-07-21 14:15:21 UTC
Could this be closed? 
Comment 14 Chris Gianelloni (RETIRED) gentoo-dev 2005-07-21 14:54:38 UTC
No.

I haven't added it to catalyst yet, and we have not had another release yet.
Comment 15 Chris Gianelloni (RETIRED) gentoo-dev 2005-07-27 15:07:32 UTC
OK... This support has been added to catalyst and this bug will be closed when
2005.1 is released...
Comment 16 Sven Vermeulen (RETIRED) gentoo-dev 2005-07-28 08:58:46 UTC
Created attachment 64545 [details]
Getting Online (now with Alcatel Speedtouch USB support!)

This one adds Alcatel USB Speedtouch support as requested by #89863.
Comment 17 Chris Gianelloni (RETIRED) gentoo-dev 2005-07-28 10:53:46 UTC
oooh... Sven... me love you long time... *wink*

I've just updated this with the latest information... thanks again...
Comment 18 Chris Gianelloni (RETIRED) gentoo-dev 2005-08-15 11:39:09 UTC
2005.1 is out now, so this can be resolved...