Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 66346 - several typos in the manpage of emerge [patch attached]
Summary: several typos in the manpage of emerge [patch attached]
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: High trivial (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-10-04 13:51 UTC by Benno Schulenberg
Modified: 2004-10-07 16:05 UTC (History)
0 users

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


Attachments
corrects typos and some inconsistencies (emerge.man.patch,14.09 KB, patch)
2004-10-04 13:54 UTC, Benno Schulenberg
Details | Diff
corrects a typo and a few other things (emerge.man.few.patch,2.27 KB, patch)
2004-10-06 13:49 UTC, Benno Schulenberg
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Benno Schulenberg 2004-10-04 13:51:35 UTC
mistakes in the emerge manpage of version 2.0.51_rc7 of portage


Reproducible: Always
Steps to Reproduce:
1. man emerge
2.
3.



(please bear with me, I have to figure out how to attach the patch)
Comment 1 Benno Schulenberg 2004-10-04 13:54:04 UTC
Created attachment 41091 [details, diff]
corrects typos and some inconsistencies
Comment 2 SpanKY gentoo-dev 2004-10-04 20:21:41 UTC
i fixed most of the grammar stuff ...

as for the first few hunks, things have been changed in cvs since you made your patch, so please review cvs and see if your intended changes are still needed

thanks
Comment 3 Benno Schulenberg 2004-10-06 13:49:08 UTC
Created attachment 41247 [details, diff]
corrects a typo and a few other things

Also, there's an inconsistent use of "portage" and "Portage" throughout the 
document.  Furthermore, if the synopsis mentions "-h" it should also mention 
"-V".  But I think it's clearer without "-h", which is mentioned below 
anyway.  It's a summary, no need to mention everything.  Also, I think there's 
no need to mention "--metadata" in the synopsis, as it isn't something one 
would normally use, "--info" and "--search" seem much more useful to me there.
Comment 4 SpanKY gentoo-dev 2004-10-06 17:47:27 UTC
the --help | -h bit is indicating that you can run `emerge -h sync` and get helpful info about the sync command

--metadata is put alongside --sync because they both deal with cache rebuilding ... but you're right, it is probably better with --info | --search since those are common commands ... added that to cvs
Comment 5 Benno Schulenberg 2004-10-07 03:01:06 UTC
SpanKY wrote:
> the --help | -h bit is indicating that you can run `emerge -h sync`

What I meant was that the "| -h" part is unneeded, as this abbreviation is 
mentioned below.  It's enough to indicate `emerge --help sync` and friends.

By the way, in portage 2.0.50 `emerge -h world` and `emerge -h info` give 
zero output.  Both should say _something_, IMO.  The first could easily 
produce a text similar to `emerge -h system`, and the other... maybe 
simply the short help.
Comment 6 SpanKY gentoo-dev 2004-10-07 16:05:54 UTC
ah, true ... removed the -h part

the other part is not suitable for this bug ... please open a new one