From owner-dev-commits-doc-all@freebsd.org Thu Feb 4 14:42:09 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 A1E6954589A for ; Thu, 4 Feb 2021 14:42:09 +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 4DWh8d3vMXz4S3J; Thu, 4 Feb 2021 14:42:09 +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 6E3E858C9; Thu, 4 Feb 2021 14:42:09 +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 114Eg9mi092159; Thu, 4 Feb 2021 14:42:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 114Eg9Z8092158; Thu, 4 Feb 2021 14:42:09 GMT (envelope-from git) Date: Thu, 4 Feb 2021 14:42:09 GMT Message-Id: <202102041442.114Eg9Z8092158@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: fbc1409c73 - main - Use @generated in generated files MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fbc1409c73012ea3d33c1bad851530ed29eb80da 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: Thu, 04 Feb 2021 14:42:09 -0000 The branch main has been updated by emaste (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=fbc1409c73012ea3d33c1bad851530ed29eb80da commit fbc1409c73012ea3d33c1bad851530ed29eb80da Author: Ed Maste AuthorDate: 2021-02-01 17:55:05 +0000 Commit: Ed Maste CommitDate: 2021-02-04 14:39:06 +0000 Use @generated in generated files @generated is used by various tools to identify generated files. For example, Phabricator will not display diffs in generated files by default. Reviewed by: gjb Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D28446 --- documentation/tools/books-toc-creator.py | 2 +- documentation/tools/books-toc-examples-creator.py | 2 +- documentation/tools/books-toc-figures-creator.py | 2 +- documentation/tools/books-toc-parts-creator.py | 2 +- documentation/tools/books-toc-tables-creator.py | 2 +- website/tools/releases-toml.py | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/tools/books-toc-creator.py b/documentation/tools/books-toc-creator.py index 5d05448801..f5b4721a69 100644 --- a/documentation/tools/books-toc-creator.py +++ b/documentation/tools/books-toc-creator.py @@ -143,7 +143,7 @@ def main(argv): with open('./content/{0}/books/handbook/chapters-order.adoc'.format(language), 'r', encoding = 'utf-8') as chaptersFile: chapters = [line.strip() for line in chaptersFile] - toc = "// Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + toc = "// Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" toc += "// Please don't change this file manually but run `make` to update it.\n" toc += "// For more information, please read the FreeBSD Documentation Project Primer\n\n" toc += "[.toc]\n" diff --git a/documentation/tools/books-toc-examples-creator.py b/documentation/tools/books-toc-examples-creator.py index 1040b3cdfb..f72ffa945e 100644 --- a/documentation/tools/books-toc-examples-creator.py +++ b/documentation/tools/books-toc-examples-creator.py @@ -75,7 +75,7 @@ def main(argv): with open('./content/{0}/books/{1}/chapters-order.adoc'.format(language, book), 'r', encoding = 'utf-8') as chaptersFile: chapters = [line.strip() for line in chaptersFile] - toc = "// Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + toc = "// Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" toc += "// Please don't change this file manually but run `make` to update it.\n" toc += "// For more information, please read the FreeBSD Documentation Project Primer\n\n" toc += "[.toc]\n" diff --git a/documentation/tools/books-toc-figures-creator.py b/documentation/tools/books-toc-figures-creator.py index 05139ffa80..46bea6226b 100644 --- a/documentation/tools/books-toc-figures-creator.py +++ b/documentation/tools/books-toc-figures-creator.py @@ -75,7 +75,7 @@ def main(argv): with open('./content/{0}/books/{1}/chapters-order.adoc'.format(language, book), 'r', encoding = 'utf-8') as chaptersFile: chapters = [line.strip() for line in chaptersFile] - toc = "// Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + toc = "// Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" toc += "// Please don't change this file manually but run `make` to update it.\n" toc += "// For more information, please read the FreeBSD Documentation Project Primer\n\n" toc += "[.toc]\n" diff --git a/documentation/tools/books-toc-parts-creator.py b/documentation/tools/books-toc-parts-creator.py index d36e8a3dde..86ed31fbd1 100644 --- a/documentation/tools/books-toc-parts-creator.py +++ b/documentation/tools/books-toc-parts-creator.py @@ -20,7 +20,7 @@ def cleanTocFile(language, tocCounter): tocFile.truncate(0) def appendCommendAndTitle(language, tocCounter, tocContent): - toc = "// Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + toc = "// Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" toc += "// Please don't change this file manually but run `make` to update it.\n" toc += "// For more information, please read the FreeBSD Documentation Project Primer\n\n" toc += "[.toc]\n" diff --git a/documentation/tools/books-toc-tables-creator.py b/documentation/tools/books-toc-tables-creator.py index 7ebd7acdec..592330b7a4 100644 --- a/documentation/tools/books-toc-tables-creator.py +++ b/documentation/tools/books-toc-tables-creator.py @@ -75,7 +75,7 @@ def main(argv): with open('./content/{0}/books/{1}/chapters-order.adoc'.format(language, book), 'r', encoding = 'utf-8') as chaptersFile: chapters = [line.strip() for line in chaptersFile] - toc = "// Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + toc = "// Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" toc += "// Please don't change this file manually but run `make` to update it.\n" toc += "// For more information, please read the FreeBSD Documentation Project Primer\n\n" toc += "[.toc]\n" diff --git a/website/tools/releases-toml.py b/website/tools/releases-toml.py index 2e0b72b688..2dc96d310f 100644 --- a/website/tools/releases-toml.py +++ b/website/tools/releases-toml.py @@ -49,7 +49,7 @@ def main(argv): elif opt in ("-p", "--path"): path = arg - releasesTOML = "# Code generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" + releasesTOML = "# Code @" + "generated by the FreeBSD Documentation toolchain. DO NOT EDIT.\n" releasesTOML += "# Please don't change this file manually but run `make` to update it.\n" releasesTOML += "# For more information, please read the FreeBSD Documentation Project Primer\n" releasesTOML += '\n'