summaryrefslogtreecommitdiff
path: root/blob.h
diff options
context:
space:
mode:
authorDaniel Barkalow <barkalow@iabervon.org>2010-01-18 13:06:28 -0500
committerJunio C Hamano <gitster@pobox.com>2010-01-18 17:04:02 -0800
commit837d395a5c0b98ab938d71db8e2b6b9f69ddcc4d (patch)
tree485fd6f9f5847d8d63d20e865e8d4ad287341001 /blob.h
parent64161a6b23920c96485131fb51d82d8ca13b4e1d (diff)
downloadgit-837d395a5c0b98ab938d71db8e2b6b9f69ddcc4d.tar.gz
Replace parse_blob() with an explanatory comment
parse_blob() has never actually been used; it has served simply to avoid having a confusing gap in the API. Instead of leaving it, put in a comment that explains what "parsing a blob" entails (making sure the object is actually readable), and why code might care whether a blob has been parsed or not. Signed-off-by: Daniel Barkalow <barkalow@iabervon.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'blob.h')
-rw-r--r--blob.h9
1 files changed, 8 insertions, 1 deletions
diff --git a/blob.h b/blob.h
index ea5d9e9f8b..59b394eea3 100644
--- a/blob.h
+++ b/blob.h
@@ -13,6 +13,13 @@ struct blob *lookup_blob(const unsigned char *sha1);
int parse_blob_buffer(struct blob *item, void *buffer, unsigned long size);
-int parse_blob(struct blob *item);
+/**
+ * Blobs do not contain references to other objects and do not have
+ * structured data that needs parsing. However, code may use the
+ * "parsed" bit in the struct object for a blob to determine whether
+ * its content has been found to actually be available, so
+ * parse_blob_buffer() is used (by object.c) to flag that the object
+ * has been read successfully from the database.
+ **/
#endif /* BLOB_H */