summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlec Warner <antarus@gentoo.org>2007-07-22 19:22:16 +0000
committerAlec Warner <antarus@gentoo.org>2007-07-22 19:22:16 +0000
commit70e99e5c8093a171a4ac3797cdf570230ffba66e (patch)
tree35ce0b511dfa8632a20ffd447b78e1c7be2e66b7
parente933bb90b92205a522bdc89ab6bac285efc210d2 (diff)
downloadportage-70e99e5c8093a171a4ac3797cdf570230ffba66e.tar.gz
portage-70e99e5c8093a171a4ac3797cdf570230ffba66e.tar.bz2
portage-70e99e5c8093a171a4ac3797cdf570230ffba66e.zip
Add notes about import statements (clarity) and fix spelling error in release-notes
svn path=/main/trunk/; revision=7356
-rw-r--r--DEVELOPING37
-rw-r--r--RELEASE-NOTES2
2 files changed, 38 insertions, 1 deletions
diff --git a/DEVELOPING b/DEVELOPING
index 01eb9bd42..725f1ae1e 100644
--- a/DEVELOPING
+++ b/DEVELOPING
@@ -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
diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index f6989a14d..ff3370ef2 100644
--- a/RELEASE-NOTES
+++ b/RELEASE-NOTES
@@ -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.