Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 13334 - need better explanation on using lynx
Summary: need better explanation on using lynx
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: Stoyan Zhekov (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-01-05 20:03 UTC by Robert Nagle
Modified: 2003-01-21 18:22 UTC (History)
0 users

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 Robert Nagle 2003-01-05 20:03:29 UTC
http://www.gentoo.org/doc/en/gentoo-x86-install.xml
Here is the documentation about how to download the stage 3 file. 

I'm not a lynx user, but I found it confusing. Wait, am I supposed to use wget 
within the lynx program? Am I supposed to open up another window so I can 
simultaneously keep the lynx program open and the wget program open. 

A far easier way to document this is to say

command > lynx http://www.ibiblio.org/pub/Linux/distributions/gentoo
Use the tab button to go to the right directory.
Highlight the appropriate stage you want to download
Press D which will initiate the download. 

This is pretty basic stuff, but newbies like me can trip over it. 

Code listing 8.1: Downloading Required Stages
 
# cd /mnt/gentoo
Use lynx to get the URL for your tarball
# lynx 
http://www.ibiblio.org/pub/Linux/distributions/gentoo/releases/1.4_rc2/x86/
# wget insert required stage tarball here.
Comment 1 John Davis (zhen) (RETIRED) gentoo-dev 2003-01-05 23:24:22 UTC
Normally, this is a choose thing. You can either use wget or lynx. wget is used
from the command line, and it is the easier/better of the two imho.

//zhen
Comment 2 Stoyan Zhekov (RETIRED) gentoo-dev 2003-01-15 20:51:27 UTC
Lynx is just a particular case. wget is the documented way. everybody is free to
use lynx, links, w3m etc. for download. why to change the docs for this?
Comment 3 Robert Nagle 2003-01-16 16:10:45 UTC
Well, there's a lot of things to document, and you are free to prioritize. 

But the documentation as it stands is incorrect. It won't do what you want it 
to do.

If you ran the commands as is, lynx wouldn't go back to the command line and 
you would be unable to run wget. You need to open up another command line to 
run wget. You skipped over a step or two here. Or you need to say that you can 
use either wget or lynx. 

This is an annoyance thing and many installers probably won't be sidetracked 
by this. But for new users/installers, details like these matter. 



Comment 4 Stoyan Zhekov (RETIRED) gentoo-dev 2003-01-20 23:55:18 UTC
Are you happy now? Can I close the bug?

Code listing 8.1: Downloading Required Stages

# cd /mnt/gentoo
Use lynx to get the URL for your tarball:
# lynx http://www.ibiblio.org/pub/Linux/distributions/gentoo/releases/1.4_rc2/x86/
Use Up and Down arrows keys (or the TAB key) to go to the right directory
Highlight the appropriate stage you want to download
Press d which will initiate the download
Save the file and quit the browser

OR use wget from the command line:
# wget insert URL to the required stage tarball here
Comment 5 Stoyan Zhekov (RETIRED) gentoo-dev 2003-01-21 18:22:32 UTC
No, response. Maybe that means "yes". So will close the bug.