[Pkg-bazaar-commits] ./bzr/unstable r430: doc

[Martin Pool]

------------------------------------------------------------
revno: 430
committer: Martin Pool <mbp at sourcefrog.net>
timestamp: Tue 2005-05-10 16:09:58 +1000
message:
  doc
modified:
  bzrlib/branch.py
-------------- next part --------------
=== modified file 'bzrlib/branch.py'
--- a/bzrlib/branch.py	2005-05-10 04:02:02 +0000
+++ b/bzrlib/branch.py	2005-05-10 06:09:58 +0000
@@ -213,6 +213,9 @@
         and binary.  binary files are untranslated byte streams.  Text
         control files are stored with Unix newlines and in UTF-8, even
         if the platform or locale defaults are different.
+
+        Controlfiles should almost never be opened in write mode but
+        rather should be atomically copied and replaced using atomicfile.
         """
 
         fn = self.controlfilename(file_or_path)