[DOCS] Add guides for building FreeSWITCH build-dependencies

* [DOCS] Add guides for building FreeSWITCH build-dependencies

* Add `build-dependencies.sh` script

Author: s3rj1k

scripts/packaging/build/README.md

@@ -1,6 +1,29 @@
 # Building FreeSWITCH packages using `FSDEB`
+## Install build dependencies first
+In order to build FreeSWITCH packages first you need to install build dependencies. There are two ways:
+* [From our FreeSWITCH Debian repository](#install-build-dependencies-from-repo) (using [FSGET](/scripts/packaging) for example) - the simplest way
+* [Manually compile the build dependencies](#manually-compile-build-dependencies)
+
+<a name="install-build-dependencies-from-repo"></a>
+### Configuring FreeSWITCH Debian repo (for dependencies)
+Since we are building a FreeSWITCH release let's configure FreeSWITCH Community Release Debian repo.
+We recommend using [FSGET](/scripts/packaging).
+
+Replace `<PAT or API token>` with your `SignalWire Personal Access Token (PAT)`
+[HOWTO Create a SignalWire Personal Access Token](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/how-to-create-a-personal-access-token/how-to-create-a-personal-access-token)
+```bash
+curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token>
+```
+Configuring the repo is enough. Dependencies will be installed during the FreeSWITCH building process.
+
+<a name="manually-compile-build-dependencies"></a>
+### Manually compile the build dependencies
+Just follow this [Dependency Building Guide](dependencies/README.md) without the need to set up the FreeSWITCH Debian repo.</br>
+Although we recommend using the FreeSWITCH Debian repo as all the dependencies are already prebuilt for you.
+
+---
 ## Prerequisites
-FreeSWITCH packages can be built when FreeSWITCH is cloned using `git` only.  
+FreeSWITCH packages can be built when FreeSWITCH is cloned using `git` only.
 (Methods described here won't work if you download a source tarball and extract it)
 
 Please make sure you have `git` and `curl` installed:
@@ -17,16 +40,7 @@ cd /usr/src
 git clone https://github.com/signalwire/freeswitch -b v1.10
 ```
 
-## Configuring FreeSWITCH Debian repo (for dependencies)
-Since we are building a FreeSWITCH release let's configure FreeSWITCH Community Release Debian repo.  
-We recommend using [FSGET](/scripts/packaging).  
-
-Replace `<PAT or API token>` with your `SignalWire Personal Access Token (PAT)`  
-[HOWTO Create a SignalWire Personal Access Token](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/how-to-create-a-personal-access-token/how-to-create-a-personal-access-token)
-```bash
-curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token>
-```
-
+---
 ## Building packages with `FSDEB`
 ```bash
 curl -sSL https://freeswitch.org/fsdeb | bash -s -- -b 999 -o /usr/src/fsdebs/ -w /usr/src/freeswitch

scripts/packaging/build/dependencies/README.md

@@ -0,0 +1,61 @@
+# FreeSWITCH Build Dependencies
+
+This directory is organized into subfolders, where each subfolder contains build instructions for a single Debian package. These packages are dependencies required to build FreeSWITCH's Debian packages.
+
+## Recommended order of building:
+
+- [libbroadvoice](libbroadvoice/README.md)
+- [libilbc](libilbc/README.md)
+- [libsilk](libsilk/README.md)
+- [spandsp](spandsp/README.md)
+- [sofia-sip](sofia-sip/README.md)
+- [libks](libks/README.md)
+- [signalwire-c](signalwire-c/README.md)
+- [libv8](libv8/README.md) (only for `AMD64`)
+
+## Build Dependencies Script
+
+A convenient script `build-dependencies.sh` is provided to automate the building of dependencies. This script offers several options to customize the build process.
+
+### Usage
+
+```bash
+./build-dependencies.sh [options] [library_names...]
+```
+
+### Options
+
+- `-h, --help`: Show the help message
+- `-b, --build-number N`: Set build number (default: 42 or env value)
+- `-a, --all`: Build all libraries
+- `-s, --setup`: Set up build environment before building
+- `-o, --output DIR`: Set output directory (default: /var/local/deb)
+- `-p, --prefix DIR`: Set source path prefix (default: /usr/src)
+- `-r, --repo`: Set up local repository after building
+- `-c, --clone`: Clone required repositories before building
+- `-g, --git-https`: Use HTTPS instead of SSH for git cloning
+
+### Examples
+
+Set up environment, clone repositories, and build all dependencies:
+```bash
+./build-dependencies.sh --build-number 123 --setup --all --repo --clone
+```
+
+Complete build with all options (setup environment, build all libraries, create local repo, clone repos with HTTPS):
+```bash
+./build-dependencies.sh --build-number 123 --setup --all --repo --clone --git-https
+```
+
+Build specific libraries with full automation:
+```bash
+./build-dependencies.sh --build-number 123 --setup --repo --clone --git-https libks signalwire-c
+```
+
+### Running in Docker
+
+You can run the build script inside a Docker container for a clean, isolated build environment:
+
+```bash
+docker run -it -v $(pwd):/root/scripts debian:bookworm bash -c "cd /root/scripts && bash"
+```