REPOMAN

NAME

SYNOPSIS

DESCRIPTION

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: repoman commit only works inside local CVS repositories.  

OPTIONS

--force

Force commit to proceed, regardless of QA issues. For convenience, this option causes the most time consuming QA checks to be skipped. The commit message will include an indication that this option has been enabled, together with the usual portage version stamp.

When used together with manifest mode, --force causes existing digests to be replaced for any files that exist in ${DISTDIR}. Existing digests are assumed to be correct for files that would otherwise have to be downloaded in order to recompute digests. WARNING: When replacing existing digests, it is the user's responsibility to ensure that files contained in ${DISTDIR} have the correct identities. Especially beware of partially downloaded files.

-q, --quiet

Be less verbose about extraneous info

-p, --pretend

Don't commit or fix anything; just show what would be done

-x, --xmlparse

Forces the metadata.xml parse check to be carried out

-v, --verbose

Displays every package name while checking

-i, --ignore-arches

Ignore arch-specific failures (where arch != host)

-I, --ignore-masked

Ignore masked packages (not allowed with commit mode)

-d, --include-dev

Include dev profiles in dependency checks.

--without-mask

Behave as if no package.mask entries exist (not allowed with commit mode)

-m, --commitmsg

Adds a commit message via the command line

-M, --commitmsgfile

Adds a commit message from the specified file

-V, --version

Show version info

-h, --help

Show this screen

MODES

full

Scan directory tree for QA issues (full listing)

help

Show this screen

scan

Scan directory tree for QA issues (short listing)

fix

Fix simple QA issues (stray digests, missing digests)

manifest

Generate a Manifest (fetches distfiles if necessary). See the --force option if you would like to replace existing distfiles digests.

commit

Scan directory tree for QA issues; if OK, commit via cvs

QA KEYWORDS

CVS/Entries.IO_error

Attempting to commit, and an IO error was encountered access the Entries file

DEPEND.bad

User-visible ebuilds with bad DEPEND settings (matched against *visible* ebuilds)

DEPEND.badindev

User-visible ebuilds with bad DEPEND settings (matched against *visible* ebuilds) in developing arch

DEPEND.badmasked

Masked ebuilds with bad DEPEND settings (matched against *all* ebuilds)

DEPEND.badmaskedindev

Masked ebuilds with bad DEPEND settings (matched against *all* ebuilds) in developing arch

DEPEND.syntax

Syntax error in DEPEND (usually an extra/missing space/parenthesis)

DESCRIPTION.missing

Ebuilds that have a missing or empty DESCRIPTION variable

EAPI.incompatible

Ebuilds that use features that are only available with a different EAPI

EAPI.unsupported

Ebuilds that have an unsupported EAPI version (you must upgrade portage)

HOMEPAGE.missing

Ebuilds that have a missing or empty HOMEPAGE variable

IUSE.invalid

This build has a variable in IUSE that is not in the use.desc or use.local.desc file

IUSE.undefined

This ebuild does not define IUSE (style guideline says to define IUSE even when empty)

KEYWORDS.dropped

Ebuilds that appear to have dropped KEYWORDS for some arch

KEYWORDS.invalid

This ebuild contains KEYWORDS that are not listed in profiles/arch.list or for which no valid profile was found

KEYWORDS.missing

Ebuilds that have a missing or empty KEYWORDS variable

KEYWORDS.stable

Ebuilds that have been added directly with stable KEYWORDS

KEYWORDS.stupid

Ebuilds that use KEYWORDS=-* instead of package.mask

LICENSE.invalid

This ebuild is listing a license that doesnt exist in portages license/ dir.

LICENSE.missing

Ebuilds that have a missing or empty LICENSE variable

LICENSE.syntax

Syntax error in LICENSE (usually an extra/missing space/parenthesis)

LIVEVCS.stable

Ebuild is a live ebuild (cvs, git, darcs, svn, etc) checkout with stable keywords.

PDEPEND.bad

User-visible ebuilds with bad PDEPEND settings (matched against *visible* ebuilds)

PDEPEND.badindev

User-visible ebuilds with bad PDEPEND settings (matched against *visible* ebuilds) in developing arch

PDEPEND.badmasked

Masked ebuilds with PDEPEND settings (matched against *all* ebuilds)

PDEPEND.badmaskedindev

