Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 173397 - man portage doesn't mention /var/db/pkg/ or /var/cache/edb/
Summary: man portage doesn't mention /var/db/pkg/ or /var/cache/edb/
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords: InVCS
Depends on:
Blocks:
 
Reported: 2007-04-04 20:20 UTC by Nelson
Modified: 2007-07-10 20:38 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 Nelson 2007-04-04 20:20:23 UTC
I had no idea this existed, since it's not mentioned in the Files/other sections of the man page. Now that I know what it is by asking in the IRC, I noticed it's mentioned in the tbz2file section, but still it passes unnoticed since it's role is ommited.
Comment 1 SpanKY gentoo-dev 2007-04-04 22:15:38 UTC
nor should it be mentioned in `man emerge` ... easy enough to document it in `man portage` though
Comment 2 Nelson 2007-04-04 22:23:04 UTC
Ok, makes sense.

In that case just remove the mentioned files at man emerge and move them to man portage if not there. And put a notice saying Read the Files of portage. Because this way it leads to believe the only files it uses are the ones listed, that's why I thought (even though it sounded incredible not keeping a readable package list :P)

Man emerge should just stick to emerge arguments info and syntax and put a -big- notice to read man portage
Comment 3 SpanKY gentoo-dev 2007-04-04 22:51:19 UTC
the files mentioned at the end of `man emerge` are targeted at configuration settings that'd affect emerge ... /var/db/pkg does not fall into that category
Comment 4 Nelson 2007-04-04 23:10:37 UTC
Still, to avoid this confusion it wouldn't hurt to export them to portage in a category "configuration files". 

Or

Saying "these are just the files ment to be edited by the user. To know of more files that affect emerge behaviour, please read portage.
Comment 5 Nelson 2007-04-04 23:16:23 UTC
Sorry, actually to be coherent there are files mentioned there that are not supposed to be edited, so should be moved to portage.

Therefore with the *warning* I mentioned just now, and the  user "supposed to be " edited files, this doc would be perfect, the way I see it :P

Still, /var/db/pkg/ /var/cache/edb/ would have to be added to portage
Comment 6 SpanKY gentoo-dev 2007-04-07 04:50:03 UTC
man pages are updated now in svn
Comment 7 Nelson 2007-07-10 20:38:35 UTC
Out on 2.1.2.9, thanks