From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 61261138A1A for ; Thu, 13 Nov 2014 22:50:08 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EC298E0804; Thu, 13 Nov 2014 22:50:07 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 89FB6E0804 for ; Thu, 13 Nov 2014 22:50:07 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 42430340453 for ; Thu, 13 Nov 2014 22:50:06 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C5216A14B for ; Thu, 13 Nov 2014 22:50:04 +0000 (UTC) From: "Mike Frysinger" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Mike Frysinger" Message-ID: <1415918990.c2173483d8505ec8e89baef0266d308494fc2c36.vapier@gentoo> Subject: [gentoo-commits] proj/gentoolkit:gentoolkit commit in: man/ X-VCS-Repository: proj/gentoolkit X-VCS-Files: man/eclean.1 X-VCS-Directories: man/ X-VCS-Committer: vapier X-VCS-Committer-Name: Mike Frysinger X-VCS-Revision: c2173483d8505ec8e89baef0266d308494fc2c36 X-VCS-Branch: gentoolkit Date: Thu, 13 Nov 2014 22:50:04 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 32ae2c02-7c4d-4d0f-b57b-8e94f8ea66ba X-Archives-Hash: d2f11009f084eba8b8268281bb5fbc5f commit: c2173483d8505ec8e89baef0266d308494fc2c36 Author: Mike Frysinger gentoo org> AuthorDate: Thu Nov 13 22:49:50 2014 +0000 Commit: Mike Frysinger gentoo org> CommitDate: Thu Nov 13 22:49:50 2014 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/gentoolkit.git;a=commit;h=c2173483 eclean: fix typos in man page and line wrap long lines --- man/eclean.1 | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/man/eclean.1 b/man/eclean.1 index 4267047..1668b5e 100644 --- a/man/eclean.1 +++ b/man/eclean.1 @@ -21,7 +21,7 @@ whatever may still be useful, for instance to downgrade a package without downlo its sources for the second time, or to reinstall a package you unmerge by mistake without recompiling it. Sure, it's also a mode in which your DISTDIR and PKGDIR will stay rather big (although still not growing infinitely). For the 'distfiles', this -mode is also quite slow because it requiries some access to the whole Portage tree. +mode is also quite slow because it requires some access to the whole Portage tree. .PP If you use the \-\-deep option, eclean will only protect files corresponding to some currently installed package (taking their exact version into account). It will @@ -78,7 +78,7 @@ Units are: y (years), m (months), w (weeks), d (days) and h (hours). .TP \fB\-v, \-\-verbose\fP display more verbose messages during processing .TP -\fB\-V, \-\-version\fP display version informations +\fB\-V, \-\-version\fP display version information .SS "Actions" .TP \fBdistfiles\fR @@ -135,12 +135,12 @@ that do not have an ebuild in the tree or any currently installed overlays. .IP o eclean will also inform you of any unavailable installed packages that are on your system as well as if it was able to locate the source filename(s) in order to protect them. If you want to protect -all installed distfile sources, run elcelan in pretend mode first. Then check which sources it was +all installed distfile sources, run eclean in pretend mode first. Then check which sources it was not able to find the filename(s) for and add entries for them in the distfiles.exclude file before running eclean again. .LP By default, if it exists, /etc/eclean/packages.exclude (resp. distfiles.exclude) will be use -when action is "packages" (resp. "distfiles"). This can be overide with the \-\-exclude\-file +when action is "packages" (resp. "distfiles"). This can be override with the \-\-exclude\-file option. .SH "EXAMPLES" .LP @@ -162,15 +162,23 @@ are less than one month old, bigger than 50MB, or fetch\-restricted: .B # eclean\-dist \-d \-t1m \-s50M \-f .LP From a crontab, silently clean packages in the safest mode, and then distfiles in deep -mode but protecting files less than a week old, every sunday at 1am: +mode but protecting files less than a week old, every Sunday at 1am: .br .B 0 1 * * sun \ \ eclean \-C \-q packages ; eclean \-C \-q \-d \-t1w distfiles .SH "NOTE" .TP -While running and searching distfiles for cleaning, elcean will report any unavailable packages it finds installed on your system. An unavailable package is a package that is installed on the system, but there is not a corresponding ebuild available. Those sources may not be protected if the SRC_URI is not recorded in the installed package database. The SRC_URI is no longer recorded by recent portage/pkgcore versions. +While running and searching distfiles for cleaning, eclean will report any +unavailable packages it finds installed on your system. An unavailable package +is a package that is installed on the system, but there is not a corresponding +ebuild available. Those sources may not be protected if the SRC_URI is not +recorded in the installed package database. The SRC_URI is no longer recorded +by recent portage/pkgcore versions. .SH "BUGS" .".TP -."The policy used to decide if a distfile can be removed or not relies on the SRC_URI variables ."of ebuilds. It means that if an ebuild uses files that are not part of its SRC_URI, eclean will ."probably remove them. This are ebuilds bugs, please report them as such on ."http://bugs.gentoo.org. +."The policy used to decide if a distfile can be removed or not relies on the +SRC_URI variables ."of ebuilds. It means that if an ebuild uses files that are +not part of its SRC_URI, eclean will ."probably remove them. This are ebuilds +bugs, please report them as such on ."http://bugs.gentoo.org. .".TP ."In safest mode (default, without the \-\-deep option), this script can be very slow. There ."is not much to do about it without hacking outside of the portage API.