From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by sourceware.org (Postfix) with ESMTPS id 27CAE3864858 for ; Fri, 2 Oct 2020 19:01:36 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 27CAE3864858 Received: by mail-wr1-x443.google.com with SMTP id w5so2890166wrp.8 for ; Fri, 02 Oct 2020 12:01:36 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=r+fzPKCBU2bObjLgaHHSz8nWQ1qfzAC2vRidNLoubsw=; b=bqUsEdrUIfG/0ItruQWjIU2n51t7d5CYJvcfAXqr4hSzbcosM1xxlKtusaPM7Y7xBD aJ9XtS/efjTlVhBdyyb0B5aM0NV8IYjQchXWl1Eja6SAzISYY41tCL4aIzqPGRrldUoJ nQuPD+wV28XOE2CI+VGqXFqBj1TkOLH6L39WI/OAiFWbZPQ3GUVij3442Q3gWfWqC7WM ztHumwlmNfqfIv43l/kEGTjKvSWfOW4TI64CMtrc4+fzWl4CIMM4l4JWXBzkyAKaPEJ8 sFRcFNZPPGGc8rA3XGa8DCH7SuZyWpvSvaywzSHveN0vmKAtZBqUdoE7157CktiAsoB8 c7MQ== X-Gm-Message-State: AOAM533cxoIUJ9sPHfcCscCP+Rl/0indyVPKPtFL4g3YDzmHRTt1HwR3 gRjO/+57VsSb4DecenoWN3E= X-Google-Smtp-Source: ABdhPJy3aHH5/0pVxjE7G0Vh9WtNCl650PNLK77B3BBJ8q4Iy7zcn8XNqypEQUvNktO0oYtpINNKpw== X-Received: by 2002:a5d:4a4a:: with SMTP id v10mr4541567wrs.72.1601665295223; Fri, 02 Oct 2020 12:01:35 -0700 (PDT) Received: from [192.168.1.143] ([170.253.60.68]) by smtp.gmail.com with ESMTPSA id y6sm2672896wrt.80.2020.10.02.12.01.34 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 02 Oct 2020 12:01:34 -0700 (PDT) Subject: Re: [PATCH 1/4] system_data_types.7: Add '__int128' To: Paul Eggert Cc: Florian Weimer , Alejandro Colomar via Libc-alpha , linux-man@vger.kernel.org, gcc-patches@gcc.gnu.org, mtk.manpages@gmail.com References: <20201001163443.106933-1-colomar.6.4.3@gmail.com> <20201001163443.106933-2-colomar.6.4.3@gmail.com> <87eemg97ew.fsf@oldenburg2.str.redhat.com> From: Alejandro Colomar Message-ID: Date: Fri, 2 Oct 2020 21:01:33 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.12.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-4.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, 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: Fri, 02 Oct 2020 19:01:37 -0000 Hi Paul, On 2020-10-02 19:52, Paul Eggert wrote: > Why describe __int128_t in these man pages at all? __int128_t is not a > property of either the kernel or of glibc, so it's out of scope. Well, as I see it, [unsigned] __int128 is as good as [u]int64_t. They are part of the C interface in Linux. As a programmer I never cared if it was Glibc providing me the type with a typedef, or GCC providing me the type with its magic. If you propose not to document the stdint types either, I can see your position, but I'll disagree. A few personal lines: I just want to use it, and to do that, I need a reference manual where to look for how to use it. And belive me that unsigned __int128 has been very useful to me. I think having this page with most of the types, in a centralized manner, is exactly what I would have needed in the past. I have had trouble finding where ssize_t was defined. I could have looked at the POSIX manual, and I would have easily found that it is defined in , but I didn't even know that it was a POSIX thing (and I can tell that I'm not the only one who didn't know this :), so I didn't even know where to search for it. When I wanted to use unsigned __128, kind of the same thing, where do you search for the documentation of something that you don't even know who specified it? When that happens, the first thing for me is to 'man something'. If that doesn't give me any useful info, then duckduckgo something. In the internet there's much info, but also much of it is incomplete or incorrect, so if I have the man, I trust the man over anything else (except for the standard documents, of course). But the standards documents usually provide the information in a reverse fashion: If you know where to look at, you'll find it. But if you only know its name, it'll be hard to find where it is. The man provides documentation with the name of what you want to know about. Simple and easy. And man is faster than the internet :) Regards, Alex.