Jeff Bailey aa0e429576
[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
2026-02-12 07:54:34 +00:00
..
2026-01-26 14:48:35 -08:00

LLVM libc
=========

This directory and its subdirectories contain source code for llvm-libc,
a retargetable implementation of the C standard library.

LLVM is open source software. You may freely distribute it under the terms of
the license agreement found in LICENSE.txt.