From 1cb583bbb0aaf7bce3a252b093420477b32dd7cb Mon Sep 17 00:00:00 2001 From: Hans Ulrich Niedermann Date: Mon, 9 Aug 2010 15:07:19 +0200 Subject: Update doc strings for the sorting functions --- src/pyfedpkg/initial_merge.py | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/src/pyfedpkg/initial_merge.py b/src/pyfedpkg/initial_merge.py index 9ca0be8..8fdb179 100755 --- a/src/pyfedpkg/initial_merge.py +++ b/src/pyfedpkg/initial_merge.py @@ -45,9 +45,10 @@ log = logging.getLogger("fedpkg") def str_numsplit(s): - """Helper function for properly ordering branch names + """Helper function for properly ordering branch names. - Handles branch names like 'fc6', 'f8', 'f10', 'master'. + Converts branch names like 'fc6', 'f8', 'f10', 'master' into + ('fc',6), ('f',8), ('f',10), 'master', respectively. """ assert(not s[0].isdigit()) if not s[-1].isdigit(): @@ -62,7 +63,11 @@ def str_numsplit(s): def cmp_relbranch(a, b): - """Comparison function for sort() calls""" + """Comparison function release branch names (for sort() calls) + + Sorts branch names like 'el4', 'fc6', 'f8', 'f10', 'master' in + that order. + """ asplit = str_numsplit(a) bsplit = str_numsplit(b) if type(asplit) == str and type(bsplit) == str: -- cgit