Bug 19371 – man page of emerge program is incomplete - there is no description of -U (--upgradeonly)

• Status: RESOLVED FIXED
• Product: [OLD] Docs-user

[Description Dmitry Suzdalev 2003-04-15 14:35:19 UTC]

Emerge's man page doesn't contain description of -U (--upgradeonly) option. Although 
"emerge --help" shows description of that option. Version info follows: 
 
#emerge --version 
 
Portage 2.0.47-r10 (default-x86-1.4, gcc-3.2.2, glibc-2.3.1-r4) 

Reproducible: Always
Steps to Reproduce:
1. man emerge 
2. emerge --help 
3. compare output :) 
Actual Results:  
I can't see description of -U option in manual page. 

Expected Results:  
It should have description of -U option in manual page 

Portage 2.0.47-r10 (default-x86-1.4, gcc-3.2.2, glibc-2.3.1-r4) 
================================================================= 
System uname: 2.4.20 i686 AMD Athlon(tm) XP 1700+ 
GENTOO_MIRRORS="http://gentoo.linux.no/ http://gentoo.oregonstate.edu/ 
http://www.ibiblio.org/pub/Linux/distributions/gentoo" 
CONFIG_PROTECT="/etc /var/qmail/control /usr/share/config /usr/kde/2/share/config 
/usr/kde/3/share/config 
/usr/X11R6/lib/X11/xkb:/usr/kde/3.1/share/config:/usr/share/config" 
CONFIG_PROTECT_MASK="/etc/gconf /etc/env.d" 
PORTDIR="/usr/portage" 
DISTDIR="/usr/portage/distfiles" 
PKGDIR="/usr/portage/packages" 
PORTAGE_TMPDIR="/var/tmp" 
PORTDIR_OVERLAY="" 
USE="x86 oss 3dnow apm avi crypt encode gif jpeg kde libg++ libwww mikmod mmx 
mpeg ncurses nls pdflib png truetype xml2 xmms xv zlib slang readline tcltk java X sdl 
gpm pam perl python esd imlib oggvorbis gtk qt opengl acpi alsa -arts -berkdb cdr 
-cups -gdbm -gnome maildir -motif -quicktime -spell sse -ssl -svga -tcpd" 
COMPILER="gcc3" 
CHOST="i686-pc-linux-gnu" 
CFLAGS="-march=athlon-xp -O3 -pipe -fomit-frame-pointer" 
CXXFLAGS="-march=athlon-xp -O3 -pipe -fomit-frame-pointer" 
ACCEPT_KEYWORDS="x86" 
MAKEOPTS="-j2" 
AUTOCLEAN="yes" 
SYNC="rsync://rsync.gentoo.org/gentoo-portage" 
FEATURES="sandbox ccache"

[Comment 1 Claes Strom 2003-06-23 02:02:25 UTC]

All options NOT found in the manpage of emerge:

-l (changelog) [1]
-p (quiet) [1]
-B (buildpkgonly) [1]
-D (deep)
-K (usepkgonly) [1]
-O (nodeps)
-U (upgradeonly) [1]
-V (version)

[1] "Long option" isn't either documented either in manpage

Should the manpage get fixed or wiped or replaced with the text "run: emerge -h"?

[Comment 2 Claes Strom 2003-06-23 02:05:42 UTC]

BTW look at my "Proposal" in the forum:
http://forums.gentoo.org/viewtopic.php?p=380692

[Comment 3 SpanKY 2003-06-23 04:41:36 UTC]

i fixed this in cvs a while back