From owner-dev-commits-doc-all@freebsd.org Fri Mar 19 02:09:34 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B39015B3DB6 for ; Fri, 19 Mar 2021 02:09:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4F1nQQ4msqz3KhF; Fri, 19 Mar 2021 02:09:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 96D454E20; Fri, 19 Mar 2021 02:09:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 12J29YEb039896; Fri, 19 Mar 2021 02:09:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 12J29YHd039895; Fri, 19 Mar 2021 02:09:34 GMT (envelope-from git) Date: Fri, 19 Mar 2021 02:09:34 GMT Message-Id: <202103190209.12J29YHd039895@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: df7847b887 - main - spdx: document usage MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: df7847b8870b5d647c755014c0ac4e9e91d3c282 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Mar 2021 02:09:34 -0000 The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=df7847b8870b5d647c755014c0ac4e9e91d3c282 commit df7847b8870b5d647c755014c0ac4e9e91d3c282 Author: Warner Losh AuthorDate: 2021-03-19 02:08:53 +0000 Commit: Warner Losh CommitDate: 2021-03-19 02:08:53 +0000 spdx: document usage Document that we try to follow SPDX 2.2 for the SPDX-License-Idneitfier: tags that are in the source. Note that they are informative only. Give pointers to the standards and a status of the files marked in-tree. Suggestions by: Pau Amma Differential Revision: https://reviews.freebsd.org/D29330 --- .../content/en/articles/committers-guide/_index.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index edf7815827..5e8e39441f 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3427,6 +3427,20 @@ Once the {core-email} is satisfied that all the necessary details have been gath The license archive should contain only details of license grants; this is not the place for any discussions around licensing or other subjects. Access to data within the license archive will be available on request to the {core-email}. +[[spdx.tags]] +== SPDX Tags in the tree + +The project uses https://spdx.dev[SPDX] tags in our source base. +At present, these tags are indented to help automated tools reconstruct license requirements mechanically. +All _SPDX-License-Identifier_ tags in the tree should be considered to be informative. +All files in the FreeBSD source tree with these tags also have a copy of the license which governs use of that file. +In the event of a discrepency, the verbatim license is controlling. +The project tries to follow the https://spdx.github.io/spdx-spec/[SPDX Specification, Version 2.2]. +How to mark source files and valid algebraic expressions are found in https://spdx.github.io/spdx-spec/appendix-IV-SPDX-license-expressions/[Appendix IV] and https://spdx.github.io/spdx-spec/appendix-V-using-SPDX-short-identifiers-in-source-files/[Appendix V]. +The project draws identifiers from SPDX's list of valid https://spdx.org/licenses/[short license identifiers]. +The project uses only the _SPDX-License-Identifier_ tag. + +As of March 2021, approximately 25,000 out of 90,000 files in the tree have been marked. [[developer.relations]] == Developer Relations