From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 From: Pali =?utf-8?B?Um9ow6Fy?= To: "Alejandro Colomar (man-pages)" Cc: Glibc , "linux-kernel@vger.kernel.org" , linux-serial@vger.kernel.org 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-Spam-Status: No, score=-6.5 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) 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, 02 Aug 2021 12:50:40 -0000 + 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/