← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tree.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-07-02 19:51:05 UTC
  • mfrom: (3363.2.39 is_executable)
  • Revision ID: pqm@pqm.ubuntu.com-20080702195105-5gqthymygmtjrwaf
Make PreviewTree behavior more correct when changes are present

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tree.py
177
177
    def iter_entries_by_dir(self, specific_file_ids=None):
178
178
        """Walk the tree in 'by_dir' order.
179
179
 
180
 
        This will yield each entry in the tree as a (path, entry) tuple. The
181
 
        order that they are yielded is: the contents of a directory are 
182
 
        preceeded by the parent of a directory, and all the contents of a 
183
 
        directory are grouped together.
 
180
        This will yield each entry in the tree as a (path, entry) tuple.
 
181
        The order that they are yielded is:
 
182
 
 
183
        Directories are walked in a depth-first lexicographical order,
 
184
        however, whenever a directory is reached, all of its direct child
 
185
        nodes are yielded in  lexicographical order before yielding the
 
186
        grandchildren.
 
187
 
 
188
        For example, in the tree::
 
189
 
 
190
           a/
 
191
             b/
 
192
               c
 
193
             d/
 
194
               e
 
195
           f/
 
196
             g
 
197
 
 
198
        The yield order (ignoring root) would be::
 
199
          a, f, a/b, a/d, a/b/c, a/d/e, f/g
184
200
        """
185
201
        return self.inventory.iter_entries_by_dir(
186
202
            specific_file_ids=specific_file_ids)