Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 38532

Summary: etc-update information missing
Product: [OLD] Docs-user Reporter: Aquila <bart.braem>
Component: Portage User GuideAssignee: Sven Vermeulen (RETIRED) <swift>
Status: RESOLVED INVALID    
Severity: normal CC: docs-team
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Aquila 2004-01-17 10:49:11 UTC
A friend of mine made her first steps in gentoo, and didn't understand etc-update at all. Is it possible to mention it? More then one line would be appreciated to new users. We are so used to using it that it's trivial...
Something like: 
"etc-update allows you to update your configuration files. It will try to automatically merge the changes, and otherwise prompt you to do so. Pay attention to files you have changed, especially fstab and make.conf."

Reproducible: Always
Steps to Reproduce:
1.let a new user install gentoo linux and wait for some update to happen

Actual Results:  
Confusion
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2004-01-18 02:45:46 UTC
The Portage User Guide has been obsoleted by the second part of the Gentoo Handbook and will be removed from the documentation repository with the 2004 release.

A section on etc-update is available at http://www.gentoo.org/doc/en/handbook/handbook.xml?part=2&chap=4#doc_chap1_sect3
Comment 2 Aquila 2004-01-18 11:02:33 UTC
Would it be possible to link to that information from 11.b in the installation part? Just linking is enough, now it's pretty confusing. 
(Sorry if I'm just whining here, imho it's important)
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2004-01-19 01:36:27 UTC
A small question: does it really matter? I find it strange that at the end of the installation of Gentoo, etc-update is at all necessary. You should only need it when you update your system, but beforehand you didn't even had a system...
Comment 4 Aquila 2004-01-19 03:15:12 UTC
You're right there, it's a little bit later. Sorry for reopening.