Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 28253 - undocumentated "F"-flag of "emerge -p"
Summary: undocumentated "F"-flag of "emerge -p"
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All All
: High trivial (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords: InVCS
Depends on:
Blocks:
 
Reported: 2003-09-09 04:49 UTC by plasmagunman
Modified: 2004-08-16 11:25 UTC (History)
1 user (show)

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


Attachments
Small documentation fix. (emergehelp.py.diff,1.07 KB, patch)
2003-10-16 05:28 UTC, Alexander Papaspyrou
Details | Diff
Patch proposal for portage-2.0.49-r13 (emergehelp.py.diff,1.07 KB, patch)
2003-10-16 05:30 UTC, Alexander Papaspyrou
Details | Diff
Patch proposal for portage-2.0.49-r13 (emergehelp.py.diff,1.04 KB, patch)
2003-10-16 07:04 UTC, Alexander Papaspyrou
Details | Diff
patch for portage-2.0.50-r1, --help (portage-2.0.50-r1.help_fetchrestricetd.patch,1.32 KB, patch)
2004-02-10 02:44 UTC, plasmagunman
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description plasmagunman 2003-09-09 04:49:02 UTC
"emerge java-sdk-docs -p" results

[ebuild  N F  ] dev-java/java-sdk-docs-1.4.2

and "emerge --help" doesn't explain the "F"-flag.


Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 plasmagunman 2003-09-09 04:51:46 UTC
sorry, forgot the "emerge --info", the version of portage should be interesting:

Portage 2.0.49-r3 (default-x86-1.4, gcc-3.2.3, glibc-2.3.2-r1, 2.4.20-gentoo-r5)
=================================================================
System uname: 2.4.20-gentoo-r5 i686 AMD Athlon(tm) Processor
ACCEPT_KEYWORDS="x86"
AUTOCLEAN="yes"
CFLAGS="-march=athlon-xp -O3 -pipe -fomit-frame-pointer"
CHOST="i686-pc-linux-gnu"
COMPILER="gcc3"
CONFIG_PROTECT="/etc /var/qmail/control /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"
CXXFLAGS="-march=athlon-xp -O3 -pipe -fomit-frame-pointer"
DISTDIR="/usr/portage/distfiles"
FEATURES="ccache sandbox userpriv usersandbox prelink"
GENTOO_MIRRORS="rsync://linux.rz.ruhr-uni-bochum.de/gentoo/ http://gentoo.mirror
s.pair.com/ ftp://gentoo.mirrors.pair.com/ ftp://gentoo.linux.no/pub/gentoo/ htt
p://gentoo.linux.no/ ftp://ftp.tu-clausthal.de/pub/linux/gentoo/ ftp://ftp.easyn
et.nl/mirror/gentoo/ http://ftp.easynet.nl/mirror/gentoo/ ftp://gentoo.inode.at/
source/ http://gentoo.inode.at/"
MAKEOPTS="-j1"
PKGDIR="/usr/portage/packages"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/usr/local/portage"
SYNC="rsync://rsync.de.gentoo.org/gentoo-portage"
USE="x86 3dfx 3dnow acpi avi crypt cups dga dvd emacs encode gdbm gif ipv6 java 
jpeg leim mbox mmx mpeg motif mozilla moznoirc moznomail moznocompose ncurses nl
s oav oggvorbis opengl oss pdflib pic png quicktime readline spell sse tetex tif
f truetype usb voodoo3 wmf X xmms xv zlib"
Comment 2 Carsten Lohrke (RETIRED) gentoo-dev 2003-09-09 06:26:22 UTC
"F" means that you have to fetch the files on your own, because for some reason (blame sun in this case) it isn't possible to do this automatically.

Do an emerge without -p to get further information.
Comment 3 plasmagunman 2003-09-09 06:35:26 UTC
yes, thanks, i already guessed that.

still it remains a bug, should be mentioned by "emerge --help".
Comment 4 SpanKY gentoo-dev 2003-09-09 08:12:42 UTC
rtfm

no really, it's in the manpage :)
Comment 5 plasmagunman 2003-09-09 08:24:18 UTC
well, my manpage says this:

       --pretend (-p)
              Instead of actually performing the merge,  simply  display  what
              *would*  have  been  installed if --pretend weren't used.  Using
              --pretend is strongly recommended before installing an  unfamil-
              iar  package.   In  the  printout,  N  = new, U = upgrading, R =
              replacing, B = blocked by an already installed package.
Comment 6 Matthew 2003-09-09 17:24:13 UTC
Scroll down and look at the output section. It does a good job explaining it...

OUTPUT
       While utilizing emerge and the pretend/verbose flags, the output may be a little hard to understand for the first time.  This section
       exists to explain what the shorthanded information means.

       [blocks B ] app-text/dos2unix (from pkg app-text/hd2u-0.8.0)
              Dos2unix  is Blocking hd2u from being emerged.  Blockers are defined when two packages will clobber each others files, or oth-
              erwise cause some form of breakage in your system.  However, blockers usually do not need to be simultaneously emerged because
              they usually provide the same functionality.

       [ebuild N ] app-games/qstat-25c
              Qstat is New to your system, and will be emerged for the first time.

       [ebuild R ] sys-apps/sed-4.0.5
              Sed 4.0.5 has already been emerged, but if you run the command, then portage will Re-emerge the specified package (sed in this
              case).

       [ebuild F ] media-video/realplayer-8-r6
              The realplayer package requires that you download the sources manually.  When you  attempt  to  emerge  the  package,  if  the
              sources  are  not  found,  then  portage  will halt and you will be provided with instructions on how to download the required
              files.
Comment 7 SpanKY gentoo-dev 2003-09-09 20:25:53 UTC
thats not the manpage, manpage is `man emerge` ...

i didnt think the `emerge --help` documented the flags thats why i closed the bug in the first place ...
Comment 8 Alexander Papaspyrou 2003-10-16 05:28:48 UTC
Created attachment 19314 [details, diff]
Small documentation fix.

This is a small fix adding the "F" flag to the output of "emerge --help".
Comment 9 Alexander Papaspyrou 2003-10-16 05:30:02 UTC
Created attachment 19315 [details, diff]
Patch proposal for portage-2.0.49-r13

This is a small fix adding the "F" flag to the output of "emerge --help".

Please review and commit upstream.
Comment 10 Alexander Papaspyrou 2003-10-16 05:34:42 UTC
Sorry for the dup, epiphany crashed during addition...
Comment 11 Alexander Papaspyrou 2003-10-16 07:04:33 UTC
Created attachment 19317 [details, diff]
Patch proposal for portage-2.0.49-r13

This is a small fix adding the "F" flag to the output of "emerge --help".
Corrected term to "fetch restrictions" which was suggested by Genone on
forums.gentoo.org

Please review and commit upstream.
Comment 12 Marius Mauch (RETIRED) gentoo-dev 2004-02-08 17:55:09 UTC
supposed to be fixed in 2.0.50 which is stable now. If this bug is not fixed please reopen.
Comment 13 plasmagunman 2004-02-08 23:56:12 UTC
no, it does not. "emerge -h" tells me:
       --pretend (-p short option)
              instead of actually performing the merge, simply display what
              ebuilds and tbz2s *would* have been installed if --pretend
              weren't used.  Using --pretend is strongly recommended before
              installing an unfamiliar package.  In the printout, N = new,
              U = updating, R = replacing, B = blocked by an already installed
              package, D = possible downgrading. --verbose causes affecting
              use flags to be printed out accompanied by a '+' for enabled
              and a '-' for disabled flags.

and "man emerge" explains it in the output-section, but above, in the options-section it says:
       --pretend (-p)
              Instead  of  actually  performing the merge, simply display what
              *would* have been installed if --pretend  weren't  used.   Using
              --pretend  is strongly recommended before installing an unfamil-
              iar package.  In the printout, N =  new,  U  =  upgrading,  R  =
              replacing, B = blocked by an already installed package.
there should be anything, perhaps a: "look below for a complete list of output-flags." if it's like this first people will assume, some flags aren't documentated and won't look further in the manpage.
Comment 14 plasmagunman 2004-02-08 23:57:23 UTC
by the way, before you ask:

08:53 root@hein:~ # emerge --version
Portage 2.0.50 (default-x86-1.4, gcc-3.2.3, glibc-2.3.2-r3, 2.6.2-mm1)
Comment 15 SpanKY gentoo-dev 2004-02-09 08:39:00 UTC
updated the manpage

up to you other peeps to do `emerge --help`
Comment 16 plasmagunman 2004-02-10 02:44:06 UTC
Created attachment 25328 [details, diff]
patch for portage-2.0.50-r1, --help

this fixes the "emerge --help"-issue.
Comment 17 Masatomo Nakano (RETIRED) gentoo-dev 2004-02-11 21:26:43 UTC
Fixed in CVS
Comment 18 Brian Harring (RETIRED) gentoo-dev 2004-08-16 11:25:36 UTC
Corrected a while back...