From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-pf1-x444.google.com (mail-pf1-x444.google.com [IPv6:2607:f8b0:4864:20::444]) by sourceware.org (Postfix) with ESMTPS id C897C3941C37 for ; Mon, 28 Sep 2020 13:55:13 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C897C3941C37 Received: by mail-pf1-x444.google.com with SMTP id w7so1113754pfi.4 for ; Mon, 28 Sep 2020 06:55:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=w6ry1jrnmrFAtvxhzK+IJqkRsxyq9TMn2yhHFvEivH8=; b=tvOmX8sSO5iIw3Ph6KB3pmx90ZgaZXeiXpwojcsq2sS1wyhnAPVIxw3WQEA/B8a+Up KuzeWS37hjy02QMc0drA3FLH87wY4BW5v2TcFPBGRPYbMZSgvXzs2ksJyJ59/YSjnw+S CfGtJ1LtH3cUdljObmgzxLltRLWkenWFajmsbJ1WGVn0uPWbaoydQZgr8kMGNMKMSEU5 S0OOD/NjY93maJEP0/v643lMJxa6BF7yu0sT/RT5GHePL9+XE8DB9gQMWWBwm8161b1a prZ+pEGrZoQZIE0Yx0rYPgtBlmrv4zLIFwBTwcYuNlOIfc/UE2mqXCqEOML64e4444hq H0vg== X-Gm-Message-State: AOAM533AUdSs48q50fhIpx50rCgZ6V+SSScXoGQyJaD+tcI2/ohJUsKq EGereNXHcPMgbu4xyWHVOKQqvZRKCsdRyg== X-Google-Smtp-Source: ABdhPJwAvyXCuUN9Xc7ZHSy63AtdQD3ixVxjuqUR8hLtPJA+MnW4sA6BaN3bhSrV4FslUd7IOo4y4g== X-Received: by 2002:a63:d65:: with SMTP id 37mr1238750pgn.139.1601301312999; Mon, 28 Sep 2020 06:55:12 -0700 (PDT) Received: from localhost.localdomain ([1.129.175.25]) by smtp.gmail.com with ESMTPSA id p4sm1544307pju.29.2020.09.28.06.55.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 28 Sep 2020 06:55:12 -0700 (PDT) Date: Mon, 28 Sep 2020 23:55:08 +1000 From: "G. Branden Robinson" To: Alejandro Colomar Cc: Dave Martin , mtk.manpages@gmail.com, linux-man@vger.kernel.org, libc-alpha@sourceware.org Subject: Re: [PATCH 1/2] system_data_types.7: Document size_t Message-ID: <20200928135506.2wsf3cwvkkbreqa3@localhost.localdomain> References: <20200918112755.21428-1-colomar.6.4.3@gmail.com> <20200918112755.21428-2-colomar.6.4.3@gmail.com> <20200928134122.GG6642@arm.com> <8ce3d63c-445f-827b-a49a-914e8dd622d4@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="s5wptk7lgssa4yx6" Content-Disposition: inline In-Reply-To: <8ce3d63c-445f-827b-a49a-914e8dd622d4@gmail.com> User-Agent: NeoMutt/20180716 X-Spam-Status: No, score=-3.3 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, 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: Mon, 28 Sep 2020 13:55:15 -0000 --s5wptk7lgssa4yx6 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, Alex! At 2020-09-28T15:48:14+0200, Alejandro Colomar wrote: > > Where does this arbitrary-looking list of headers come from? >=20 > There are two parts: left to the ';', and right to the ';'. >=20 > Left: The canonical C standard header, and the canonical POSIX header, > in alphabetical order. >=20 > Right: All other headers that shall define the header, according to > either the C or the POSIX standards, in alphabetical order. That's not a bad scheme but it is not inferable from the current man page text; I almost commented on the inconsistency in one of my earlier messages but deemed it out of scope. Please document it, perhaps in an introductory paragraph at the top of the Description section. Or, you could spend a word to do the same work: gid_t Include: . Alternatively, , , , , , , or . Regards, Branden --s5wptk7lgssa4yx6 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAl9x6zoACgkQ0Z6cfXEm bc7t4w/8CuVE6jF59gFWPYWbTCu+HI+EXDlJ2QTeDv+606eraa0bDoqpJutDP4Y/ e1YEaXs2ReVz3jIuf3w44EQp7Q5MqdlRhfLh8d/1NeyoJces5RuP6/V89ywNKuCN miZYOsVEMy8bim1ZMmk5qSLImzyWQNpy0qkNCqHZkLP8qT3FE0DzeUF7Mml/bF9r pAVeraOYzYbgK5pMRIWThEfbZNmYJQIeCK3ZxbUHrO6UOyCNe11snjLeF9Kn+GFJ cI4j1Ebt8+KBtfoy0zYZCuS5JApQc0ELCcIBLYtpQ5N/RU505VIXVHLqcot7CZzy nbm8bA3BLUz3C+8ki744B+zECeM1EsTWl9aBpRoabWg0NQFNZ+xRYRptK2q0qQuE ZN1coZmfA5B2+HDvf4F9pJCXINQRqjPiJMgP8upuHvDm3/52Kx9tKc1iWwbpdCYf AxGWF7vFneYpkRSDdB9KVOs0yARDq02p9VjRvG2C7ZQmbKUHeDRAIvJegEsrGDwf 3xQxY/+Gcn85qYcYrZWWEYaVuyGt+5TzET/XiBTP9edmGB1pkSWhzvuDCKx0mk+r PytdPvZv/CriCWUOZ1el7V/WChj72PsI2j21WHrPX8n9e2vbXqTuq/dKiwq5hjvF wqMtyh82FFnzc1/NvbBeTjt43rmWHPfFdDyvLCsVXUnHQcYquz0= =e7kl -----END PGP SIGNATURE----- --s5wptk7lgssa4yx6--