[prev in list] [next in list] [prev in thread] [next in thread] 

List:       git
Subject:    [PATCH v5 17/18] tree-walk.h API: document and format tree_entry_extract()
From:       Ævar Arnfjörð Bjarmason  <avarab () gmail ! com>
Date:       2021-03-31 19:09:45
Message-ID: patch-17.19-dc895822828-20210331T190531Z-avarab () gmail ! com
[Download RAW message or body]

Document and format the argument list of the tree_entry_extract()
function in preparation for eventually adding a sister function.

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
---
 tree-walk.h | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/tree-walk.h b/tree-walk.h
index c60667cba8f..52eb0d6b5b3 100644
--- a/tree-walk.h
+++ b/tree-walk.h
@@ -38,11 +38,17 @@ struct tree_desc {
 
 /**
  * Decode the entry currently being visited (the one pointed to by
- * `tree_desc's` `entry` member) and return the sha1 of the entry. The
- * `pathp` and `modep` arguments are set to the entry's pathname and mode
- * respectively.
+ * `tree_desc's` `entry` member) and return the OID of the entry.
+ *
+ * There are variants of this function depending on what fields in the
+ * "struct name_entry" you'd like. You always need a pointer to an
+ * appropriate variable to fill in (NULL won't do!):
+ *
+ * tree_entry_extract(): const char *path, unsigned int mode
  */
-static inline const struct object_id *tree_entry_extract(struct tree_desc *desc, \
const char **pathp, unsigned short *modep) +static inline const struct object_id \
*tree_entry_extract(struct tree_desc *desc, +							 const char **pathp,
+							 unsigned short *modep)
 {
 	*pathp = desc->entry.path;
 	*modep = desc->entry.mode;
-- 
2.31.1.474.g72d45d12706


[prev in list] [next in list] [prev in thread] [next in thread]