From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-oi1-x242.google.com (mail-oi1-x242.google.com [IPv6:2607:f8b0:4864:20::242]) by sourceware.org (Postfix) with ESMTPS id F0EE5386F01D for ; Fri, 2 Oct 2020 11:31:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org F0EE5386F01D Received: by mail-oi1-x242.google.com with SMTP id m128so910998oig.7 for ; Fri, 02 Oct 2020 04:31:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:reply-to :from:date:message-id:subject:to:cc; bh=mnnBdvVoAs7YLFpNF04SfBRR73VgOIK46UIMo67rx88=; b=lXlBRyx0LwCrxVowhRlxZhRh0CWa95XKGgiRu05QOGow6GOo5/q0Z50yWGrTU18WwY 8kV4ymRiymoW///yzchX4rhPRDoanl67huuW2xcoh+BB0x3MhhnY2J5pAlR96OoRpvBp rhqCUYeu7KZG2wq6bNPDdE2Mjzd8TsvQTfrY5VsOEwXIfy+STN+V21VbEaRM2x0u7uC4 +f6hrShQOhnEPBjd73/UJhqJ76NiK3cIWFU1wiyfj7tjd6CR2lOeS20NdHvK/2cQfaGA eJgNcYTLmfHAn10x8fy1Hh46T/4EB+JpgLDmIeZivy0Kx4RcU6PzCd1ABeHXe3n0KFb9 457g== X-Gm-Message-State: AOAM533hiUbtB+Q1og1jNJ3vHIowVq6Ac77SSEYsLTYq8ovbQChUsUyo IBTjDbI6iwb9bSh8B4270jQy/YM0BQlVfzaSdTs= X-Google-Smtp-Source: ABdhPJyGTHyvmUMr1RMtxBqF2YvdVOrsmV8o2rkTprrgjfnFPKzZcnmIM/sWFnE40ck3efT53RVUbJUQy6sCGj7MMac= X-Received: by 2002:aca:ad08:: with SMTP id w8mr917932oie.148.1601638301365; Fri, 02 Oct 2020 04:31:41 -0700 (PDT) MIME-Version: 1.0 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> In-Reply-To: Reply-To: mtk.manpages@gmail.com From: "Michael Kerrisk (man-pages)" Date: Fri, 2 Oct 2020 13:31:30 +0200 Message-ID: Subject: Re: [PATCH v2 1/2] system_data_types.7: Add 'void *' To: Jonathan Wakely Cc: Alejandro Colomar , Paul Eggert , linux-man , GNU C Library , "linux-kernel@vger.kernel.org" , "gcc@gcc.gnu.org" Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-2.8 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: Fri, 02 Oct 2020 11:31:43 -0000 On Fri, 2 Oct 2020 at 12:49, Jonathan Wakely wrote: > > On Fri, 2 Oct 2020 at 09:28, Alejandro Colomar via Gcc wrote: > > However, it might be good that someone starts a page called > > 'type_qualifiers(7)' or something like that. > > Who is this for? Who is trying to learn C from man pages? Should > somebody stop them? Yes, I think so. To add context, Alex has been doing a lot of work to build up the new system_data_types(7) page [1], which I think is especially useful for the POSIX system data types that are used with various APIs. With the addition of the integer types and 'void *' things are straying somewhat from POSIX into C. I think there is value in saying something about those types, but I'm somewhat neutral about their inclusion in the page. But Alex has done the work, and I'm willing to include those types in the page. I do think that something like type_qualifiers(7) strays over the line of what should be covered in Linux man-pages, which are primarily about the kernel + libc APIs. [2] Thanks, Michael [1] https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/man7/system_data_types.7 [2] Mind you, man-pages trayed over the line already very many years ago with operators(7), because who ever remembers all of the C operator precedences. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/