mirror of
https://github.com/rust-lang/rust.git
synced 2024-11-29 18:23:49 +00:00
16a6ebd1f6
This pulls all of our long-form documentation into a single document, nicknamed "the book" and formally titled "The Rust Programming Language." A few things motivated this change: * People knew of The Guide, but not the individual Guides. This merges them together, helping discoverability. * You can get all of Rust's longform documentation in one place, which is nice. * We now have rustbook in-tree, which can generate this kind of documentation. While its style is basic, the general idea is much better: a table of contents on the left-hand side. * Rather than a almost 10,000-line guide.md, there are now smaller files per section.
153 lines
6.0 KiB
Makefile
153 lines
6.0 KiB
Makefile
# Copyright 2014 The Rust Project Developers. See the COPYRIGHT
|
|
# file at the top-level directory of this distribution and at
|
|
# http://rust-lang.org/COPYRIGHT.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
# http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
# <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
# option. This file may not be copied, modified, or distributed
|
|
# except according to those terms.
|
|
|
|
################################################################################
|
|
# Rust's standard distribution of crates and tools
|
|
#
|
|
# The crates outlined below are the standard distribution of libraries provided
|
|
# in a rust installation. These rules are meant to abstract over the
|
|
# dependencies (both native and rust) of crates and basically generate all the
|
|
# necessary makefile rules necessary to build everything.
|
|
#
|
|
# Here's an explanation of the variables below
|
|
#
|
|
# TARGET_CRATES
|
|
# This list of crates will be built for all targets, including
|
|
# cross-compiled targets
|
|
#
|
|
# HOST_CRATES
|
|
# This list of crates will be compiled for only host targets. Note that
|
|
# this set is explicitly *not* a subset of TARGET_CRATES, but rather it is
|
|
# a disjoint set. Nothing in the TARGET_CRATES set can depend on crates in
|
|
# the HOST_CRATES set, but the HOST_CRATES set can depend on target
|
|
# crates.
|
|
#
|
|
# TOOLS
|
|
# A list of all tools which will be built as part of the compilation
|
|
# process. It is currently assumed that most tools are built through
|
|
# src/driver/driver.rs with a particular configuration (there's a
|
|
# corresponding library providing the implementation)
|
|
#
|
|
# DEPS_<crate>
|
|
# These lists are the dependencies of the <crate> that is to be built.
|
|
# Rust dependencies are listed bare (i.e. std) and native
|
|
# dependencies have a "native:" prefix (i.e. native:hoedown). All deps
|
|
# will be built before the crate itself is built.
|
|
#
|
|
# TOOL_DEPS_<tool>/TOOL_SOURCE_<tool>
|
|
# Similar to the DEPS variable, this is the library crate dependencies
|
|
# list for tool as well as the source file for the specified tool
|
|
#
|
|
# You shouldn't need to modify much other than these variables. Crates are
|
|
# automatically generated for all stage/host/target combinations.
|
|
################################################################################
|
|
|
|
TARGET_CRATES := libc std flate arena term \
|
|
serialize getopts collections test rand \
|
|
log regex graphviz core rbml alloc \
|
|
unicode
|
|
RUSTC_CRATES := rustc rustc_typeck rustc_borrowck rustc_resolve rustc_driver \
|
|
rustc_trans rustc_back rustc_llvm
|
|
HOST_CRATES := syntax $(RUSTC_CRATES) rustdoc fmt_macros
|
|
CRATES := $(TARGET_CRATES) $(HOST_CRATES)
|
|
TOOLS := compiletest rustdoc rustc rustbook
|
|
|
|
DEPS_core :=
|
|
DEPS_libc := core
|
|
DEPS_unicode := core
|
|
DEPS_alloc := core libc native:jemalloc
|
|
DEPS_std := core libc rand alloc collections unicode \
|
|
native:rust_builtin native:backtrace native:rustrt_native
|
|
DEPS_graphviz := std
|
|
DEPS_syntax := std term serialize log fmt_macros arena libc
|
|
DEPS_rustc_driver := arena flate getopts graphviz libc rustc rustc_back rustc_borrowck \
|
|
rustc_typeck rustc_resolve log syntax serialize rustc_llvm rustc_trans
|
|
DEPS_rustc_trans := arena flate getopts graphviz libc rustc rustc_back \
|
|
log syntax serialize rustc_llvm
|
|
DEPS_rustc_typeck := rustc syntax
|
|
DEPS_rustc_borrowck := rustc log graphviz syntax
|
|
DEPS_rustc_resolve := rustc log syntax
|
|
DEPS_rustc := syntax flate arena serialize getopts rbml \
|
|
log graphviz rustc_llvm rustc_back
|
|
DEPS_rustc_llvm := native:rustllvm libc std
|
|
DEPS_rustc_back := std syntax rustc_llvm flate log libc
|
|
DEPS_rustdoc := rustc rustc_driver native:hoedown serialize getopts \
|
|
test
|
|
DEPS_flate := std native:miniz
|
|
DEPS_arena := std
|
|
DEPS_graphviz := std
|
|
DEPS_glob := std
|
|
DEPS_serialize := std log
|
|
DEPS_rbml := std log serialize
|
|
DEPS_term := std log
|
|
DEPS_getopts := std
|
|
DEPS_collections := core alloc unicode
|
|
DEPS_num := std
|
|
DEPS_test := std getopts serialize rbml term regex native:rust_test_helpers
|
|
DEPS_rand := core
|
|
DEPS_log := std regex
|
|
DEPS_regex := std
|
|
DEPS_fmt_macros = std
|
|
|
|
TOOL_DEPS_compiletest := test getopts
|
|
TOOL_DEPS_rustdoc := rustdoc
|
|
TOOL_DEPS_rustc := rustc_driver
|
|
TOOL_DEPS_rustbook := std regex rustdoc
|
|
TOOL_SOURCE_compiletest := $(S)src/compiletest/compiletest.rs
|
|
TOOL_SOURCE_rustdoc := $(S)src/driver/driver.rs
|
|
TOOL_SOURCE_rustc := $(S)src/driver/driver.rs
|
|
TOOL_SOURCE_rustbook := $(S)src/rustbook/main.rs
|
|
|
|
ONLY_RLIB_core := 1
|
|
ONLY_RLIB_libc := 1
|
|
ONLY_RLIB_alloc := 1
|
|
ONLY_RLIB_rand := 1
|
|
ONLY_RLIB_collections := 1
|
|
ONLY_RLIB_unicode := 1
|
|
|
|
################################################################################
|
|
# You should not need to edit below this line
|
|
################################################################################
|
|
|
|
DOC_CRATES := $(filter-out rustc, \
|
|
$(filter-out rustc_trans, \
|
|
$(filter-out rustc_typeck, \
|
|
$(filter-out rustc_borrowck, \
|
|
$(filter-out rustc_resolve, \
|
|
$(filter-out rustc_driver, \
|
|
$(filter-out log, \
|
|
$(filter-out regex, \
|
|
$(filter-out getopts, \
|
|
$(filter-out syntax, $(CRATES)))))))))))
|
|
COMPILER_DOC_CRATES := rustc rustc_trans rustc_borrowck rustc_resolve \
|
|
rustc_typeck rustc_driver syntax
|
|
|
|
# This macro creates some simple definitions for each crate being built, just
|
|
# some munging of all of the parameters above.
|
|
#
|
|
# $(1) is the crate to generate variables for
|
|
define RUST_CRATE
|
|
CRATEFILE_$(1) := $$(S)src/lib$(1)/lib.rs
|
|
RSINPUTS_$(1) := $$(call rwildcard,$(S)src/lib$(1)/,*.rs)
|
|
RUST_DEPS_$(1) := $$(filter-out native:%,$$(DEPS_$(1)))
|
|
NATIVE_DEPS_$(1) := $$(patsubst native:%,%,$$(filter native:%,$$(DEPS_$(1))))
|
|
endef
|
|
|
|
$(foreach crate,$(CRATES),$(eval $(call RUST_CRATE,$(crate))))
|
|
|
|
# Similar to the macro above for crates, this macro is for tools
|
|
#
|
|
# $(1) is the crate to generate variables for
|
|
define RUST_TOOL
|
|
TOOL_INPUTS_$(1) := $$(call rwildcard,$$(dir $$(TOOL_SOURCE_$(1))),*.rs)
|
|
endef
|
|
|
|
$(foreach crate,$(TOOLS),$(eval $(call RUST_TOOL,$(crate))))
|