On Mon, Jan 13, 2025, at 17:56, Junio C Hamano wrote: > kristofferhaugsbakk@xxxxxxxxxxxx writes: >> This command might only be considered plumbing by way of the plumbing >> contract that says that plumbing commands have stable output. But >> hopefully listing this command as Porcelain does not give the impression >> that the output is not stable. Output stability was in any case not the >> motivation for moving this command to plumbing. > > I do not follow the above reasoning at all. > > It is not like it is a crime to intarctively make use of a plumbing > command, or we intentionally try to hide plumbing command from them > by making it deliberately less accessible. "git cat-file commit X" > may be handier than "git show -s X" for some people and that is not > to be frowned upon. > > And what you call "might only be" is really the crucial thing to > consider. If we want to keep a tool's output stable and machine > readable, we need to mark it as "meant for Porcelain writers", and > classifying the tool as plumbing is a pretty much established way to > do so. Okay. I understand now. -- Kristoffer