From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,NICE_REPLY_A,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C151EC433DB for ; Thu, 4 Mar 2021 00:31:59 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id AC42564E62 for ; Thu, 4 Mar 2021 00:31:59 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1355588AbhCDAb5 (ORCPT ); Wed, 3 Mar 2021 19:31:57 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49966 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1390740AbhCCWPl (ORCPT ); Wed, 3 Mar 2021 17:15:41 -0500 Received: from mail-ed1-x529.google.com (mail-ed1-x529.google.com [IPv6:2a00:1450:4864:20::529]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 85773C061756 for ; Wed, 3 Mar 2021 14:15:01 -0800 (PST) Received: by mail-ed1-x529.google.com with SMTP id bd6so18931108edb.10 for ; Wed, 03 Mar 2021 14:15:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=cc:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=kD4Q8mT8W2cyJTfFlPw5AqTxwcaAkWK8nd1++f9HvK4=; b=TyveJ8AIgSUZMz6pbeOVEHBXXiOxzpK+9XLXxTvtcESTbgsn29cz5SFBU5T90AUvvL qSArTfxLcfGq1CWy9D3Rc/47jglzuF1BeOWkVsB381O9uHmvxkEA+e3EF+tz0apgApve 0xehMh1P3btbk98EMH1B/t6orTnbcwVxfgRO9lIpXFg6cEfdukaFsTXpnPcX8fuzNsQM 13QHAQdwqhgbpD6CAN2tYcufw14FmElYs7CdBFaiXV+/UO5n6yVmAAVQJYlLL6CB7r/A uc190nXven8PCEMji0I7Q/ShJcduEWa1sSck7uHJUuuvx4KI3bwbDw9ovtPHeYpQ3nTF +p0g== 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=kD4Q8mT8W2cyJTfFlPw5AqTxwcaAkWK8nd1++f9HvK4=; b=qsruBGwOYCN47dMlsBvxog2ZAVcFc646XmmtUXxCTu+qqq93X5WNP37Cj41HitL7OS Rw+ejlE5s6VCRwcHJITvVh+qVgERTS8SFlpLXvo7RulX47zfAy/JGlxQAJ9NJvfmjd/w vO3R7bMg8qRYqZBfKM2AIa8xT7xOClsTZI2TBSqFFvk/zY6KPaQrSrxcvYpMR+0Kt9pQ TNTlCQi30U0kUhmTNpy1Dhk9qoC5UPXYbwlHd+rW28RlLIm+CVxKkac06b8dXk0Sklcd FKiYi+6k/GY/sFNDN2lMBSQoShl6JT8xiQYufVRPSZEGQ8ZGxW+mJWFI6gRB7/51IIL/ nBkw== X-Gm-Message-State: AOAM531W3CahWBMqyd2p7ynzTLtQ0ilA0Lpm+QNgnNcvslBdXyEyGq6K I2Ieh7OEYw5LNCp3Q/zGtT0= X-Google-Smtp-Source: ABdhPJwfBGtGWtdilldLlNtw7+3u8IlJZi80kOMyECIdTpywUiqp87f0FNfIlatKyUjwyHH+NT/Qsg== X-Received: by 2002:a05:6402:2215:: with SMTP id cq21mr1270372edb.281.1614809700135; Wed, 03 Mar 2021 14:15:00 -0800 (PST) Received: from ?IPv6:2001:a61:3a2d:1d01:99ab:4f20:ed7f:402b? ([2001:a61:3a2d:1d01:99ab:4f20:ed7f:402b]) by smtp.gmail.com with ESMTPSA id c20sm22265825eja.22.2021.03.03.14.14.59 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 03 Mar 2021 14:14:59 -0800 (PST) Cc: mtk.manpages@gmail.com, linux-man@vger.kernel.org, Heinrich Schuchardt Subject: Re: [PATCH 00/20] man3: SYNOPSIS: Use 'restrict' in prototypes (batch 1) To: Alejandro Colomar References: <20210224144310.140649-1-alx.manpages@gmail.com> From: "Michael Kerrisk (man-pages)" Message-ID: Date: Wed, 3 Mar 2021 23:14:58 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.6.0 MIME-Version: 1.0 In-Reply-To: <20210224144310.140649-1-alx.manpages@gmail.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org Hello Alex, On 2/24/21 3:42 PM, Alejandro Colomar wrote: > Hi Michael, > > This are the first pages of man3 with 'restrict'. > I'm sending you these already, becuase otherwise I'd accumulate > too many patches in the end. Thanks. I have applied all of these. > I have fixed from the first page until ftw.3. > > Spin off: > I found different terms for parameters that refer to a same thing > in different functions (usually a '[const] char *'): > - filename > - file > - path > - pathname > - Maybe others; I don't know > > For 'FILE *' we have more or less the same, > although this one is much more standard (>90% use 'stream'): > - stream > - streamp > - s > - fp > - file > - filehandle > - A few others in specific cases > > What would you do about it? I think it would be best to start a new thread for this... Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/