82563 – Extracting the portage snapshot code example should not have hard-coded date in it.

Bug 82563 - Extracting the portage snapshot code example should not have hard-coded date in it.

Summary: Extracting the portage snapshot code example should not have hard-coded date ...

Status:	RESOLVED FIXED

Alias:	None

Product:	[OLD] Docs-user
Classification:	Unclassified
Component:	Gentoo Linux x86 Installation Guide (show other bugs)
Hardware:	All Linux

Importance:	High normal (vote)
Assignee:	Sven Vermeulen (RETIRED)

URL:	http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:

Depends on:
Blocks:

Reported:	2005-02-19 04:40 UTC by carthik
Modified:	2005-03-25 01:29 UTC (History)
CC List:	1 user (show)

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

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description carthik 2005-02-19 04:40:54 UTC

Section 5.d Code Listing 14 of the x86 installation guide at the URL http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5

has the following command in it:
# tar -xvjf /mnt/gentoo/portage-20041202.tar.bz2 -C /mnt/gentoo/usr

The line above this command says:
Make sure that you use the exact command; the last option is a capital C, not c.


Since it asks the user to use the exact command, the date "20041202" should not be hardcoded into Codelisting 14.


Reproducible: Always
Steps to Reproduce:
1. Visit http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5
2. View Section 5.d

Actual Results:  
Nothing, really, this is a doc bug.

Expected Results:  
Codelisting 14 in Section 5.d should be :
"# tar -xvjf /mnt/gentoo/portage-*.tar.bz2 -C /mnt/gentoo/usr"
or 
# tar -xvjf /mnt/gentoo/portage-<version-date>.tar.bz2 -C /mnt/gentoo/usr

Or something similar.

Comment 1 Sven Vermeulen (RETIRED) gentoo-dev

2005-02-19 08:34:59 UTC

Afaik, the date we list is the one that should be used. I'm not aware of different Portage snapshots being advised on the documentation.

Comment 2 carthik 2005-02-19 08:43:48 UTC

Thanks Sven,

But if that is the case, then this line on the same page :
"Fire up links2 (or lynx) and go to our Gentoo mirror list. Pick a mirror close to you and open the snapshots/ directory. There, download the latest Portage snapshot (for instance portage-20041202.tar.bz2) by selecting it and pressing D."

should be changed to _not_ say "latest" and instead specify the dated-version referred to later.

I followed the doc, and I downloaded the latest, only to see that I can't use the command given in the example, since the version numbers don't match.

Comment 3 Sven Vermeulen (RETIRED) gentoo-dev

2005-02-19 09:44:37 UTC

Ah, my bad, sorry. I was thinking on a different snapshot.

Comment 4 Sven Vermeulen (RETIRED) gentoo-dev

2005-03-25 01:29:31 UTC

hb-install-stage.xml updated.