From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1SCYhl-0005oU-48 for garchives@archives.gentoo.org; Tue, 27 Mar 2012 15:53:05 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 17428E04CB; Tue, 27 Mar 2012 15:52:53 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id B456AE04CB for ; Tue, 27 Mar 2012 15:52:52 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id E889A1B400B for ; Tue, 27 Mar 2012 15:52:51 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id ABBB9E5402 for ; Tue, 27 Mar 2012 15:52:50 +0000 (UTC) From: "Zac Medico" To: gentoo-commits@lists.gentoo.org Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Zac Medico" Message-ID: <1332863555.b2147b15e11b3d30d646098696ef69d749aeb5b2.zmedico@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: pym/repoman/, pym/portage/package/ebuild/_ipc/, pym/_emerge/resolver/, ... X-VCS-Repository: proj/portage X-VCS-Files: bin/repoman pym/_emerge/BlockerCache.py pym/_emerge/CompositeTask.py pym/_emerge/JobStatusDisplay.py pym/_emerge/Package.py pym/_emerge/PollScheduler.py pym/_emerge/QueueScheduler.py pym/_emerge/Scheduler.py pym/_emerge/_flush_elog_mod_echo.py pym/_emerge/depgraph.py pym/_emerge/resolver/output.py pym/portage/cache/mappings.py pym/portage/dbapi/bintree.py pym/portage/dbapi/porttree.py pym/portage/dbapi/vartree.py pym/portage/dep/__init__.py pym/portage/env/loaders.py pym/portage/glsa.py pym/portage/news.py pym/portage/package/ebuild/_ipc/QueryCommand.py pym/portage/package/ebuild/digestcheck.py pym/portage/package/ebuild/digestgen.py pym/portage/package/ebuild/doebuild.py pym/portage/process.py pym/portage/util/ExtractKernelVersion.py pym/portage/util/__init__.py pym/portage/util/_dyn_libs/PreservedLibsRegistry.py pym/portage/util/_eventloop/EventLoop.py pym/portage/util/_pty.py pym/portage/util/lafilefixer.py pym/portage/util/listdir.py pym/repoman/utilities.py X-VCS-Directories: pym/repoman/ pym/portage/package/ebuild/_ipc/ pym/_emerge/resolver/ pym/portage/package/ebuild/ pym/portage/util/_eventloop/ pym/portage/ pym/portage/env/ pym/portage/util/ pym/_emerge/ pym/portage/dbapi/ pym/portage/cache/ bin/ pym/portage/util/_dyn_libs/ pym/portage/dep/ X-VCS-Committer: zmedico X-VCS-Committer-Name: Zac Medico X-VCS-Revision: b2147b15e11b3d30d646098696ef69d749aeb5b2 X-VCS-Branch: master Date: Tue, 27 Mar 2012 15:52:50 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: 76aac2f6-df12-4b79-8f89-dc655503661e X-Archives-Hash: 2ee162253716e0d131e45992580ae05c commit: b2147b15e11b3d30d646098696ef69d749aeb5b2 Author: Zac Medico gentoo org> AuthorDate: Tue Mar 27 15:52:35 2012 +0000 Commit: Zac Medico gentoo org> CommitDate: Tue Mar 27 15:52:35 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=3Dproj/portage.git;a= =3Dcommit;h=3Db2147b15 Replace @returns with @return. --- bin/repoman | 2 +- pym/_emerge/BlockerCache.py | 2 +- pym/_emerge/CompositeTask.py | 2 +- pym/_emerge/JobStatusDisplay.py | 2 +- pym/_emerge/Package.py | 4 ++-- pym/_emerge/PollScheduler.py | 2 +- pym/_emerge/QueueScheduler.py | 2 +- pym/_emerge/Scheduler.py | 10 +++++----- pym/_emerge/_flush_elog_mod_echo.py | 2 +- pym/_emerge/depgraph.py | 6 +++--- pym/_emerge/resolver/output.py | 8 ++++---- pym/portage/cache/mappings.py | 2 +- pym/portage/dbapi/bintree.py | 6 +++--- pym/portage/dbapi/porttree.py | 6 +++--- pym/portage/dbapi/vartree.py | 10 +++++----- pym/portage/dep/__init__.py | 2 +- pym/portage/env/loaders.py | 4 ++-- pym/portage/glsa.py | 8 ++++---- pym/portage/news.py | 2 +- pym/portage/package/ebuild/_ipc/QueryCommand.py | 2 +- pym/portage/package/ebuild/digestcheck.py | 2 +- pym/portage/package/ebuild/digestgen.py | 2 +- pym/portage/package/ebuild/doebuild.py | 4 ++-- pym/portage/process.py | 4 ++-- pym/portage/util/ExtractKernelVersion.py | 2 +- pym/portage/util/__init__.py | 2 +- .../util/_dyn_libs/PreservedLibsRegistry.py | 2 +- pym/portage/util/_eventloop/EventLoop.py | 2 +- pym/portage/util/_pty.py | 2 +- pym/portage/util/lafilefixer.py | 2 +- pym/portage/util/listdir.py | 2 +- pym/repoman/utilities.py | 6 +++--- 32 files changed, 58 insertions(+), 58 deletions(-) diff --git a/bin/repoman b/bin/repoman index 8e19a47..54d864f 100755 --- a/bin/repoman +++ b/bin/repoman @@ -1026,7 +1026,7 @@ def fetch_metadata_dtd(): Fetch metadata.dtd if it doesn't exist or the ctime is older than metadata_dtd_ctime_interval. @rtype: bool - @returns: True if successful, otherwise False + @return: True if successful, otherwise False """ =20 must_fetch =3D True diff --git a/pym/_emerge/BlockerCache.py b/pym/_emerge/BlockerCache.py index 57e9d2c..06598a4 100644 --- a/pym/_emerge/BlockerCache.py +++ b/pym/_emerge/BlockerCache.py @@ -180,7 +180,7 @@ class BlockerCache(portage.cache.mappings.MutableMapp= ing): def __getitem__(self, cpv): """ @rtype: BlockerData - @returns: An object with counter and atoms attributes. + @return: An object with counter and atoms attributes. """ return self.BlockerData(*self._cache_data["blockers"][cpv]) =20 diff --git a/pym/_emerge/CompositeTask.py b/pym/_emerge/CompositeTask.py index e56188d..3e43478 100644 --- a/pym/_emerge/CompositeTask.py +++ b/pym/_emerge/CompositeTask.py @@ -104,7 +104,7 @@ class CompositeTask(AsynchronousTask): Subclasses can use this as a generic task exit callback. =20 @rtype: int - @returns: The task.returncode attribute. + @return: The task.returncode attribute. """ self._assert_current(task) if task.returncode !=3D os.EX_OK: diff --git a/pym/_emerge/JobStatusDisplay.py b/pym/_emerge/JobStatusDispl= ay.py index d84d1b0..5b9b221 100644 --- a/pym/_emerge/JobStatusDisplay.py +++ b/pym/_emerge/JobStatusDisplay.py @@ -97,7 +97,7 @@ class JobStatusDisplay(object): """ Initialize term control codes. @rtype: bool - @returns: True if term codes were successfully initialized, + @return: True if term codes were successfully initialized, False otherwise. """ =20 diff --git a/pym/_emerge/Package.py b/pym/_emerge/Package.py index f87d593..e4d416c 100644 --- a/pym/_emerge/Package.py +++ b/pym/_emerge/Package.py @@ -491,7 +491,7 @@ class Package(Task): =20 def is_valid_flag(self, flags): """ - @returns: True if all flags are valid USE values which may + @return: True if all flags are valid USE values which may be specified in USE dependencies, False otherwise. """ if isinstance(flags, basestring): @@ -505,7 +505,7 @@ class Package(Task): =20 def get_missing_iuse(self, flags): """ - @returns: A list of flags missing from IUSE. + @return: A list of flags missing from IUSE. """ if isinstance(flags, basestring): flags =3D [flags] diff --git a/pym/_emerge/PollScheduler.py b/pym/_emerge/PollScheduler.py index 8f01838..1c631c3 100644 --- a/pym/_emerge/PollScheduler.py +++ b/pym/_emerge/PollScheduler.py @@ -97,7 +97,7 @@ class PollScheduler(object): def _keep_scheduling(self): """ @rtype: bool - @returns: True if there may be remaining tasks to schedule, + @return: True if there may be remaining tasks to schedule, False otherwise. """ return False diff --git a/pym/_emerge/QueueScheduler.py b/pym/_emerge/QueueScheduler.p= y index 730bd78..9d73b78 100644 --- a/pym/_emerge/QueueScheduler.py +++ b/pym/_emerge/QueueScheduler.py @@ -67,7 +67,7 @@ class QueueScheduler(PollScheduler): def _schedule_tasks(self): """ @rtype: bool - @returns: True if there may be remaining tasks to schedule, + @return: True if there may be remaining tasks to schedule, False otherwise. """ if self._terminated_tasks: diff --git a/pym/_emerge/Scheduler.py b/pym/_emerge/Scheduler.py index bde6cf3..8d6ab9f 100644 --- a/pym/_emerge/Scheduler.py +++ b/pym/_emerge/Scheduler.py @@ -357,7 +357,7 @@ class Scheduler(PollScheduler): Check if background mode is enabled and adjust states as necessary. =20 @rtype: bool - @returns: True if background mode is enabled, False otherwise. + @return: True if background mode is enabled, False otherwise. """ background =3D (self._max_jobs is True or \ self._max_jobs > 1 or "--quiet" in self.myopts \ @@ -1435,7 +1435,7 @@ class Scheduler(PollScheduler): merge order @type later: set @rtype: bool - @returns: True if the package is dependent, False otherwise. + @return: True if the package is dependent, False otherwise. """ =20 graph =3D self._digraph @@ -1535,7 +1535,7 @@ class Scheduler(PollScheduler): def _job_delay(self): """ @rtype: bool - @returns: True if job scheduling should be delayed, False otherwise. + @return: True if job scheduling should be delayed, False otherwise. """ =20 if self._jobs and self._max_load is not None: @@ -1553,7 +1553,7 @@ class Scheduler(PollScheduler): def _schedule_tasks_imp(self): """ @rtype: bool - @returns: True if state changed, False otherwise. + @return: True if state changed, False otherwise. """ =20 state_change =3D 0 @@ -1710,7 +1710,7 @@ class Scheduler(PollScheduler): Use the current resume list to calculate a new one, dropping any packages with unsatisfied deps. @rtype: bool - @returns: True if successful, False otherwise. + @return: True if successful, False otherwise. """ print(colorize("GOOD", "*** Resuming merge...")) =20 diff --git a/pym/_emerge/_flush_elog_mod_echo.py b/pym/_emerge/_flush_elo= g_mod_echo.py index eab4168..9ac65b8 100644 --- a/pym/_emerge/_flush_elog_mod_echo.py +++ b/pym/_emerge/_flush_elog_mod_echo.py @@ -8,7 +8,7 @@ def _flush_elog_mod_echo(): Dump the mod_echo output now so that our other notifications are shown last. @rtype: bool - @returns: True if messages were shown, False otherwise. + @return: True if messages were shown, False otherwise. """ messages_shown =3D bool(mod_echo._items) mod_echo.finalize() diff --git a/pym/_emerge/depgraph.py b/pym/_emerge/depgraph.py index e4310b4..072a5ea 100644 --- a/pym/_emerge/depgraph.py +++ b/pym/_emerge/depgraph.py @@ -886,7 +886,7 @@ class depgraph(object): relationships from nested sets @type add_to_digraph: Boolean @rtype: Iterable - @returns: All args given in the input together with additional + @return: All args given in the input together with additional SetArg instances that are generated from nested sets """ =20 @@ -1901,7 +1901,7 @@ class depgraph(object): @param atom_without_category: an atom without a category component @type atom_without_category: String @rtype: list - @returns: a list of atoms containing categories (possibly empty) + @return: a list of atoms containing categories (possibly empty) """ null_cp =3D portage.dep_getkey(insert_category_into_atom( atom_without_category, "null")) @@ -7029,7 +7029,7 @@ def _resume_depgraph(settings, trees, mtimedb, myop= ts, myparams, spinner): PackageNotFound or depgraph.UnsatisfiedResumeDep when necessary. TODO: Return reasons for dropped_tasks, for display/logging. @rtype: tuple - @returns: (success, depgraph, dropped_tasks) + @return: (success, depgraph, dropped_tasks) """ skip_masked =3D True skip_unsatisfied =3D True diff --git a/pym/_emerge/resolver/output.py b/pym/_emerge/resolver/output= .py index a97658a..1208bf9 100644 --- a/pym/_emerge/resolver/output.py +++ b/pym/_emerge/resolver/output.py @@ -514,8 +514,8 @@ class Display(object): def _insert_slot(self, pkg, pkg_info, myinslotlist): """Adds slot info to the message =20 - @returns addl: formatted slot info - @returns myoldbest: installed version list + @return addl: formatted slot info + @return myoldbest: installed version list Modifies self.counters.downgrades, self.counters.upgrades, self.counters.binary """ @@ -541,8 +541,8 @@ class Display(object): def _new_slot(self, pkg, pkg_info): """New slot, mark it new. =20 - @returns addl: formatted slot info - @returns myoldbest: installed version list + @return addl: formatted slot info + @return myoldbest: installed version list Modifies self.counters.newslot, self.counters.binary """ addl =3D " " + green("NS") + pkg_info.fetch_symbol + " " diff --git a/pym/portage/cache/mappings.py b/pym/portage/cache/mappings.p= y index 60a918e..bc8ce9a 100644 --- a/pym/portage/cache/mappings.py +++ b/pym/portage/cache/mappings.py @@ -316,7 +316,7 @@ def slot_dict_class(keys, prefix=3D"_val_"): attribute names from keys @type prefix: String @rtype: SlotDict - @returns: A class that constructs SlotDict instances + @return: A class that constructs SlotDict instances having the specified keys. """ if isinstance(keys, frozenset): diff --git a/pym/portage/dbapi/bintree.py b/pym/portage/dbapi/bintree.py index 31ba364..2295b9f 100644 --- a/pym/portage/dbapi/bintree.py +++ b/pym/portage/dbapi/bintree.py @@ -214,7 +214,7 @@ def _pkgindex_cpv_map_latest_build(pkgindex): @param pkgindex: A PackageIndex instance. @type pkgindex: PackageIndex @rtype: dict - @returns: a dict containing entry for the give cpv. + @return: a dict containing entry for the give cpv. """ cpv_map =3D {} =20 @@ -1157,7 +1157,7 @@ class binarytree(object): Performs checksums and evaluates USE flag conditionals. Raises InvalidDependString if necessary. @rtype: dict - @returns: a dict containing entry for the give cpv. + @return: a dict containing entry for the give cpv. """ =20 pkg_path =3D self.getname(cpv) @@ -1363,7 +1363,7 @@ class binarytree(object): Verify digests for the given package and raise DigestException if verification fails. @rtype: bool - @returns: True if digests could be located, False otherwise. + @return: True if digests could be located, False otherwise. """ cpv =3D pkg if not isinstance(cpv, basestring): diff --git a/pym/portage/dbapi/porttree.py b/pym/portage/dbapi/porttree.p= y index 233a2c1..382bcda 100644 --- a/pym/portage/dbapi/porttree.py +++ b/pym/portage/dbapi/porttree.py @@ -254,7 +254,7 @@ class portdbapi(dbapi): @param canonical_repo_path: the canonical path of a repository, as resolved by os.path.realpath() @type canonical_repo_path: String - @returns: The repo_name for the corresponding repository, or None + @return: The repo_name for the corresponding repository, or None if the path does not correspond a known repository @rtype: String or None """ @@ -331,7 +331,7 @@ class portdbapi(dbapi): Create an EbuildMetadataPhase instance to generate metadata for the give ebuild. @rtype: EbuildMetadataPhase - @returns: A new EbuildMetadataPhase instance, or None if the + @return: A new EbuildMetadataPhase instance, or None if the metadata cache is already valid. """ metadata, ebuild_hash =3D self._pull_valid_cache(cpv, ebuild_path, rep= o_path) @@ -551,7 +551,7 @@ class portdbapi(dbapi): @param mytree: The canonical path of the tree in which the ebuild is located, or None for automatic lookup @type mypkg: String - @returns: A dict which maps each file name to a set of alternative + @return: A dict which maps each file name to a set of alternative URIs. @rtype: dict """ diff --git a/pym/portage/dbapi/vartree.py b/pym/portage/dbapi/vartree.py index 3e603e2..25ea4c1 100644 --- a/pym/portage/dbapi/vartree.py +++ b/pym/portage/dbapi/vartree.py @@ -921,7 +921,7 @@ class vardbapi(dbapi): @param myroot: ignored, self._eroot is used instead @param mycpv: ignored @rtype: int - @returns: new counter value + @return: new counter value """ myroot =3D None mycpv =3D None @@ -1732,7 +1732,7 @@ class dblink(object): PreservedLibsRegistry yet. @type preserve_paths: set @rtype: Integer - @returns: + @return: 1. os.EX_OK if everything went well. 2. return code of the failed phase (for prerm, postrm, cleanrm) """ @@ -2546,7 +2546,7 @@ class dblink(object): @param destroot: @type destroot: @rtype: Boolean - @returns: + @return: 1. True if this package owns the file. 2. False if this package does not own the file. """ @@ -3376,7 +3376,7 @@ class dblink(object): @param prev_mtimes: { Filename:mtime } mapping for env_update @type prev_mtimes: Dictionary @rtype: Boolean - @returns: + @return: 1. 0 on success 2. 1 on failure =09 @@ -4193,7 +4193,7 @@ class dblink(object): @param thismtime: The current time (typically long(time.time()) @type thismtime: Long @rtype: None or Boolean - @returns: + @return: 1. True on failure 2. None otherwise =09 diff --git a/pym/portage/dep/__init__.py b/pym/portage/dep/__init__.py index 389916f..3832b0b 100644 --- a/pym/portage/dep/__init__.py +++ b/pym/portage/dep/__init__.py @@ -62,7 +62,7 @@ def cpvequal(cpv1, cpv2): @param cpv2: CategoryPackageVersion (no operators) Example: "sys-apps/p= ortage-2.1" @type cpv2: String @rtype: Boolean - @returns: + @return: 1. True if cpv1 =3D cpv2 2. False Otherwise 3. Throws PortageException if cpv1 or cpv2 is not a CPV diff --git a/pym/portage/env/loaders.py b/pym/portage/env/loaders.py index b540fbb..372bc12 100644 --- a/pym/portage/env/loaders.py +++ b/pym/portage/env/loaders.py @@ -40,7 +40,7 @@ def RecursiveFileLoader(filename): =20 @param filename: name of a file/directory to traverse @rtype: list - @returns: List of files to process + @return: List of files to process """ =20 try: @@ -139,7 +139,7 @@ class FileLoader(DataLoader): load all files in self.fname @type: Boolean @rtype: tuple - @returns: + @return: Returns (data,errors), both may be empty dicts or populated. """ data =3D {} diff --git a/pym/portage/glsa.py b/pym/portage/glsa.py index a784d14..2df7ec3 100644 --- a/pym/portage/glsa.py +++ b/pym/portage/glsa.py @@ -488,7 +488,7 @@ class Glsa: @type myfile: String @param myfile: Filename to grab the XML data from @rtype: None - @returns: None + @return: None """ self.DOM =3D xml.dom.minidom.parse(myfile) if not self.DOM.doctype: @@ -634,7 +634,7 @@ class Glsa: architectures. =09 @rtype: Boolean - @returns: True if the system is affected, False if not + @return: True if the system is affected, False if not """ rValue =3D False for k in self.packages: @@ -654,7 +654,7 @@ class Glsa: GLSA was already applied. =09 @rtype: Boolean - @returns: True if the GLSA was applied, False if not + @return: True if the GLSA was applied, False if not """ return (self.nr in get_applied_glsas(self.config)) =20 @@ -665,7 +665,7 @@ class Glsa: applied or on explicit user request. =20 @rtype: None - @returns: None + @return: None """ if not self.isApplied(): checkfile =3D io.open( diff --git a/pym/portage/news.py b/pym/portage/news.py index f34fd6f..bbd9325 100644 --- a/pym/portage/news.py +++ b/pym/portage/news.py @@ -370,7 +370,7 @@ def count_unread_news(portdb, vardb, repos=3DNone, up= date=3DTrue): @param update: check for new items (default is True) @type update: boolean @rtype: dict - @returns: dictionary mapping repos to integer counts of unread news ite= ms + @return: dictionary mapping repos to integer counts of unread news item= s """ =20 NEWS_PATH =3D os.path.join("metadata", "news") diff --git a/pym/portage/package/ebuild/_ipc/QueryCommand.py b/pym/portag= e/package/ebuild/_ipc/QueryCommand.py index 949a148..7bbb0e8 100644 --- a/pym/portage/package/ebuild/_ipc/QueryCommand.py +++ b/pym/portage/package/ebuild/_ipc/QueryCommand.py @@ -27,7 +27,7 @@ class QueryCommand(IpcCommand): =20 def __call__(self, argv): """ - @returns: tuple of (stdout, stderr, returncode) + @return: tuple of (stdout, stderr, returncode) """ =20 cmd, root, atom_str =3D argv diff --git a/pym/portage/package/ebuild/digestcheck.py b/pym/portage/pack= age/ebuild/digestcheck.py index c8d168e..8705639 100644 --- a/pym/portage/package/ebuild/digestcheck.py +++ b/pym/portage/package/ebuild/digestcheck.py @@ -15,7 +15,7 @@ def digestcheck(myfiles, mysettings, strict=3DFalse, ju= stmanifest=3DNone, mf=3DNone): """ Verifies checksums. Assumes all files have been downloaded. @rtype: int - @returns: 1 on success and 0 on failure + @return: 1 on success and 0 on failure """ =20 if justmanifest is not None: diff --git a/pym/portage/package/ebuild/digestgen.py b/pym/portage/packag= e/ebuild/digestgen.py index 38e9991..6ad3397 100644 --- a/pym/portage/package/ebuild/digestgen.py +++ b/pym/portage/package/ebuild/digestgen.py @@ -33,7 +33,7 @@ def digestgen(myarchives=3DNone, mysettings=3DNone, myp= ortdb=3DNone): @param myportdb: a portdbapi instance @type myportdb: portdbapi @rtype: int - @returns: 1 on success and 0 on failure + @return: 1 on success and 0 on failure """ if mysettings is None or myportdb is None: raise TypeError("portage.digestgen(): 'mysettings' and 'myportdb' para= meter are required.") diff --git a/pym/portage/package/ebuild/doebuild.py b/pym/portage/package= /ebuild/doebuild.py index ffad456..49672e1 100644 --- a/pym/portage/package/ebuild/doebuild.py +++ b/pym/portage/package/ebuild/doebuild.py @@ -480,7 +480,7 @@ def doebuild(myebuild, mydo, _unused=3DNone, settings= =3DNone, debug=3D0, listonly=3D0, caller clean up all returned PIDs. @type returnpid: Boolean @rtype: Boolean - @returns: + @return: 1. 0 for success 2. 1 for error =09 @@ -1368,7 +1368,7 @@ def spawn(mystring, mysettings, debug=3D0, free=3D0= , droppriv=3D0, sesandbox=3D0, fakero @param keywords: Extra options encoded as a dict, to be passed to spawn @type keywords: Dictionary @rtype: Integer - @returns: + @return: 1. The return code of the spawned process. """ =20 diff --git a/pym/portage/process.py b/pym/portage/process.py index febaf66..94687ea 100644 --- a/pym/portage/process.py +++ b/pym/portage/process.py @@ -354,7 +354,7 @@ def _exec(binary, mycommand, opt_name, fd_pipes, env,= gid, groups, uid, umask, @param pre_exec: A function to be called with no arguments just prior t= o the exec call. @type pre_exec: callable @rtype: None - @returns: Never returns (calls os.execve) + @return: Never returns (calls os.execve) """ =09 # If the process we're creating hasn't been given a name @@ -429,7 +429,7 @@ def find_binary(binary): @param binary: Name of the binary to find @type string @rtype: None or string - @returns: full path to binary or None if the binary could not be locate= d. + @return: full path to binary or None if the binary could not be located= . """ for path in os.environ.get("PATH", "").split(":"): filename =3D "%s/%s" % (path, binary) diff --git a/pym/portage/util/ExtractKernelVersion.py b/pym/portage/util/= ExtractKernelVersion.py index 49957f5..69bd58a 100644 --- a/pym/portage/util/ExtractKernelVersion.py +++ b/pym/portage/util/ExtractKernelVersion.py @@ -14,7 +14,7 @@ def ExtractKernelVersion(base_dir): @param base_dir: Path to sources (usually /usr/src/linux) @type base_dir: string @rtype: tuple( version[string], error[string]) - @returns: + @return: 1. tuple( version[string], error[string]) Either version or error is populated (but never both) =20 diff --git a/pym/portage/util/__init__.py b/pym/portage/util/__init__.py index 02fb75d..dd692a1 100644 --- a/pym/portage/util/__init__.py +++ b/pym/portage/util/__init__.py @@ -346,7 +346,7 @@ def grabdict(myfilename, juststrings=3D0, empty=3D0, = recursive=3D0, incremental=3D1): @param incremental: Append to the return list, don't overwrite @type incremental: Boolean (integer) @rtype: Dictionary - @returns: + @return: 1. Returns the lines in a file in a dictionary, for example: 'sys-apps/portage x86 amd64 ppc' would return diff --git a/pym/portage/util/_dyn_libs/PreservedLibsRegistry.py b/pym/po= rtage/util/_dyn_libs/PreservedLibsRegistry.py index 26da0cf..4bc64db 100644 --- a/pym/portage/util/_dyn_libs/PreservedLibsRegistry.py +++ b/pym/portage/util/_dyn_libs/PreservedLibsRegistry.py @@ -242,7 +242,7 @@ class PreservedLibsRegistry(object): =09 def getPreservedLibs(self): """ Return a mapping of packages->preserved objects. - @returns mapping of package instances to preserved objects + @return mapping of package instances to preserved objects @rtype Dict cpv->list-of-paths """ if self._data is None: diff --git a/pym/portage/util/_eventloop/EventLoop.py b/pym/portage/util/= _eventloop/EventLoop.py index a2d4cd4..ef20ce4 100644 --- a/pym/portage/util/_eventloop/EventLoop.py +++ b/pym/portage/util/_eventloop/EventLoop.py @@ -435,7 +435,7 @@ def can_poll_device(): Test if it's possible to use poll() on a device such as a pty. This is known to fail on Darwin. @rtype: bool - @returns: True if poll() on a device succeeds, False otherwise. + @return: True if poll() on a device succeeds, False otherwise. """ =20 global _can_poll_device diff --git a/pym/portage/util/_pty.py b/pym/portage/util/_pty.py index 95082cf..11c8b92 100644 --- a/pym/portage/util/_pty.py +++ b/pym/portage/util/_pty.py @@ -27,7 +27,7 @@ def _create_pty_or_pipe(copy_term_size=3DNone): then the term size will be copied to the pty. @type copy_term_size: int @rtype: tuple - @returns: A tuple of (is_pty, master_fd, slave_fd) where + @return: A tuple of (is_pty, master_fd, slave_fd) where is_pty is True if a pty was successfully allocated, and False if a normal pipe was allocated. """ diff --git a/pym/portage/util/lafilefixer.py b/pym/portage/util/lafilefix= er.py index 2b093d8..54ff20d 100644 --- a/pym/portage/util/lafilefixer.py +++ b/pym/portage/util/lafilefixer.py @@ -80,7 +80,7 @@ def rewrite_lafile(contents): @param contents: the contents of a libtool archive file @type contents: bytes @rtype: tuple - @returns: (True, fixed_contents) if something needed to be + @return: (True, fixed_contents) if something needed to be fixed, (False, None) otherwise. """ #Parse the 'dependency_libs' and 'inherited_linker_flags' lines. diff --git a/pym/portage/util/listdir.py b/pym/portage/util/listdir.py index 5753d2f..c2628cb 100644 --- a/pym/portage/util/listdir.py +++ b/pym/portage/util/listdir.py @@ -109,7 +109,7 @@ def listdir(mypath, recursive=3DFalse, filesonly=3DFa= lse, ignorecvs=3DFalse, ignorelis @param dirsonly: Only return directories. @type dirsonly: Boolean @rtype: List - @returns: A list of files and directories (or just files or just direct= ories) or an empty list. + @return: A list of files and directories (or just files or just directo= ries) or an empty list. """ =20 list, ftype =3D cacheddir(mypath, ignorecvs, ignorelist, EmptyOnError, = followSymlinks) diff --git a/pym/repoman/utilities.py b/pym/repoman/utilities.py index 34d6494..bee67aa 100644 --- a/pym/repoman/utilities.py +++ b/pym/repoman/utilities.py @@ -327,7 +327,7 @@ def editor_is_executable(editor): @param editor: An EDITOR value from the environment. @type: string @rtype: bool - @returns: True if an executable is found, False otherwise. + @return: True if an executable is found, False otherwise. """ editor_split =3D util.shlex_split(editor) if not editor_split: @@ -348,7 +348,7 @@ def get_commit_message_with_editor(editor, message=3D= None): @param message: An iterable of lines to show in the editor. @type: iterable @rtype: string or None - @returns: A string on success or None if an error occurs. + @return: A string on success or None if an error occurs. """ fd, filename =3D mkstemp() try: @@ -389,7 +389,7 @@ def get_commit_message_with_stdin(): Read a commit message from the user and return it. =20 @rtype: string or None - @returns: A string on success or None if an error occurs. + @return: A string on success or None if an error occurs. """ print("Please enter a commit message. Use Ctrl-d to finish or Ctrl-c to= abort.") commitmessage =3D []