From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-Status: No, score=-4.9 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI,NICE_REPLY_A, SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 890861F5AE for ; Fri, 31 Jul 2020 07:48:43 +0000 (UTC) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 57EDA3857C4C; Fri, 31 Jul 2020 07:48:42 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 57EDA3857C4C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1596181722; bh=ftTOVOCixhKxxVlnoh0i484JW3e9En7DFxByS6V+7po=; h=Subject:To:References:Date:In-Reply-To:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=dW1n4B4BC78zxAWXvX1G3+l2flzH3ged829o87yYms55tyJT/LIn59SLLdUvVYpvH mX5Dj7bYCm38JvKSVNDfrfoCoAVuyWU5ZVhaIDDX6VJjUahzOsfBG5pByPDDmEiLxE zZUHKMYN91W3wRo+8jenpRMNhyi3KJwJhYWtxt+o= Received: from mail-ed1-x542.google.com (mail-ed1-x542.google.com [IPv6:2a00:1450:4864:20::542]) by sourceware.org (Postfix) with ESMTPS id 882E03858D35 for ; Fri, 31 Jul 2020 07:48:39 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 882E03858D35 Received: by mail-ed1-x542.google.com with SMTP id v22so10958665edy.0 for ; Fri, 31 Jul 2020 00:48:39 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:cc:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=ftTOVOCixhKxxVlnoh0i484JW3e9En7DFxByS6V+7po=; b=KXJycd9I7Vq3EJj4VIoomssOsXIwTpf1BwYCGgPMiklk+fesDCk5vbHQUYVJtJC1X9 u/DMVvb+228GjdTLGMOGfppEv6sxJhe8pgowa6ATsQftopVW2IACFtiTtU+XU6GH9v3H iUkd9+7PgRa9oX7mc8U3PdmW5sMAzGEU1FfFrk1ByH4E7cOCfy8yIiI1/wC21/NMks6S OY1c9J4EkinuR42U2kBcN7zs/sOLzB0tWMR/o0JJKEY/sjciQezd8kHlnXumGPJ8fhZ3 xNwEdg4md4zXXF5iE+AfXcl6udqHQrODg5tgf1SeLADRNcCDJTWQQU9JloqE66Gv+Y9x KeuA== X-Gm-Message-State: AOAM5333yVrWcUwUzr6Abb9BKbMWRTsGtBDUZbyfuPgDPMsTj19DyQU4 Kl0VyfSoRN3S6+1kcw0MtcM= X-Google-Smtp-Source: ABdhPJzdgwlYpBgOWDfNAIT9gNyzVgmBfZzVkBgnvFp6cs2Hv2h+mkuqTHc0jdnNZ7Q2TJJamvS4/w== X-Received: by 2002:a50:8305:: with SMTP id 5mr2754718edh.174.1596181718662; Fri, 31 Jul 2020 00:48:38 -0700 (PDT) Received: from ?IPv6:2001:a61:3adb:8201:9649:88f:51f8:6a21? ([2001:a61:3adb:8201:9649:88f:51f8:6a21]) by smtp.gmail.com with ESMTPSA id ce12sm9076977edb.4.2020.07.31.00.48.37 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 31 Jul 2020 00:48:37 -0700 (PDT) Subject: Re: [RFC PATCH] Replacing "master-slave" terminology for pseudoterminals To: enh , Carlos O'Donell References: <88273c2f-ce21-db54-688d-5bebd4a81ecd@redhat.com> Message-ID: Date: Fri, 31 Jul 2020 09:48:34 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: "Michael Kerrisk \(man-pages\) via Libc-alpha" Reply-To: "Michael Kerrisk \(man-pages\)" Cc: Florian Weimer , linux-man , Linux API , mtk.manpages@gmail.com, "libc-alpha@sourceware.org" , Joseph Myers Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Hi Elliot, On 7/30/20 10:35 PM, enh wrote: > On Thu, Jul 30, 2020 at 4:38 AM Carlos O'Donell wrote: >> >> On 7/30/20 5:16 AM, Michael Kerrisk (man-pages) wrote: >>> I know what you mean. One reason for that verbosity is the need to >>> clearly distinguish "pseudoterminal device/end" from "pseudoterminal >>> device pair". It's hard to avoid being wordy there. >> >> The perfect is the enemy of the good. My feeling is that as others >> write this text in emails or discussions, we'll eventually all settle >> on some other short form we find agreeable and then later we can adjust >> the man pages to use that. > > based on my own brief experience, i'm expecting that _code_ will > settle on pty and tty. but if you're reading the man pages to > understand the concepts -- which are inherently quite confusing -- i > think spelling things out in longhand might remain useful in that > context. > >> Until then taking the lead to change this >> language is the correct way forward. > > yeah, definitely. > > i'd prefer for michael to go first -- since the bionic documentation > is basically just a link to man7.org, and even without that he's the > canonical source -- but i'm happy to go first and submit my change > first if it helps us make progress :-) I'd prefer to take this a little slowly. I don't plan to merge the changes just yet. I'm interested to get a bit more feedback first, including from Zack. (I'm guessing Zack is on holiday or so, which is why we've not heard from him.) Also, if we have rough consensus on this change, I would like to raise it with the POSIX folk; it would of course be great if there was a corresponding change in the standard, so that we all (all UNIX) have a common set of reference terms. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/