Masked ebuilds with PDEPEND settings (matched against *all* ebuilds) in developing arch

PDEPEND.syntax

Syntax error in PDEPEND (usually an extra/missing space/parenthesis)

PROVIDE.syntax

Syntax error in PROVIDE (usually an extra/missing space/parenthesis)

RDEPEND.bad

User-visible ebuilds with bad RDEPEND settings (matched against *visible* ebuilds)

RDEPEND.badindev

User-visible ebuilds with bad RDEPEND settings (matched against *visible* ebuilds) in developing arch

RDEPEND.badmasked

Masked ebuilds with RDEPEND settings (matched against *all* ebuilds)

RDEPEND.badmaskedindev

Masked ebuilds with RDEPEND settings (matched against *all* ebuilds) in developing arch

RDEPEND.implicit

RDEPEND is unset in the ebuild which triggers implicit RDEPEND=$DEPEND assignment

RDEPEND.suspect

RDEPEND contains a package that usually only belongs in DEPEND

RDEPEND.syntax

Syntax error in RDEPEND (usually an extra/missing space/parenthesis)

PROPERTIES.syntax

Syntax error in PROPERTIES (usually an extra/missing space/parenthesis)

RESTRICT.syntax

Syntax error in RESTRICT (usually an extra/missing space/parenthesis)

SLOT.missing

Ebuilds that have a missing or empty SLOT variable

SRC_URI.mirror

A uri listed in profiles/thirdpartymirrors is found in SRC_URI

changelog.ebuildadded

An ebuild was added but the ChangeLog was not modified

changelog.missing

Missing ChangeLog files

changelog.notadded

ChangeLogs that exist but have not been added to cvs

digest.assumed

Existing digest must be assumed correct (Package level only)

ebuild.allmasked

All ebuilds are masked for this package (Package level only)

ebuild.badheader

This ebuild has a malformed header

ebuild.invalidname

Ebuild files with a non-parseable or syntactically incorrect name (or using 2.1 versioning extensions)

ebuild.majorsyn

This ebuild has a major syntax error that may cause the ebuild to fail partially or fully

ebuild.minorsyn

This ebuild has a minor syntax error that contravenes gentoo coding style

ebuild.namenomatch

Ebuild files that do not have the same name as their parent directory

ebuild.nesteddie

Placing 'die' inside ( ) prints an error, but doesn't stop the ebuild.

ebuild.nostable

There are no ebuilds that are marked as stable for your ARCH

ebuild.notadded

Ebuilds that exist but have not been added to cvs

ebuild.output

A simple sourcing of the ebuild produces output; this breaks ebuild policy.

ebuild.patches

PATCHES variable should be a bash array to ensure white space safety

ebuild.syntax

Error generating cache entry for ebuild; typically caused by ebuild syntax error or digest verification failure.

file.UTF8

File is not UTF8 compliant

file.executable

Ebuilds, digests, metadata.xml, Manifest, and ChangeLog do not need the executable bit

file.name

File/dir name must be composed of only the following chars: a-zA-Z0-9._-+:

file.size

Files in the files directory must be under 20k

filedir.missing

Package lacks a files directory

inherit.autotools

Ebuild inherits autotools but does not call eautomake, eautoconf or eautoreconf

java.eclassesnotused

With virtual/jdk in DEPEND you must inherit a java eclass. Refer to http://www.gentoo.org/proj/en/java/java-devel.xml for more information.

metadata.bad

Bad metadata.xml files

metadata.missing

Missing metadata.xml files

metadata.warning

Warnings in metadata.xml files

upstream.workaround

The ebuild works around an upstream bug, an upstream bug should be filed and tracked in bugs.gentoo.org

usage.obsolete

The ebuild makes use of an obsolete construct

variable.invalidchar

A variable contains an invalid character that is not part of the ASCII character set.

variable.readonly

Assigning a readonly variable

virtual.exists

PROVIDE contains existing package names

virtual.unavailable

PROVIDE contains a virtual which contains no profile default

virtual.versioned

PROVIDE contains virtuals with versions

REPORTING BUGS

AUTHORS

Daniel Robbins <drobbins@gentoo.org>
Saleem Abdulrasool <compnerd@gentoo.org>

SEE ALSO

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

MODES

QA KEYWORDS

REPORTING BUGS

AUTHORS

SEE ALSO