From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS17314 8.43.84.0/22 X-Spam-Status: No, score=-3.7 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, PDS_RDNS_DYNAMIC_FP,RCVD_IN_DNSWL_MED,RDNS_DYNAMIC,SPF_HELO_PASS, SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (ip-8-43-85-97.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 2E7C91F8C6 for ; Mon, 2 Aug 2021 12:51:00 +0000 (UTC) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 2CE443853C3F for ; Mon, 2 Aug 2021 12:50:59 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 2CE443853C3F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1627908659; bh=KgvAkG67a3emM8xmdBlrC3Lr8TuU/EbgYlMpV01ihJY=; h=Date:To:Subject:References:In-Reply-To:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=nr5y2RU7qesSLQFj6k6AWd+FYiy5nUNXLwcXDXM89XSR5nb/FzxlpsSinzlpYmLnn BoTzrj1AmR3wbhJgHi8/Ok0XzBlp72164v+epD/LEbBDVMs7c+lznL8pZbmxQ8gCZT uDc2qQPzKUKQaIMIJNsMDzX6K4p6R3WK29vUl2XI= Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by sourceware.org (Postfix) with ESMTPS id 4D0AC3857402 for ; Mon, 2 Aug 2021 12:50:39 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4D0AC3857402 Received: by mail.kernel.org (Postfix) with ESMTPSA id 31A2E60F58; Mon, 2 Aug 2021 12:50:37 +0000 (UTC) Received: by pali.im (Postfix) id BE1C1B98; Mon, 2 Aug 2021 14:50:34 +0200 (CEST) Date: Mon, 2 Aug 2021 14:50:34 +0200 To: "Alejandro Colomar (man-pages)" Subject: Re: Document the types "struct termios" and "struct termios2" Message-ID: <20210802125034.gubtf24tsm7lkh3k@pali> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: NeoMutt/20180716 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: , From: =?utf-8?q?Pali_Roh=C3=A1r_via_Libc-alpha?= Reply-To: Pali =?utf-8?B?Um9ow6Fy?= Cc: Glibc , "linux-kernel@vger.kernel.org" , linux-serial@vger.kernel.org Errors-To: libc-alpha-bounces+e=80x24.org@sourceware.org Sender: "Libc-alpha" + linux-serial On Monday 02 August 2021 14:38:43 Alejandro Colomar (man-pages) wrote: > Hi, > > From a few patches of Pali and their subsequent discussions, For others, link to patch with code example: https://lore.kernel.org/linux-man/20210801135146.14849-1-pali@kernel.org/ And links to other discussions: https://lore.kernel.org/linux-man/20210725225506.7404-1-pali@kernel.org/t/#u https://lore.kernel.org/linux-man/20210730105353.10424-1-pali@kernel.org/t/#u https://lore.kernel.org/linux-man/20210730153044.23673-1-pali@kernel.org/t/#u > it was clear > that those types need to be documented (the most appropriate place being > system_data_types(7), with link pages termios-struct(3) and > termios2-struct(3)). > > The most important part (the one we had problems with) being which headers > should be included for each type (and for each version of the type > (kernel/glibc)). That includes the recommended header, and other headers > that _shall_ also provide the type. > > Is there someone that knows those types enough to write such documentation > and wants to do it? :) > > Thanks, > > Alex > > -- > Alejandro Colomar > Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ > http://www.alejandro-colomar.es/