Jeff King <peff@xxxxxxxx> writes: > It might just be me, but "object name" makes me think we'd take any name > (e.g., a refname that resolves to an object), whereas "object id" would > mean the object's hash specifically. And in this instance we only allow > the latter. Yeah, but glossary-content is very much explicit about this. "name" is the full hexadecimal hash, "identifier" is a synonym for it. And "id" does not even appear to be defined. We used to call "any name that refers to an object" an "extended SHA-1", but I haven't seen the phrase used for a long time on the list. > I agree very much with your other comments that if we are changing > these, we should get away from <sha> completely. Yup. I've always found it cumbersome that, when I want to mean a full hex representation, I have to say "40-byte object name". It is not even technically correct these days with SHA-256. We'd probably need to update the glossary to make sure we have ways to refer to "a way, any way, to name an object" and to "the hexadecimal representation of the full hash value that refers to an object". Here is my attempt to redefine "object ID" to be the narrower one, while losing "usually a 40-character hex" from "object name". I am not sure if I like the result as a whole, but it certainly is nice to have a word or phrase shorter than "full hex object name" to refer to it. Thanks. Documentation/glossary-content.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git c/Documentation/glossary-content.txt w/Documentation/glossary-content.txt index 090c888335..e2ab920911 100644 --- c/Documentation/glossary-content.txt +++ w/Documentation/glossary-content.txt @@ -262,13 +262,20 @@ This commit is referred to as a "merge commit", or sometimes just a identified by its <<def_object_name,object name>>. The objects usually live in `$GIT_DIR/objects/`. +[[def_object_id]]object ID:: + Synonym for <<def_object_identifier,object identifier>>. + [[def_object_identifier]]object identifier:: - Synonym for <<def_object_name,object name>>. + An <<def_object_name, object name>> written as an + unabbreviated hexadecimal representation of the hash value + that uniquely identifies an <<def_object,object>>. + Also colloquially called <<def_SHA1,SHA-1>>. [[def_object_name]]object name:: - The unique identifier of an <<def_object,object>>. The - object name is usually represented by a 40 character - hexadecimal string. Also colloquially called <<def_SHA1,SHA-1>>. + A name that identifies an <<def_object,object>> uniquely, + which can be given in various ways, including but not + limited to, the object's full <<def_object_identifier,object + identifier>>, a <<def_ref,ref>> that refers to the object. [[def_object_type]]object type:: One of the identifiers "<<def_commit_object,commit>>",
