Bug 28075

Summary:	modules-update entered as update-modules and in MAN Docs as well
Product:	[OLD] Docs-user	Reporter:	John Henry <mythic>
Component:	Gentoo Linux x86 Installation Guide	Assignee:	Benny Chuang (RETIRED) <bennyc>
Status:	RESOLVED FIXED
Severity:	normal	CC:	docs-team
Priority:	High
Version:	unspecified
Hardware:	x86
OS:	Linux
URL:	http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap26
Whiteboard:
Package list:		Runtime testing required:	---
Attachments:	replace modules-update with update-modules

Description John Henry 2003-09-06 14:11:50 UTC

http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap26

On that Install page the command: "modules-update" is shown as "update-modules".
Further checking found that the man page for modules-update displays as
UPDATE-MODULES ( 8 ) .... etc
  NAME  update-modules

This occurred on a Recent Stage 1 install finished on 2003/09/06.
x86 Stage 1 install started on the 09/04 with the 20030806 tar file.
The man page was checked on this system.
Using Kernel gs-sources (Full compile).
Compiled using genkernel --config.
Followed all steps in Installation FAQ, except of course "update-modules".

This can confuse new users.

Comment 1 Benny Chuang (RETIRED) gentoo-dev

2003-09-06 17:52:11 UTC

modules-update and update-modules are the same,
update-modules is just a symlink to modules-update.
however, if you think there's a confusing part on the installation doc,
please point it out so we can see if there's any improvement to be done with.

Comment 2 SpanKY gentoo-dev

2003-09-06 19:37:37 UTC

update-modules is deprecated ... the symlink only exists for backward compat ... it may be removed in the future

please update any and all docs that read update-modules to say modules-update

Comment 3 Benny Chuang (RETIRED) gentoo-dev

2003-09-06 22:03:49 UTC

Created attachment 17210 [details, diff]
replace modules-update with update-modules

Please review the patch

Comment 4 John Henry 2003-09-07 01:10:47 UTC

I figured it was some sort of Backward compatibility issue.
It was no longer Symbolicly Link in the install I did.  Neither "man update-modules" nor attempting to Locate / Find / or just run it "update-modules" would work on this install.

I suggest updating the man page that gets installed as well as it comes out as:
"UPDATE-MODULES ( 8 )" as well.

Comment 5 Erwin (RETIRED) gentoo-dev

2003-09-07 01:29:13 UTC

Patch reviewed.

i've opened another bug for the manpage:
http://bugs.gentoo.org/show_bug.cgi?id=28101

Comment 6 Sven Vermeulen (RETIRED) gentoo-dev

2003-09-07 03:02:59 UTC

Committed to cvs