Thomas Rast <trast@xxxxxxxxxxx> writes: > Junio C Hamano <gitster@xxxxxxxxx> writes: > >> Thomas Rast <trast@xxxxxxxxxxx> writes: >> >>> +<commit>, <object>:: >>> + The object that the new tag will refer to, usually a commit. >>> + Defaults to HEAD. >> >> Shouldn't this be more like this: >> >> <commit>:: >> <object>:: >> Your explanation here... > > Hmm, you're right, but we seem to be fairly inconsistent in that > department. There are some instances with the comma style: That is because we did not know better in the olden days, until somebody noticed and started using the separate-line form. We might have a patch or two to only convert from the comma-style but I do not recall us doing a whole-tree style clean-ups. > Should we fix that? I personally do not think the churn is warranted. "Fix the existing ones you notice as you touch the vicinity, and avoid introducing new ones" is good enough. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html