Consistently use the term 'depth' when referring to directory nesting depth

* include/mailutils/folder.h (mu_list_response): Rename 'level' to
'depth'.
All uses updated.

16 files changed, 50 insertions, 49 deletions

diff --git a/examples/lsf.c b/examples/lsf.c
index cba79d30c..c38689352 100644
--- a/examples/lsf.c
+++ b/examples/lsf.c
@@ -29,7 +29,7 @@ enumfun (mu_folder_t folder, struct mu_list_response *resp, void *data)
           (resp->type & MU_FOLDER_ATTRIBUTE_DIRECTORY) ? 'd' : '-',
           (resp->type & MU_FOLDER_ATTRIBUTE_FILE) ? 'f' : '-',
           resp->separator,
-          resp->level,
+          resp->depth,
           resp->name);
   return 0;
 }
diff --git a/include/mailutils/cpp/folder.h b/include/mailutils/cpp/folder.h
index fe4ed77c5..97c6d0fd4 100644
--- a/include/mailutils/cpp/folder.h
+++ b/include/mailutils/cpp/folder.h
@@ -43,9 +43,9 @@ class Folder
   void open (int flag);
   void close ();
 
-  List& list (const std::string& dirname, void* pattern, size_t max_level);
+  List& list (const std::string& dirname, void* pattern, size_t max_depth);
   List& enumerate (const std::string& name, void* pattern,
-                   int flags, size_t max_level,
+                   int flags, size_t max_depth,
                    mu_folder_enumerate_fp enumfun, void* enumdata);
 
   Url& get_url ();
diff --git a/include/mailutils/folder.h b/include/mailutils/folder.h
index 4ca4b92ee..ceb54dd62 100644
--- a/include/mailutils/folder.h
+++ b/include/mailutils/folder.h
@@ -27,9 +27,9 @@ extern "C" {
 struct mu_list_response
 {
   int type;             /* MU_FOLDER_ATTRIBUTE_.* flags */
-  int level;
-  int separator;
-  char *name;
+  int depth;            /* Item depth within the hierarchy */
+  int separator;        /* Directory separator character */
+  char *name;           /* Item name */
   mu_record_t format;   /* Associated mailbox format record */
 };
 
@@ -66,7 +66,8 @@ struct mu_folder_scanner
   char const *refname;     /* Reference name */
   void *pattern;           /* Matching pattern */
   int match_flags;         /* Matching flags */
-  size_t max_level;        /* Max. nesting level to descend */
+  size_t max_depth;        /* Max. depth to descend
+                              (1-based, 0 means 'unlimited') */
   mu_folder_enumerate_fp enumfun; /* Enumeration function */
   void *enumdata;                 /* Data for enumfun */
   mu_list_t records;        /* List of allowed records */
diff --git a/libmailutils/mailbox/folder.c b/libmailutils/mailbox/folder.c
index 8a474c8f6..d22bb3315 100644
--- a/libmailutils/mailbox/folder.c
+++ b/libmailutils/mailbox/folder.c
@@ -356,18 +356,18 @@ mu_folder_scan (mu_folder_t folder, struct mu_folder_scanner *scn)
 
 int
 mu_folder_list (mu_folder_t folder, const char *dirname, void *pattern,
-                size_t max_level,
+                size_t max_depth,
                 mu_list_t *pflist)
 {
   return mu_folder_enumerate (folder, dirname, pattern,
-                              MU_FOLDER_ATTRIBUTE_ALL, max_level,
+                              MU_FOLDER_ATTRIBUTE_ALL, max_depth,
                               pflist, NULL, NULL);
 }
 
 int
 mu_folder_enumerate (mu_folder_t folder, const char *name,
                      void *pattern, int flags,
-                     size_t max_level,
+                     size_t max_depth,
                      mu_list_t *pflist,
                      mu_folder_enumerate_fp enumfun, void *enumdata)
 {
@@ -383,7 +383,7 @@ mu_folder_enumerate (mu_folder_t folder, const char *name,
       scn.refname = name;
       scn.pattern = pattern;
       scn.match_flags = flags;
-      scn.max_level = max_level;
+      scn.max_depth = max_depth;
       scn.enumfun = enumfun;
       scn.enumdata = enumdata;
       scn.records = NULL;
diff --git a/libmailutils/mailbox/fsfolder.c b/libmailutils/mailbox/fsfolder.c
index 553c9fddf..4afdbd6e9 100644
--- a/libmailutils/mailbox/fsfolder.c
+++ b/libmailutils/mailbox/fsfolder.c
@@ -294,13 +294,13 @@ static int
 list_helper (struct mu_folder_scanner *scn,
              struct folder_scan_data *data,
              struct inode_list *ilist,
-             const char *dirname, size_t level)
+             const char *dirname, size_t depth)
 {
   DIR *dirp;
   struct dirent *dp;
   int stop = 0;
     
-  if (scn->max_level && level >= scn->max_level)
+  if (scn->max_depth && depth >= scn->max_depth)
     return 0;
 
   dirp = opendir (dirname);
@@ -377,7 +377,7 @@ list_helper (struct mu_folder_scanner *scn,
                   else
                     {
                       resp->name = fname;
-                      resp->level = level;
+                      resp->depth = depth;
                       resp->separator = '/';
                       resp->type = type;
                       resp->format = rec;
@@ -421,7 +421,7 @@ list_helper (struct mu_folder_scanner *scn,
                       idata.dev   = st.st_dev;
                       idata.next  = ilist;
                       stop = list_helper (scn, data, &idata, refname,
-                                          level + 1);
+                                          depth + 1);
                     }
                 }
               else if (S_ISDIR (st.st_mode))
@@ -431,7 +431,7 @@ list_helper (struct mu_folder_scanner *scn,
                   idata.inode = st.st_ino;
                   idata.dev   = st.st_dev;
                   idata.next  = ilist;
-                  stop = list_helper (scn, data, &idata, fname, level + 1);
+                  stop = list_helper (scn, data, &idata, fname, depth + 1);
                 }
             }
         }
@@ -508,7 +508,7 @@ _fsfolder_lsub (mu_folder_t folder, const char *ref, const char *name,
                   break;
                 }
               resp->type = MU_FOLDER_ATTRIBUTE_FILE;
-              resp->level = 0;
+              resp->depth = 0;
               resp->separator = '/';
               rc = mu_list_append (flist, resp);
               if (rc)
diff --git a/libmailutils/tests/fsfolder.c b/libmailutils/tests/fsfolder.c
index 5a4d9df7d..e6c45b7f0 100644
--- a/libmailutils/tests/fsfolder.c
+++ b/libmailutils/tests/fsfolder.c
@@ -44,9 +44,9 @@ compare_response (void const *a, void const *b)
   struct mu_list_response const *ra = a;
   struct mu_list_response const *rb = b;
 
-  if (ra->level < rb->level)
+  if (ra->depth < rb->depth)
     return -1;
-  if (ra->level > rb->level)
+  if (ra->depth > rb->depth)
     return 1;
   return strcmp (ra->name, rb->name);
 }
@@ -60,7 +60,7 @@ _print_list_entry (void *item, void *data)