[PR #1893] [MERGED] docs(mac): Add documentation for -system-libs build mode

## 📋 Pull Request Information **Original PR:** https://github.com/CCExtractor/ccextractor/pull/1893 **Author:** [@gaurav02081](https://github.com/gaurav02081) **Created:** 12/24/2025 **Status:** ✅ Merged **Merged:** 12/25/2025 **Merged by:** [@cfsmp3](https://github.com/cfsmp3) **Base:** `master` ← **Head:** `brew-gaurav` --- ### 📝 Commits (1) - [`941604b`](https://github.com/CCExtractor/ccextractor/commit/941604b33c44cf3fd50c44c2832d65db35697121) docs(mac): Add documentation for -system-libs build mode ### 📊 Changes **1 file changed** (+157 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `docs/Building_macos_system_libs.md` (+157 -0) </details> ### 📄 Description [IMPROVEMENT] **In raising this pull request, I confirm the following (please check boxes):** - [x] I have read and understood the [contributors guide](https://github.com/CCExtractor/ccextractor/blob/master/.github/CONTRIBUTING.md). - [x] I have checked that another pull request for this purpose does not exist. - [x] I have considered, and confirmed that this submission will be valuable to others. - [x] I accept that this submission may not be used, and the pull request closed at the will of the maintainer. - [x] I give this submission freely, and claim no ownership to its content. - [ ] **I have mentioned this change in the [changelog](https://github.com/CCExtractor/ccextractor/blob/master/docs/CHANGES.TXT).** **My familiarity with the project is as follows (check one):** - [ ] I have never used CCExtractor. - [ ] I have used CCExtractor just a couple of times. - [ ] I absolutely love CCExtractor, but have not contributed previously. - [x] I am an active contributor to CCExtractor. --- PR Summary This PR documents the macOS -system-libs build mode introduced in #1862, which enables building CCExtractor using system-installed libraries instead of bundled dependencies. This mode is required for Homebrew compatibility and uses pkg-config to link against Homebrew-provided libraries (e.g. gpac, freetype, libpng, zlib). The default bundled build remains unchanged. The documentation explains: When to use the default vs -system-libs build Required Homebrew dependencies How to verify the build CI coverage for the system-libs path This provides a clear upstream reference for package managers and unblocks future Homebrew formula work. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

claunia commented

2026-01-29 17:23:24 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/CCExtractor/ccextractor/pull/1893
Author: @gaurav02081
Created: 12/24/2025
Status: ✅ Merged
Merged: 12/25/2025
Merged by: @cfsmp3

Base: master ← Head: brew-gaurav

📝 Commits (1)

941604b docs(mac): Add documentation for -system-libs build mode

📊 Changes

1 file changed (+157 additions, -0 deletions)

View changed files

➕ docs/Building_macos_system_libs.md (+157 -0)

📄 Description

[IMPROVEMENT]

In raising this pull request, I confirm the following (please check boxes):

I have read and understood the contributors guide.
I have checked that another pull request for this purpose does not exist.
I have considered, and confirmed that this submission will be valuable to others.
I accept that this submission may not be used, and the pull request closed at the will of the maintainer.
I give this submission freely, and claim no ownership to its content.
I have mentioned this change in the changelog.

My familiarity with the project is as follows (check one):

I have never used CCExtractor.
I have used CCExtractor just a couple of times.
I absolutely love CCExtractor, but have not contributed previously.
I am an active contributor to CCExtractor.

PR Summary

This PR documents the macOS -system-libs build mode introduced in #1862, which enables building CCExtractor using system-installed libraries instead of bundled dependencies.

This mode is required for Homebrew compatibility and uses pkg-config to link against Homebrew-provided libraries (e.g. gpac, freetype, libpng, zlib). The default bundled build remains unchanged.

The documentation explains:

When to use the default vs -system-libs build

Required Homebrew dependencies

How to verify the build

CI coverage for the system-libs path

This provides a clear upstream reference for package managers and unblocks future Homebrew formula work.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

claunia added the pull-request label 2026-01-29 17:23:24 +00:00

[PR #1893] [MERGED] docs(mac): Add documentation for -system-libs build mode #2683

📋 Pull Request Information

📝 Commits (1)

📊 Changes

📄 Description