Add notes about import statements (clarity) and fix spelling error in release-notes
authorAlec Warner <antarus@gentoo.org>
Sun, 22 Jul 2007 19:22:16 +0000 (19:22 -0000)
committerAlec Warner <antarus@gentoo.org>
Sun, 22 Jul 2007 19:22:16 +0000 (19:22 -0000)
svn path=/main/trunk/; revision=7356

DEVELOPING
RELEASE-NOTES

index 01eb9bd42695b28f375c29eeac47991dae2083c4..725f1ae1eabbe5d3e28f8f4268ce77bb1cbc9cd2 100644 (file)
@@ -65,3 +65,40 @@ except KeyError:
        dict[foo] = default_value
 
 The get call is nicer (compact) and faster (try,except are slow).
+
+Imports
+-------
+
+Import things one per line
+
+YES:
+  import os
+  import time
+  import sys
+
+NO:
+  import os,sys,time
+
+When importing from a module, you may import more than 1 thing at a time.
+
+YES:
+  from portage.module import foo, bar, baz
+
+Multiline imports are ok (for now :))
+
+Try to group system and package imports separately.
+
+YES:
+  import os
+  import sys
+  import time
+
+  from portage.locks import lockfile
+  from portage.versions import vercmp
+
+NO:
+  import os
+  import portage
+  import portage.util
+  import time
+  import sys
index f6989a14db878ab86c1c67290b6e1084f2974e63..ff3370ef2408414c6df208075aa0ca678ba37cd3 100644 (file)
@@ -16,7 +16,7 @@ portage-2.2
   used in ACCEPT_KEYWORDS.
   For packages that don't specify any other KEYWORDS you can use the new ** token
   as documented in portage(5) to disable KEYWORDS filtering completely.
-* Portage now warns if a ebild repository does not have a name, as several new
+* Portage now warns if an ebuild repository does not have a name, as several new
   features in 2.2 make use of or require named repositories. The repository name
   is stored in profiles/repo_name in each repository.