Skip to content

docs: Add build-essential to Prerequisites (#1595)#1691

Merged
josecelano merged 1 commit intotorrust:developfrom
josecelano:docs/1595-add-build-essential-requirement
Apr 16, 2026
Merged

docs: Add build-essential to Prerequisites (#1595)#1691
josecelano merged 1 commit intotorrust:developfrom
josecelano:docs/1595-add-build-essential-requirement

Conversation

@josecelano
Copy link
Copy Markdown
Member

Description

Resolves #1595

Changes

Added build-essential package to the Prerequisites section of the documentation. This package is required to provide the C compiler (cc) which is essential for compiling Rust code and its dependencies.

Why

When building on a fresh Ubuntu 24 machine, users encountered the error:

error: linker `cc` not found

This error occurs because build-essential (which includes the C compiler) was not installed. The documentation did not mention this requirement, so users had to discover it through trial and error.

What Changed

  • Added a new prerequisite step to install build-essential before other dependencies
  • This ensures users have the necessary build tools before attempting to compile the project

Documentation

The change is reflected in the Rust documentation under the "Prerequisites" section which is published to docs.rs.

@josecelano josecelano self-assigned this Apr 16, 2026
@josecelano josecelano added the Documentation Improves Instructions, Guides, and Notices label Apr 16, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 16, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.50%. Comparing base (ef5be41) to head (92929ba).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #1691   +/-   ##
========================================
  Coverage    86.50%   86.50%           
========================================
  Files          288      288           
  Lines        22672    22672           
  Branches     22672    22672           
========================================
  Hits         19613    19613           
  Misses        2833     2833           
  Partials       226      226           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

josecelano added a commit to josecelano/torrust-tracker that referenced this pull request Apr 16, 2026
…st#1595)

8b7fa32 docs(torrust#1595): Add build-essential to Prerequisites (Jose Celano)

Pull request description:

  ## Description

  Resolves torrust#1595

  ### Changes

  Added `build-essential` package to the Prerequisites section of the documentation. This package is required to provide the C compiler (`cc`) which is essential for compiling Rust code and its dependencies.

  ### Why

  When building on a fresh Ubuntu 24 machine, users encountered the error:
  ```
  error: linker `cc` not found
  ```

  This error occurs because `build-essential` (which includes the C compiler) was not installed. The documentation did not mention this requirement, so users had to discover it through trial and error.

  ### What Changed

  - Added a new prerequisite step to install `build-essential` before other dependencies
  - This ensures users have the necessary build tools before attempting to compile the project

  ### Documentation

  The change is reflected in the Rust documentation under the "Prerequisites" section which is published to [docs.rs](https://docs.rs/torrust-tracker/latest/torrust_tracker/#prerequisites).

ACKs for top commit:
  josecelano:
    ACK 8b7fa32

Tree-SHA512: 8c0605623a8d92b1208252a41d5b9a4df5cdfafb7f3efaeb9658aed3958c0a34538298f2f4908a7efd4858d830ab0d6760f6d63a9bafe0ccad3cef5646a20d6b
@josecelano josecelano requested a review from a team as a code owner April 16, 2026 18:07
The build-essential package is required to provide the C compiler (cc)
needed for compilation. This was missing from the prerequisites documentation.

Closes torrust#1595
@josecelano josecelano force-pushed the docs/1595-add-build-essential-requirement branch from 3eddacc to 92929ba Compare April 16, 2026 18:09
@josecelano
Copy link
Copy Markdown
Member Author

ACK 92929ba

@josecelano josecelano merged commit d178b2b into torrust:develop Apr 16, 2026
44 of 47 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improves Instructions, Guides, and Notices

Projects

None yet

Development

Successfully merging this pull request may close these issues.

error: linker cc not found

1 participant