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: AS3215 2.6.0.0/16 X-Spam-Status: No, score=-4.3 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [IPv6:2620:52:3:1:0:246e:9693:128c]) (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 D5C931F8C6 for ; Thu, 5 Aug 2021 16:47:07 +0000 (UTC) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C6236396902E for ; Thu, 5 Aug 2021 16:47:06 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C6236396902E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1628182026; bh=mXtlnpS0stCW6p/kWe+1oJUoJ7fR9ZCayNlWr75tAV4=; h=Subject:To:References:Date:In-Reply-To:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=iayCnAPzO1CMx/sC3R+ks0TU1/gEUaBjVbGjGC1brjL7tQZDPW87puUjNjMLUd40t Fe5gbd63f9hil3QP57LZIDo/vWlWaRg3VaqnEYoK9vdZOjZ8FwTSTWoW0iu4A6Gxx8 sgbxezYcKTwd6x1lsLwbWPuTJkOy9O9ysiZQ7m4Y= Received: from mail-wm1-x336.google.com (mail-wm1-x336.google.com [IPv6:2a00:1450:4864:20::336]) by sourceware.org (Postfix) with ESMTPS id CA33A3992CA9 for ; Thu, 5 Aug 2021 16:46:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org CA33A3992CA9 Received: by mail-wm1-x336.google.com with SMTP id l34-20020a05600c1d22b02902573c214807so6825411wms.2 for ; Thu, 05 Aug 2021 09:46:00 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=mXtlnpS0stCW6p/kWe+1oJUoJ7fR9ZCayNlWr75tAV4=; b=oXiFLBH5FrP2av2Fm3g/mw0QkVKshzy/DqCS5ffIURepisOPGp/hYaJ+xLvPFbMZF/ xv+Uou75vpqVIy9E2SOo0jusdLc6h2caCPmYs+vJnInzoCcvkc8bBFhAvoE/OsfWrQRl UOXQu/3k1FDiXyrwce7WV/kvTuS4DYbCuFNHujfHKdQhy+MjqiP7VZInY6APYoP+b/1L 9IKv8hrQXkQKwpFpnXSBwnXemXrd5w5wus40f7YNv+duUwapaVzYXgKYTM/z+CnR7EYR YPGUR9Q08pghDqik+gCiq6PewbXn1TcYuSJRAGuxsBobgKxXem6yf8DJl7hG5/ahr7M1 JV7g== X-Gm-Message-State: AOAM532LoMn2V5J2TcdiI13BTV7M8R/ObbjeR1TOn2/FV35yWPCGxm+F /qpWc05qZdHykau24EN6+84= X-Google-Smtp-Source: ABdhPJwRUyZnSZdFNLbiTC8Spr7QMiK0RrU0MsPAN2d0UCuGdknfP3KD9yMWXP7jgSWLccUb2m73+Q== X-Received: by 2002:a1c:188:: with SMTP id 130mr5997844wmb.184.1628181959872; Thu, 05 Aug 2021 09:45:59 -0700 (PDT) Received: from [10.8.0.10] ([195.53.121.100]) by smtp.gmail.com with ESMTPSA id m64sm7250892wmm.41.2021.08.05.09.45.58 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 05 Aug 2021 09:45:59 -0700 (PDT) Subject: Licensing example programs in man-pages (was [PATCH v3] ioctl_tty.2: Add example how to get or set baudrate on the serial port) To: Greg Kroah-Hartman , Michael Kerrisk References: <20210730095333.6118-1-pali@kernel.org> <20210801135146.14849-1-pali@kernel.org> <20210804220808.cetleob6dldpfnjk@pali> <20210805082243.qciylqnt5g74if7i@pali> <20210805084410.sb5lybdri6r7t2da@pali> <20210805095100.n2qkm3kdiucwt6jd@pali> <418a281b-441d-66fc-6929-5d29fafc459b@gmail.com> Message-ID: <4757a0c3-896f-a402-acb1-7e7fcadaa907@gmail.com> Date: Thu, 5 Aug 2021 18:45:57 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.12.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit 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: "Alejandro Colomar \(man-pages\) via Libc-alpha" Reply-To: "Alejandro Colomar \(man-pages\)" Cc: =?UTF-8?Q?Marek_Beh=c3=ban?= , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-serial@vger.kernel.org, Andres Brouwer , "G. Branden Robinson" , =?UTF-8?Q?Pali_Roh=c3=a1r?= , Walter Harms Errors-To: libc-alpha-bounces+e=80x24.org@sourceware.org Sender: "Libc-alpha" Hi Greg, On 8/5/21 6:14 PM, Greg Kroah-Hartman wrote: > On Thu, Aug 05, 2021 at 05:28:49PM +0200, Alejandro Colomar (man-pages) wrote: >> Hi Pali, >> >> On 8/5/21 11:51 AM, Pali Rohár wrote: >>>>>> Also, you forgot a license for this code, that is required if you want >>>>>> people to use it... >>>>> >>>>> Hm... I do not see any license in other manpage examples. Does not apply >>>>> for it global license defined in ioctl_tty.2 file? >>>> >>>> That does not mean you do not need it. >> >> I don't know what is the status of the current code examples in terms of >> licensing. >> >> I thought I had seen an SPDX license identifier in one of them some time >> ago, but now I can't find it. >> >> Technically, the pages have a license at the top of each file, which isn't >> printed on the rendered output (the license text doesn't require so) (see >> that text below). >> >> If you want a different license for your example (let's say you want it BSD >> for example), I guess you could add an SPDX line at the top of the example >> for simplicity. >> >> But if your code example adheres to the same license as the rest of the >> page, I guess you don't need to do anything in your patch. > > What is the license of a man page? Typically, the one I showed in my last email (the "Verbatim" license"). See . > > What is the license of this page? .../linux/man-pages$ head -n8 man2/ioctl_tty.2 .\" Copyright 2002 Walter Harms .\" and Andries Brouwer . .\" .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) .\" Distributed under GPL .\" %%%LICENSE_END .\" .TH IOCTL_TTY 2 2021-03-22 "Linux" "Linux Programmer's Manual" I'm don't know what GPL_NOVERSION_ONLINE is at all. CC += Walter, Andries > > And if it is not shown in the code segment itself, that's going to be a > mess, please make it explicit, otherwise no one can ever use any of the > code examples for anything. I'm not against that. At However, there's an explicit mention (without any rationale at all, or I couldn't find it) in man-pages(7) that the Linux man-pages project doesn't use the COPYRIGHT section: [ DESCRIPTION This page describes the conventions that should be employed when writing man pages for the Linux man‐pages project, which documents the user‐space API provided by the Linux kernel and the GNU C library. The project thus provides most of the pages in Section 2, many of the pages that ap‐ pear in Sections 3, 4, and 7, and a few of the pages that appear in Sections 1, 5, and 8 of the man pages on a Linux system. The conventions described on this page may also be useful for authors writing man pages for other projects. [...] Sections within a manual page The list below shows conventional or suggested sections. Most manual pages should include at least the highlighted sections. Arrange a new manual page so that sections are placed in the order shown in the list. [...] COPYRIGHT [Not used in man‐pages] ] [[man-pages(7)]] Maybe Michael can provide a rationale for this. Still, if the code is going to have a different license than the rest of the page, it could perfectly have an SPDX comment in the first line of the example program. Thanks, Alex -- Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/