[all-commits] [llvm/llvm-project] aa0e42: [libc] Rewrite "Full Host Build" instructions (#18...

[Jeff Bailey via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: aa0e429576cfb496e66f6bbe76df8982aab6b083
      https://github.com/llvm/llvm-project/commit/aa0e429576cfb496e66f6bbe76df8982aab6b083
  Author: Jeff Bailey <jbailey at raspberryginger.com>
  Date:   2026-02-12 (Thu, 12 Feb 2026)

  Changed paths:
    M libc/docs/full_host_build.rst

  Log Message:
  -----------
  [libc] Rewrite "Full Host Build" instructions (#180439)

This commit restructures the full_host_build.rst documentation to better
serve two use cases:

1. Standard Building and Testing: Add a new introductory section with
simplified instructions for local development. This covers basic build
configuration, building/testing without a full sysroot, and
documentation generation.

2. Building a Sysroot: Reorganize the comprehensive sysroot setup
instructions into a clear 5-step guide:
   - Step 1: Preparation (environment variables)
   - Step 2: Linux Headers (copying headers into sysroot)
- Step 3: Build and Install Runtimes (cmake configuration and ninja
build)
   - Step 4: Configure the Compiler Wrapper (creating clang config file)
   - Step 5: Verification (testing with sample C program)

Key improvements:
- Restructure content to lead with simpler development workflow
- Replace bootstrapping build instructions with clearer sysroot
instructions
- Fix typo: "non-triivial" -> "non-trivial"
- Remove directory changes that can be confusing. All commands are run
from the root of the llvm tree
- Improve code block formatting and add complete working examples
- Make it easy to cut and paste shell commands
- Simplify "Hello, World!" example
- Simplify and clarify assumptions and requirements
- Remove obsolete notes about C++ standard library support

Tested:
 * Built runtimes build and tests
 * Built sysroot and verified with sample C program
 * Verified document builds and looks right in VSCode browser



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications