Closed Bug 1676915 Opened 4 years ago Closed 4 years ago

It would be nice to have some documentation on unified build

Categories

(Firefox Build System :: General, enhancement, P3)

enhancement

Tracking

(firefox84 fixed)

RESOLVED FIXED
84 Branch
Tracking Status
firefox84 --- fixed

People

(Reporter: mstange, Assigned: mhentges)

References

Details

(Keywords: in-triage)

Attachments

(1 file)

It would be nice to be able to a link to a small piece of documentation that describes:

  • what unified build / unified compilation is, and
  • why adding or removing cpp files to a directory can break compilation of unrelated files.
Severity: -- → S3
Keywords: in-triage
Priority: -- → P3

As such, this is not a Firefox-specific question. Elsewhere it is also referred to as "unity build:", and described, e.g., in https://en.wikipedia.org/wiki/Unity_build

Are there questions specific to the implementation in the Firefox Build System that should be answered?

Interesting, I wasn't aware of that wikipedia page. What I'm really looking for is just a short blurb that answers the question "Why is the compiler asking me to make changes to files I didn't touch?", that I can link newcomers to.

Assignee: nobody → mhentges
Status: NEW → ASSIGNED

Describe what unified builds are and how they can cause innocuous
changes to cause unexpected compilation failures.

Note we're not particularly attached to the term. It could make sense to change.

Pushed by mhentges@mozilla.com:
https://hg.mozilla.org/integration/autoland/rev/c5fc2ec859df
Add documentation page about Unified Builds r=firefox-build-system-reviewers,mstange,dmajor DONTBUILD
Status: ASSIGNED → RESOLVED
Closed: 4 years ago
Resolution: --- → FIXED
Target Milestone: --- → 84 Branch
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Created:
Updated:
Size: