[VOL-5009] - Create a v2.12 release notes page.
overview/releases.rst
release_notes/index.rst
release_notes/voltha_2.12.rst
-----------------------------
o Create a skeleton release notes area for v2.12
Change-Id: Ia74075131326e0254af236d9c9edbdf8f46fa430
diff --git a/makefiles/consts.mk b/makefiles/consts.mk
index bac4362..8961b3a 100644
--- a/makefiles/consts.mk
+++ b/makefiles/consts.mk
@@ -17,6 +17,9 @@
# SPDX-FileCopyrightText: 2022-2023 Open Networking Foundation (ONF) and the ONF Contributors
# SPDX-License-Identifier: Apache-2.0
# -----------------------------------------------------------------------
+# https://gerrit.opencord.org/plugins/gitiles/onf-make
+# ONF.makefile.version = 1.0
+# -----------------------------------------------------------------------
$(if $(DEBUG),$(warning ENTER))
@@ -24,17 +27,25 @@
export dot :=.
export null :=#
export space := $(null) $(null)
-export quote-single := $(null)"$(null)#"
-export quote-double := $(null)'$(null)#'
+export quote-single := $(null)'$(null)#'
+export quote-double := $(null)"$(null)#"
# [DEBUG] make {target} HIDE=
-HIDE ?= @
+HIDE ?= @
env-clean ?= /usr/bin/env --ignore-environment
xargs-n1 := xargs -0 -t -n1 --no-run-if-empty
xargs-n1-clean := $(env-clean) $(xargs-n1)
## -----------------------------------------------------------------------
+## Intent: NOP command for targets whose dependencies do all heavy lifting
+## -----------------------------------------------------------------------
+## usage: foo bar tans
+## <tab>$(nop-command)
+## -----------------------------------------------------------------------
+nop-cmd := :
+
+## -----------------------------------------------------------------------
## Default shell:
## o set -e enable error checking
## o set -u report undefined errors
diff --git a/makefiles/help/include.mk b/makefiles/help/include.mk
index 3cca2cd..44c119a 100644
--- a/makefiles/help/include.mk
+++ b/makefiles/help/include.mk
@@ -30,7 +30,6 @@
@echo
@echo '[VIEW]'
@echo ' reload Setup to auto-reload sphinx doc changes in browser'
- @echo ' view-html View generated documentation'
@echo
@echo '[TEST]'
@echo ' test make lint linkcheck'
diff --git a/makefiles/include.mk b/makefiles/include.mk
index 3042488..db96771 100644
--- a/makefiles/include.mk
+++ b/makefiles/include.mk
@@ -36,6 +36,9 @@
include $(MAKEDIR)/patches/include.mk# # Patch when python 3.10+ in use
include $(ONF_MAKE)/help/variables.mk
+include $(ONF_MAKE)/targets/include.mk
+
+
$(if $(DEBUG),$(warning LEAVE))
# [EOF]
diff --git a/makefiles/targets/include.mk b/makefiles/targets/include.mk
new file mode 100644
index 0000000..2d49fda
--- /dev/null
+++ b/makefiles/targets/include.mk
@@ -0,0 +1,28 @@
+# -*- makefile -*-
+# -----------------------------------------------------------------------
+# Copyright 2022-2023 Open Networking Foundation (ONF) and the ONF Contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-FileCopyrightText: 2022 Open Networking Foundation (ONF) and the ONF Contributors
+# SPDX-License-Identifier: Apache-2.0
+# -----------------------------------------------------------------------
+
+$(if $(DEBUG),$(warning ENTER))
+
+include $(ONF_MAKE)/targets/test-errors.mk
+# include $(ONF_MAKE)/targets/tox.mk
+
+$(if $(DEBUG),$(warning LEAVE))
+
+# [EOF]
diff --git a/makefiles/targets/test-errors.mk b/makefiles/targets/test-errors.mk
new file mode 100644
index 0000000..548da7f
--- /dev/null
+++ b/makefiles/targets/test-errors.mk
@@ -0,0 +1,65 @@
+# -*- makefile -*-
+# -----------------------------------------------------------------------
+# Copyright 2022-2023 Open Networking Foundation (ONF) and the ONF Contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-FileCopyrightText: 2022 Open Networking Foundation (ONF) and the ONF Contributors
+# SPDX-License-Identifier: Apache-2.0
+# -----------------------------------------------------------------------
+
+$(if $(DEBUG),$(warning ENTER))
+
+## -----------------------------------------------------------------------
+## Intent: Summary 'make test' to hilight errors
+## -----------------------------------------------------------------------
+test-errors-lint := test-errors.lint.log
+test-errors-link := test-errors.linkcheck.log
+test-errors:
+ @echo "** Running $(MAKE) sterile"
+ $(HIDE)( $(MAKE) sterile 3>&1 2>&1 ) >/dev/null
+
+ @echo
+ @echo "** Running $(MAKE) lint"
+ -$(HIDE) ( $(MAKE) lint 3>&1 2>&1 ) > $(test-errors-lint)
+
+ @echo '** Screen log for errors: $(test-errors-lint)'
+ $(HIDE)! grep \
+ -e 'make: ***' \
+ $(test-errors-lint)
+
+ @echo
+ @echo "** Running $(MAKE) linkcheck"
+ -$(HIDE) ( $(MAKE) linkcheck 3>&1 2>&1 ) > $(test-errors-link)
+
+ @echo '** Screen log for errors: $(test-errors-link)'
+ $(HIDE)! grep \
+ -e 'make: ***' \
+ -e 'broken' \
+ $(test-errors-link)
+
+## -----------------------------------------------------------------------
+## Intent: Remove generated logfiles
+## -----------------------------------------------------------------------
+clean ::
+ $(RM) $(test-errors-lint) $(test-errors-link)
+
+## -----------------------------------------------------------------------
+## Intent: Display target help
+## -----------------------------------------------------------------------
+help ::
+ @echo ' test-errors Run make test and display an error summary'
+
+$(if $(DEBUG),$(warning LEAVE))
+
+# [EOF]
diff --git a/makefiles/todo.mk b/makefiles/todo.mk
index b122a9e..f788724 100644
--- a/makefiles/todo.mk
+++ b/makefiles/todo.mk
@@ -24,6 +24,11 @@
## -----------------------------------------------------------------------
todo ::
@echo '[TODO]'
+ @echo ' CLEANUP: make test'
+ @echo ' WARNING: document isnt included in any toctree'
+ @echo
+ @echo ' CLEANUP: make linkcheck'
+ @echo ' replace redirect URLs with resolved urls'
## -----------------------------------------------------------------------
## -----------------------------------------------------------------------
diff --git a/makefiles/virtualenv.mk b/makefiles/virtualenv.mk
index bcda734..fd178f3 100644
--- a/makefiles/virtualenv.mk
+++ b/makefiles/virtualenv.mk
@@ -14,6 +14,9 @@
# See the License for the specific language governing permissions and
# limitations under the License.
## -----------------------------------------------------------------------
+# https://gerrit.opencord.org/plugins/gitiles/onf-make
+# ONF.makefile.version = 1.0
+# -----------------------------------------------------------------------
$(if $(DEBUG),$(warning ENTER))