From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by sourceware.org (Postfix) with ESMTPS id 5E8273857024 for ; Tue, 28 Jul 2020 19:27:44 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 5E8273857024 Received: by mail-wm1-x343.google.com with SMTP id c80so613269wme.0 for ; Tue, 28 Jul 2020 12:27:44 -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=NEP8f1HA94/7BvkhosbIhDE3QcOCsnT2HRa5vQVR+xE=; b=Ie+ei666/mVD6E2gYeOoBijTn9VLmAQutmiU8Wen5tUZwC7+WNj0vlFLiAuXdTE1SB mERorwCb8bIC8rP7cGndLxH2uDTRuiv0Atw+QB4Ew2d1PDaQ7hgBUZKsVYvkxABUkbVE dPHSVTXgXxiBXODcjvzYj+A6C0MFLMOUE9E4PnjC4QoBeAj0bj/fBBK66tJCAho761g3 RkICMg+n7hhwZE90phmLkKau+iQqgXRpYZkeoI/75fszvj4+CLSdTCHIvliNLKN9baLx CjockpzPkM61zZKLWunmneP2cIg/gchbPSgxJ6FKw9OmD1YsZsyfHKB4UoQ1lfTHbowT 9wig== X-Gm-Message-State: AOAM530X23bjHRvgnN71SyJ0+Mc+JfpjzYstMXmjnbx+JTRe9M0qGQhU x9EkXzUb7NLC2xyqwXKKY3M= X-Google-Smtp-Source: ABdhPJzKWxDSF532BMYLPEaI0P8DF/fxu3TdYd523iTmRUATgPW9tlEg8h11vVNAhNRfCdq53zcttg== X-Received: by 2002:a1c:81c7:: with SMTP id c190mr5704616wmd.129.1595964463415; Tue, 28 Jul 2020 12:27:43 -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 e5sm18151320wrc.37.2020.07.28.12.27.42 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 28 Jul 2020 12:27:42 -0700 (PDT) Cc: mtk.manpages@gmail.com, Zack Weinberg , Carlos O'Donell , libc-alpha , "Joseph S. Myers" , Florian Weimer , Paul Eggert Subject: Re: Pseudoterminal terminology (was Re: Rename "master" branch to "main"?) To: enh References: <423fbe8b-6b41-d9e8-c4a2-5865d8eeec4b@gmail.com> <990ea0cb-1997-9ad4-e0ea-f5ba54e22066@gmail.com> From: "Michael Kerrisk (man-pages)" Message-ID: <5a6b13e9-e0f7-e8a9-d07b-303e87237b4a@gmail.com> Date: Tue, 28 Jul 2020 21:27:41 +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-Spam-Status: No, score=-3.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, KAM_SHORT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org 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: , X-List-Received-Date: Tue, 28 Jul 2020 19:27:45 -0000 On 7/28/20 8:47 PM, enh wrote: [...] > parent/child might be a good choice for the related forkpty(). (given > bionic's "you'll probably be looking at this in Android Studio or Visual > Studio Code's argument name completion UI, so let's use a longer name to > save you a trip to the man page if you know roughly what you're doing but > can't remember what order the arguments are in" style, that would probably > still be `int forkpty(int* _Nonnull __parent_pty_fd, char* _Nullable > __child_tty_name, ...`.) > > (note also that the man page for forkpty() seems to be the only place the > return type is given as pid_t rather than int --- afaict all the libcs > actually use int?) The manual page seems to have been lifted (many years ago, before my time) from OpenBSD, where the return type really is pid_t. I wonder what the implications of changing this in glibc are? Or maybe the manual page just needs to be changed. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/