Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx> writes: > See v3[1] for lofty goals. The changes since v4 are mainly to rename > the "user formats" and "developer formats" to "user interfaces" and > "developer interfaces". > > Now: > > $ ./git help --user-interfaces Hopefully this is a much better choice of words. "formats" would have had a very high chance of getting misunderstood and confusing readers. The interaction with hooks (e.g. you stop the operation X that asks the hook's decision by writing hooks/pre-X that exits with non-zero status) would probably be much better understood if it is described as "interface" than "format". > And for "--developer-interfaces" (I wondered about calling this --apis): "api" might be less misunderstanding-prone, but both should probably be OK. Again, much better than calling it "format". Thanks.