From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-ed1-x543.google.com (mail-ed1-x543.google.com [IPv6:2a00:1450:4864:20::543]) by sourceware.org (Postfix) with ESMTPS id E4CD5381DC73 for ; Sat, 3 Oct 2020 11:39:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org E4CD5381DC73 Received: by mail-ed1-x543.google.com with SMTP id k14so4608675edo.1 for ; Sat, 03 Oct 2020 04:39:09 -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=UTw9SC4xG6loXYiQpgIO7a9BnRpjOpziIFfpkToaJz4=; b=oBULunV/CM5jCMQaFMXWpN0gTrRzKRrHDZ1MNAgCDthQz2yhK3uutAXZsYBYaKJSpW HYElpLjcVpdMv70aiC4hK8L8xDl275jvGKi4a3TA9zwvTk5UcTb2xDKLgcCI2vDJtgSW eBRyD0NJZ+Y6+7HX94E/zYNXBlXYLspC8+gyTq6WMTWJqnigWGIu0VdPs5aeO/G5y/29 hgMo4bmAo/eVEitjEYgRpwICkZjpC11Xc/1Q80H1w6DSESoxR2IKb231r/A4tTs6H+bg P+C7Nq/C0vp6excj5s+3/clFWuCXiiFMub9Ut3T82lgWSEzv2Wa3ckMWPonGrBETWhd1 GukA== X-Gm-Message-State: AOAM533SdS5KtB/3hWN8wUUWau3LoCZMfkK8luNcSjcisaqBlOz+mO90 axnFvmexfFSLVfpacqwwdYWTPcpA/y8= X-Google-Smtp-Source: ABdhPJz4IGJ4ISYi6auC7O+f73vqDdlpSHUE03FsbQ2189tNDKHW9mgdT3bZ8AICQAd+bomKwE+GfQ== X-Received: by 2002:a50:cbc7:: with SMTP id l7mr7962966edi.148.1601725149082; Sat, 03 Oct 2020 04:39:09 -0700 (PDT) Received: from ?IPv6:2001:a61:2479:6801:d8fe:4132:9f23:7e8f? ([2001:a61:2479:6801:d8fe:4132:9f23:7e8f]) by smtp.gmail.com with ESMTPSA id g3sm1367436eds.56.2020.10.03.04.39.07 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 03 Oct 2020 04:39:07 -0700 (PDT) Cc: mtk.manpages@gmail.com, Jonathan Wakely , Paul Eggert , linux-man , GNU C Library , "linux-kernel@vger.kernel.org" , "gcc@gcc.gnu.org" , David.Laight@ACULAB.COM Subject: Re: Navigational corrections To: Alejandro Colomar References: <41affebd-3354-9420-0048-bffd14535e95@gmail.com> <20201001154946.104626-2-colomar.6.4.3@gmail.com> <538b683f-01d2-6148-4f1d-1b293eb5cd6b@cs.ucla.edu> <4b86f6e9-0d8a-f14a-73ce-ebbdc9d9edba@gmail.com> <63826e82-7a19-0ecc-f73c-56aa560a842f@gmail.com> <4422e4bc-f54c-02cf-9b47-808d07ce8ba5@gmail.com> <297e304a-758e-f703-d1e2-6708be3ffca8@gmail.com> <9c8f90c5-0f34-609f-8001-a61f90e05849@gmail.com> From: "Michael Kerrisk (man-pages)" Message-ID: <4c8a8fbf-3577-a242-94db-3044b57f6570@gmail.com> Date: Sat, 3 Oct 2020 13:39:06 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.11.0 MIME-Version: 1.0 In-Reply-To: <9c8f90c5-0f34-609f-8001-a61f90e05849@gmail.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-5.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, KAM_SHORT, NICE_REPLY_A, 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: Sat, 03 Oct 2020 11:39:11 -0000 Hi Alex, > > > > The question of 'void *' is an interesting one. It is something > > like a fundamental C type, and not something that comes from POSIX. > > But, it does appear in POSIX APIs and often details of using > > the type are not well understood. So, as a matter of practicality, > > and again since you've done the work, I am inclined to include > > this type in the page, just so it can be handily referred to > > along with all of the other types. > > > > Looking ahead (and I hope none of the above disheartens you, > > since you've done a lot of great work for this page), > > Actually, not. > Its good to have you tell me what is good for the man and what's not. > Otherwise, I wouldn't know. > I keep a branch with all of the rejected patches, > just to have an idea of what I should not send you :-) > > > it would > > be good if you could provide a bit of an advance roadmap about > > the types that you'd like to add to the page. > > Well, I didn't have a clear roadmap. > I had some types which I clearly wanted to document, > and they were ptrdiff_t, and ssize_t, > which I documented in the first patches, > and then I was finding related types, > and also tended to document about types which I knew very well too, > to have something useful to add to the description. > > I may now start writing about off_t and related types, > which were the ones that made me want this page. off_t would be great. In case you are looking for some other candidates, some others that I would be interested to see go into the page would be fd_set clock_t clockid_t and probably dev_t Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/