Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 17472 - Update documentaion for ebuild and emerge
Summary: Update documentaion for ebuild and emerge
Status: RESOLVED INVALID
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Nicholas Jones (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-03-13 19:03 UTC by Martin Mokrejš
Modified: 2011-10-30 22:32 UTC (History)
0 users

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Martin Mokrejš 2003-03-13 19:03:51 UTC
It's quite difficult for a beginner to figure out how to uninstall package from
gentoo. The emerge manpage show refer in more places to ebuild manpage.

Second, the emerge manpage should mention at relevant places where user that
there is "ebuid unmerge" command and if I got it right,  that's the proper way
how to uninstall.

Manpage for emerge mentions that user can just download a package source using
"-f" option. It should say what the user is expected to do then with that file,
where to find the file(yes, see /etc/make.conf to get an idea that
/usr/portage/distfiles might exist) and that simple "emerge pkg" next time will
figure out that the file lies on the disk and so it will
unpack/compile/install/postinstall ... From the whole ebuild manpage it is not
clear what is the syntax. Ebuild always complains I have to specify two commands
... :(

like "ebuild unpack compile xfree" or what?

Add examples section to ebuild.1 and emerge.1.

Explain better what "emerge unmerge" and "emerge clean" does and suggest user to
user the "normal" way to uninstall packages - with pointer what command is that.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Nicholas Jones (RETIRED) gentoo-dev 2003-03-13 22:41:05 UTC
It's clear if you read the man pages.


From 'man emerge':
SYNOPSIS
       emerge [options]  [action] [ebuild | tbz2file | class | dependency] ...

ACTIONS
       unmerge (-C)
              WARNING: This action can remove important packages! Removes


From 'man ebuild':
SYNOPSIS
       ebuild file command [command]...