From 005f56110e90c4ff1fef5a8eccd99ecd85cf908b Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Mon, 9 Mar 2009 06:03:06 +0000 Subject: Make manifest mode with --force option cause existing digests to be replaced for any files that exist in ${DISTDIR}. This provides an alternative to ebuild --force manifest for updating existing distfiles digests. Digests are assumed to be corect for files that do not exist in ${DISTDIR} since the user could simply remove the whole Manifest if they wanted to regenerate digests for all files (and it's safer to regenerate as few as possible because it's less probably that a valid digest will get replaced by an invalid one). svn path=/main/trunk/; revision=12802 --- man/repoman.1 | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'man') diff --git a/man/repoman.1 b/man/repoman.1 index aca5587c0..b14cb17c2 100644 --- a/man/repoman.1 +++ b/man/repoman.1 @@ -18,6 +18,14 @@ 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 \fBmanifest\fR mode, \fB--force\fR 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. \fBWARNING:\fR 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. .TP \fB-q\fR, \fB--quiet\fR Be less verbose about extraneous info @@ -69,7 +77,8 @@ Scan directory tree for QA issues (short listing) Fix simple QA issues (stray digests, missing digests) .TP .B manifest -Generate a Manifest (fetches files if necessary) +Generate a Manifest (fetches distfiles if necessary). See the \fB\-\-force\fR +option if you would like to replace existing distfiles digests. .TP .B commit Scan directory tree for QA issues; if OK, commit via cvs -- cgit v1.2.3-1-g7c22