.TH "REPOMAN" "1" "Dec 2005" "Portage 2.1" "Portage" .SH NAME repoman \- Gentoo's program to enforce a minimal level of quality assurance in packages added to the portage tree .SH SYNOPSIS \fBrepoman\fR [\fIoption\fR] [\fImode\fR] .SH DESCRIPTION .BR "Quality is job zero." .BR repoman is meant for Gentoo developers only due to the fact it does not work on a per-ebuild basis. It checks the quality of CVS repositories. Note: \fBrepoman commit\fR only works \fIinside local\fR CVS repositories. .SH OPTIONS .TP \fB-q\fR, \fB--quiet\fR Be less verbose about extraneous info .TP \fB-p\fR, \fB--pretend\fR Don't commit or fix anything; just show what would be done .TP \fB-i\fR, \fB--include-masked\fR Include masked packages in scans at category or tree level .TP \fB-x\fR, \fB--xmlparse\fR Forces the metadata.xml parse check to be carried out .TP \fB-v\fR, \fB--verbose\fR Displays every package name while checking .TP \fB-I\fR, \fB--ignore-arches\fR Ignore arch-specific failures (where arch != host) .TP \fB-m\fR, \fB--commitmsg\fR Adds a commit message via the command line .TP \fB-M\fR, \fB--commitmsgfile\fR Adds a commit message from the specified file .TP \fB-V\fR, \fB--version\fR Show version info .TP \fB-h\fR, \fB--help\fR Show this screen .SH MODES .TP .B full Scan directory tree for QA issues (full listing) .TP .B last Remember report from last run .TP .B help Show this screen .TP .B scan Scan directory tree for QA issues (default) .TP .B fix Fix simple QA issues (stray digests, missing digests) .TP .B lfull Remember report from last run (full listing) .TP .B commit Scan directory tree for QA issues; if OK, commit via cvs .SH QA KEYWORDS .TP .B CVS/Entries.IO_error Attempting to commit, and an IO error was encountered access the Entries file .TP .B DEPEND.bad User-visible ebuilds with bad DEPEND settings (matched against *visible* ebuilds) .TP .B DEPEND.badindev User-visible ebuilds with bad DEPEND settings (matched against *visible* ebuilds) in developing arch .TP .B DEPEND.badmasked Masked ebuilds with bad DEPEND settings (matched against *all* ebuilds) .TP .B DEPEND.badmaskedindev Masked ebuilds with bad DEPEND settings (matched against *all* ebuilds) in developing arch .TP .B DEPEND.syntax Syntax error in DEPEND (usually an extra/missing space/parenthesis) .TP .B DESCRIPTION.missing Ebuilds that have a missing or empty DESCRIPTION variable .TP .B HOMEPAGE.missing Ebuilds that have a missing or empty HOMEPAGE variable .TP .B IUSE.invalid This build has a variable in IUSE that is not in the use.desc or use.local.desc file .TP .B KEYWORDS.invalid This ebuild contains KEYWORDS that are not listed in profiles/arch.list or for which no valid profile was found .TP .B KEYWORDS.missing Ebuilds that have a missing or empty KEYWORDS variable .TP .B KEYWORDS.stupid Ebuilds that use KEYWORDS=-* instead of package.mask .TP .B LICENSE.invalid This ebuild is listing a license that doesnt exist in portages license/ dir. .TP .B LICENSE.missing Ebuilds that have a missing or empty LICENSE variable .TP .B LICENSE.syntax Syntax error in LICENSE (usually an extra/missing space/parenthesis) .TP .B LIVEVCS.stable Ebuild is a live ebuild (cvs, git, darcs, svn, etc) checkout with stable keywords. .TP .B PDEPEND.bad User-visible ebuilds with bad PDEPEND settings (matched against *visible* ebuilds) .TP .B PDEPEND.badindev User-visible ebuilds with bad PDEPEND settings (matched against *visible* ebuilds) in developing arch .TP .B PDEPEND.badmasked Masked ebuilds with PDEPEND settings (matched against *all* ebuilds) .TP .B PDEPEND.badmaskedindev Masked ebuilds with PDEPEND settings (matched against *all* ebuilds) in developing arch .TP .B PDEPEND.syntax Syntax error in PDEPEND (usually an extra/missing space/parenthesis) .TP .B PROVIDE.syntax Syntax error in PROVIDE (usually an extra/missing space/parenthesis) .TP .B RDEPEND.bad User-visible ebuilds with bad RDEPEND settings (matched against *visible* ebuilds) .TP .B RDEPEND.badindev User-visible ebuilds with bad RDEPEND settings (matched against *visible* ebuilds) in developing arch .TP .B RDEPEND.badmasked Masked ebuilds with RDEPEND settings (matched against *all* ebuilds) .TP .B RDEPEND.badmaskedindev Masked ebuilds with RDEPEND settings (matched against *all* ebuilds) in developing arch .TP .B RDEPEND.syntax Syntax error in RDEPEND (usually an extra/missing space/parenthesis) .TP .B SLOT.missing Ebuilds that have a missing or empty SLOT variable .TP .B changelog.missing Missing ChangeLog files .TP .B changelog.notadded ChangeLogs that exist but have not been added to cvs .TP .B digest.assumed Existing digest must be assumed correct (Package level only) .TP .B digest.disjointed Digests not added to cvs when the matching ebuild has been added .TP .B digest.fail Digest does not match the specified local file .TP .B digest.missing Digest files that are missing (ebuild exists, digest doesn't) .TP .B digest.notadded Digests that exist but have not been added to cvs .TP .B digest.partial Digest files do not contain all corresponding URI elements .TP .B digest.stray Digest files that do not have a corresponding ebuild .TP .B digest.unmatch Digests which are incomplete (please check if your USE/ARCH includes all files) .TP .B digest.unused Digest/Manifest entry has no matching SRC_URI entry .TP .B ebuild.allmasked All ebuilds are masked for this package (Package level only) .TP .B ebuild.badheader This ebuild has a malformed header .TP .B ebuild.disjointed Ebuilds not added to cvs when the matching digest has been added .TP .B ebuild.invalidname Ebuild files with a non-parseable or syntactically incorrect name (or using 2.1 versioning extensions) .TP .B ebuild.majorsyn This ebuild has a major syntax error that may cause the ebuild to fail partially or fully .TP .B ebuild.minorsyn This ebuild has a minor syntax error that contravenes gentoo coding style .TP .B ebuild.namenomatch Ebuild files that do not have the same name as their parent directory .TP .B ebuild.nesteddie Placing 'die' inside ( ) prints an error, but doesn't stop the ebuild. .TP .B ebuild.nostable There are no ebuilds that are marked as stable for your ARCH .TP .B ebuild.notadded Ebuilds that exist but have not been added to cvs .TP .B ebuild.output A simple sourcing of the ebuild produces output; this breaks ebuild policy. .TP .B ebuild.syntax Error generating cache entry for ebuild; typically caused by ebuild syntax error .TP .B file.UTF8 File is not UTF8 compliant .TP .B file.executable Ebuilds, digests, metadata.xml, Manifest, and ChangeLog do note need the executable bit .TP .B file.name File/dir name must be composed of only the following chars: a-zA-Z0-9._-+: .TP .B file.size Files in the files directory must be under 20k .TP .B filedir.missing Package lacks a files directory .TP .B metadata.bad Bad metadata.xml files .TP .B metadata.missing Missing metadata.xml files .TP .B usage.obsolete The ebuild makes use of an obsolete construct .TP .B variable.readonly Assigning a readonly variable .TP .B virtual.exists PROVIDE contains existing package names .TP .B virtual.unavailable PROVIDE contains a virtual which contains no profile default .TP .B virtual.versioned PROVIDE contains virtuals with versions .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .SH AUTHORS .nf Daniel Robbins Saleem Abdulrasool .fi .SH "SEE ALSO" .BR emerge (1)