#!/usr/bin/env sh # Builds documentation for all target triples that we have a registered URL for # in liblibc. This scrapes the list of triples to document from `src/lib.rs` # which has a bunch of `html_root_url` directives we pick up. set -ex TARGET_DOC_DIR=target/doc README=README.md PLATFORM_SUPPORT=platform-support.md rm -rf $TARGET_DOC_DIR mkdir -p $TARGET_DOC_DIR if ! rustc --version | grep -E "nightly" ; then echo "Building the documentation requires a nightly Rust toolchain" exit 1 fi rustup component add rust-src cargo +nightly install cargo-xbuild -Z install-upgrade # List all targets that do currently build successfully: # shellcheck disable=SC1003 grep '[\d|\w|-]* \\' ci/build.sh > targets sed -i.bak 's/ \\//g' targets grep '^[_a-zA-Z0-9-]*$' targets > tmp && mv tmp targets # Create a markdown list of supported platforms in $PLATFORM_SUPPORT rm $PLATFORM_SUPPORT || true printf '### Platform-specific documentation\n' >> $PLATFORM_SUPPORT while read -r target; do echo "documenting ${target}" case "${target}" in *apple*) # FIXME: # We can't build docs of apple targets from Linux yet. continue ;; *) ;; esac rustup target add "${target}" || true # Enable extra configuration flags: export RUSTDOCFLAGS="--cfg freebsd11" # If cargo doc fails, then try xargo: if ! cargo doc --target "${target}" \ --no-default-features --features extra_traits ; then cargo xdoc --target "${target}" \ --no-default-features --features extra_traits fi cp -r "target/${target}/doc" "${TARGET_DOC_DIR}/${target}" echo "* [${target}](${target}/libc/index.html)" >> $PLATFORM_SUPPORT done < targets # Replace
with the contents of $PLATFORM_SUPPORT cp $README $TARGET_DOC_DIR line=$(grep -n '' $README | cut -d ":" -f 1) set +x { head -n "$((line-1))" $README; cat $PLATFORM_SUPPORT; tail -n "+$((line+1))" $README; } > $TARGET_DOC_DIR/$README set -x # Copy the licenses cp LICENSE-* $TARGET_DOC_DIR/