From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.3 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,NICE_REPLY_A,SPF_HELO_NONE, SPF_PASS,USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id DF673C4338F for ; Sun, 8 Aug 2021 21:30:42 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id A367C60041 for ; Sun, 8 Aug 2021 21:30:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230071AbhHHVbB (ORCPT ); Sun, 8 Aug 2021 17:31:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42864 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229977AbhHHVbA (ORCPT ); Sun, 8 Aug 2021 17:31:00 -0400 Received: from mail-pj1-x102e.google.com (mail-pj1-x102e.google.com [IPv6:2607:f8b0:4864:20::102e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 740F0C061760 for ; Sun, 8 Aug 2021 14:30:40 -0700 (PDT) Received: by mail-pj1-x102e.google.com with SMTP id u13-20020a17090abb0db0290177e1d9b3f7so31434207pjr.1 for ; Sun, 08 Aug 2021 14:30:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=cc:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=eIgKGn/RF5lWJrN+gzGfJ/ujGuBUJBCKuJi4vGpOmOk=; b=pZsUaDUKvF+gU/s5whU/ijgVZ9moiTJRk6L2X9nY4OpqNb0ef+W4f5Jl/b36vhXRVy BPswb5w+9oP8u8gOheNBwKAMdMRgQ/5YbYnmRrCRYSJZQ8fL+1n77vKpDSSPKIeGOCzM 5VHql4uGFCVlRHtV+lIJtH3b6Kq/fM/dBisM94sQ5alJ7j3mGzdbQe+wyZ/lkpZ/l1T7 VVHkyzcobDUlzb6/3q2Bloha7vWf5KkgWZvDjt2/kuIDDmUUe3UyeW4iwHUNbvWuAYXL qGOtlgh0jELaEiLYzODGuV6fEjeTsEkMTga0lPglGG3OZ6bAMhULkRZ17qczurpw2kKT X6hQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:cc:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=eIgKGn/RF5lWJrN+gzGfJ/ujGuBUJBCKuJi4vGpOmOk=; b=AeE/aRZpZruUlO/mHruN0G4d2E0RfThhHEroqFvxIJpjUzDAd8XolH8hC5Hg6smcpQ nbyQkWbrFJs51eoRqqr35HHSR/pSXoB3zKUQMyIovptoX0u4pyQj5728NFkgLPcOc5AM sWPz6I2lGiht1HtbZCAW2u3OUlPWPcEC68CV4LjLq5o/gVf33cYKHNaz8IoARN0+pV65 b+0GRR//NI8d0fbTP9ktif0vxoExSnPcecUI64J7LZw7RqcbUOHGtb/QG2hKcf49qsrW EjviEY5ODAjozTtAOBLDSA+elQq7fHLapiaoLVQrT5iJBfn++F0k482SZtBf2P1FfJ9d e7JQ== X-Gm-Message-State: AOAM533LSpZQhVx25Xzh6G/JszNHSxghCUNZkSsj92/Cns6qahkg4pLG W+8LjafKo5AMAT6GjZhtlExwHFNS1Vg= X-Google-Smtp-Source: ABdhPJwdXS5olnVUCye3zNtTTfQ3mT7SupYdd+eYkKUVu5/DYL1rieUY4+3lmc3eypwDqvLYsynstA== X-Received: by 2002:a63:134e:: with SMTP id 14mr1145890pgt.312.1628458239659; Sun, 08 Aug 2021 14:30:39 -0700 (PDT) Received: from [192.168.1.71] (122-61-176-117-fibre.sparkbb.co.nz. [122.61.176.117]) by smtp.gmail.com with ESMTPSA id c14sm21079165pjr.3.2021.08.08.14.30.37 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 08 Aug 2021 14:30:39 -0700 (PDT) Cc: mtk.manpages@gmail.com, Alejandro Colomar , linux-man@vger.kernel.org Subject: Re: [PATCH 13/23] ioctl_tty.2: Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2 To: =?UTF-8?Q?Pali_Roh=c3=a1r?= References: <20210808084133.734274-1-alx.manpages@gmail.com> <20210808084133.734274-14-alx.manpages@gmail.com> <7a378d4c-36a5-be42-79fb-aeb1c160984c@gmail.com> <20210808211501.iokfmydpsrrshabg@pali> From: "Michael Kerrisk (man-pages)" Message-ID: <62a83b1c-bb88-722a-87ab-7016d9ae16da@gmail.com> Date: Sun, 8 Aug 2021 23:30:32 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.11.0 MIME-Version: 1.0 In-Reply-To: <20210808211501.iokfmydpsrrshabg@pali> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org Hello Pali, >> The Linux man-pages generally try to maintain historical and >> version info (at least back as far as 2.6.0), so I applied >> the patch below. > > Hello Michael! That is a good idea. Anyway, these ioctls were not added > for all architectures as for some they are not needed (when version 1 > already contains everything what was introduced in version 2). > > I collected all details which I found and I know in this email > https://lore.kernel.org/linux-man/20210808210530.ykqrihpfmdabbdl2@pali/ > and it is something which should be properly documented. But I do not > how to put these details into structured manpage... It's not immediately obvious to me, either, how to do this. Perhaps you eventually have some more ideas, but in the meantime, thanks for the improvements so far. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/