[rtems-central commit] spec/build-objects: Add details about duplicates

[Sebastian Huber]

Module:    rtems-central
Branch:    master
Commit:    0f0a61e83a9fc24ca41b53a6a3b6d919247bd0d7
Changeset: http://git.rtems.org/rtems-central/commit/?id=0f0a61e83a9fc24ca41b53a6a3b6d919247bd0d7

Author:    Kinsey Moore <kinsey.moore at oarcorp.com>
Date:      Tue Feb  7 16:00:56 2023 -0600

spec/build-objects: Add details about duplicates

Add a comment warning against duplicate ObjectsItem inclusions and why
that can cause problems.

---

 spec/spec/build-objects.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/spec/spec/build-objects.yml b/spec/spec/build-objects.yml
index 0453619d..695ab69f 100644
--- a/spec/spec/build-objects.yml
+++ b/spec/spec/build-objects.yml
@@ -54,7 +54,10 @@ spec-info:
         spec-type: build-source-list
     description: |
       This set of attributes specifies a set of object files used to build
-      static libraries or test programs.
+      static libraries or test programs. Objects Items must not be included on
+      multiple paths through the build dependency graph with identical build
+      options. Violating this can cause race conditions in the build system due
+      to duplicate installs and multiple instances of build tasks.
     mandatory-attributes: all
 spec-name: Build Objects Item Type
 spec-type: build-objects