diff options
author | Adam Spiers <git@adamspiers.org> | 2012-12-27 02:32:21 +0000 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2012-12-28 12:07:45 -0800 |
commit | 95a68344afcaf229765921c70458ee76add342dc (patch) | |
tree | 7d70e44472e4f344214b6819d209c724e778fa4c /Documentation | |
parent | f1a7082f2a05b6b187fad9c661e2c872f8b477f5 (diff) | |
download | git-95a68344afcaf229765921c70458ee76add342dc.tar.gz git-95a68344afcaf229765921c70458ee76add342dc.tar.xz |
Improve documentation and comments regarding directory traversal API
traversal API has a few potentially confusing properties. These
comments clarify a few key aspects and will hopefully make it easier
to understand for other newcomers in the future.
Signed-off-by: Adam Spiers <git@adamspiers.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/technical/api-directory-listing.txt | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/Documentation/technical/api-directory-listing.txt b/Documentation/technical/api-directory-listing.txt index 0356d2597..944fc39fa 100644 --- a/Documentation/technical/api-directory-listing.txt +++ b/Documentation/technical/api-directory-listing.txt @@ -9,8 +9,11 @@ Data structure -------------- `struct dir_struct` structure is used to pass directory traversal -options to the library and to record the paths discovered. The notable -options are: +options to the library and to record the paths discovered. A single +`struct dir_struct` is used regardless of whether or not the traversal +recursively descends into subdirectories. + +The notable options are: `exclude_per_dir`:: @@ -39,7 +42,7 @@ options are: If set, recurse into a directory that looks like a git directory. Otherwise it is shown as a directory. -The result of the enumeration is left in these fields:: +The result of the enumeration is left in these fields: `entries[]`:: |