Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Mon, 2 Aug 2021 14:50:34 +0200
From:   Pali =?utf-8?B?Um9ow6Fy?= <pali@kernel.org>
To:     "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
Cc:     Glibc <libc-alpha@sourceware.org>,
        "linux-kernel@vger.kernel.org" <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: <ef6a352d-4926-9cdc-9894-e387866a00c4@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <ef6a352d-4926-9cdc-9894-e387866a00c4@gmail.com>
User-Agent: NeoMutt/20180716
Precedence: bulk

+ 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/