git: fbc1409c73 - main - Use @generated in generated files
Ed Maste
emaste at FreeBSD.org
Thu Feb 4 14:42:09 UTC 2021
The branch main has been updated by emaste (src committer):
URL: https://cgit.FreeBSD.org/doc/commit/?id=fbc1409c73012ea3d33c1bad851530ed29eb80da
commit fbc1409c73012ea3d33c1bad851530ed29eb80da
Author: Ed Maste <emaste at FreeBSD.org>
AuthorDate: 2021-02-01 17:55:05 +0000
Commit: Ed Maste <emaste at FreeBSD.org>
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'
More information about the dev-commits-doc-all
mailing list