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;
To:     Glibc <libc-alpha@sourceware.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>
Cc:     =?UTF-8?Q?Pali_Roh=c3=a1r?= <pali@kernel.org>
From:   "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
Subject: Document the types "struct termios" and "struct termios2"
Message-ID: <ef6a352d-4926-9cdc-9894-e387866a00c4@gmail.com>
Date:   Mon, 2 Aug 2021 14:38:43 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.12.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

Hi,

 From a few patches of Pali and their subsequent discussions, 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/