aa0e429576
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
libc Documentation ================== The libc documentation is written using the Sphinx documentation generator. It is currently tested with Sphinx 1.1.3. To build the documents into html configure libc with the following cmake options: * -DLLVM_ENABLE_SPHINX=ON * -DLIBC_INCLUDE_DOCS=ON After configuring libc with these options the make rule `docs-libc-html` should be available.