Re: Pseudoterminal terminology in POSIX

["Michael Kerrisk \(man-pages\) via Libc-alpha" <libc-alpha@sourceware.org>]

[Restoring the CC, which seems to have got lost along the way; it's best if
we keep it, since some people who are involved on the Linux/Glibc side may 
not be on the Austin list.]

Hello Geoff and Steffen,

Thanks for your feedback.

On 8/5/20 4:20 PM, Geoff Clare via austin-group-l at The Open Group wrote:
> Steffen Nurpmeso wrote, on 05 Aug 2020:
>>
>> Michael Kerrisk via austin-group-l at The Open Group wrote in
>>  <CALxWeYrisuzEPVEHOQSFJ8G_=8-VTAOTNBquyszOZMid7YfT=Q@mail.gmail.com>:
>>  |Elliot Hughes and I both noticed a point from "Minutes of the 3rd August \
>>  |2020
>>  |Teleconference":
>>  ..
>>  |On Tue, Aug 4, 2020 at 5:52 PM Andrew Josey <ajosey@opengroup.org> wrote:
>>  ...
>>  |> * General news
>>  |>
>>  |> We discussed terminology usage, in particuler terms such as
>>  |> master/slave, blacklist/whitelist.  It was agreed some terminology
>>  |> for pseudo-terminals could be better described using more functionally
>>  |> descriptive terms, but the details of this are left to a future bug
>>  |> report.  Andrew and Geoff took an action to investigate further
>>  |> and come back with an analysis.
>>  ...
>>  |The essence of the idea is simple. Let's not invent completely new
>>  |terms, but rather rework existing (familiar) terminology a little, as
>>  |follows:
>>  |
>>  |    pseudoterminal (device) ==> "pseudoterminal device pair"
> 
> I'm okay with that, but ...
> 
>>  |
>>  |   slave ==> "terminal device"
> 
> many other things are also terminal devices, so this doesn't work unless ...
> 
>>  |           (or "terminal end of the pseudoterminal device pair")
> 
> you use this cumbersome phrasing every time you refer to it.

(I don't really agree; context is everything; see below.)

>>  |
>>  |    master ==> "pseudoterminal device"
>>  |           (or "pseudoterminal end of the pseudoterminal device pair")
> 
> This makes no sense to me.  Given the phrase "pseudoterminal device pair",
> I would naturally expect "pseudoterminal device" could be used to refer
> to either of the individual devices in the pair, rather than one and not
> the other.

So, I think Elliot's mail provided a good response to this.
I am probably overcompensating with my language. In practice,
it may well be that people settle into the terminology

pseudoterminal device pair
pseudoterminal
terminal

And, in the context, and with familiarity, the last two terms
will be understood to mean the respective end points, so that we
would just talk about "the pseudoterminal and the terminal
that compose the device pair". And the fact that many things are
terminals doesn't really undermine this; the context would make it
clear, I think.

>> How about ancillary or accessory terminal device for the slave.
> 
> I think ancillary would actually be more applicable to the master.
> 
>>
>>  |The resulting language (as it appears in the proposed changes for the
>>  |Linux manual pages) is reasonably clear, albeit a little clunky in
>>  |places (wordings like "the (pseudo)terminal end of the pseudoterminal
>>  |device pair" are clear, but a little verbose).
>>
>> Yes.  It is terrible and absolutely unclear (to me).  And
>> presumely i would become dazed if i would read an entire manual
>> with the above terms.
> 
> I agree, it's too cumbersome.
> 
> My own thoughts up to now had been that, since the slave side is the
> side that is intended to be used as a terminal in the normal way, the
> slave should be called the "primary" device.  I hadn't come up with a
> word for the master side, but Steffen's suggestion of "ancillary" works
> quite well (I just saw a dictionary definition that said "providing
> necessary support to the primary ...").

Notwithstanding my arguments above, I'm not fixed in the terminology
that Elliot and I are suggesting, and I would not have a problem with
the terms "primary" and "ancillary" (and your [Geoff] suggested 
association of "ancillary" with the "master" seems more natural 
than associating it with the "slave").

The point is that if we come up with some terminology that is not
hideous, people will adapt. I remain somewhat agnostic about
what the terminology should be.

Cheers,

Michael