From 8ca1c344d528d0e8f2c5c351f9e091a77e582677 Mon Sep 17 00:00:00 2001 From: Corey Richardson Date: Sat, 28 Dec 2013 13:06:05 -0500 Subject: [PATCH 1/3] Add docs for more crates --- mk/docs.mk | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/mk/docs.mk b/mk/docs.mk index 1e6cd063b85..f11bb084726 100644 --- a/mk/docs.mk +++ b/mk/docs.mk @@ -234,6 +234,10 @@ endef $(eval $(call libdoc,std,$(STDLIB_CRATE),$(CFG_BUILD))) $(eval $(call libdoc,extra,$(EXTRALIB_CRATE),$(CFG_BUILD))) +$(eval $(call libdoc,native,$(LIBNATIVE_CRATE),$(CFG_BUILD))) +$(eval $(call libdoc,green,$(LIBGREEN_CRATE),$(CFG_BUILD))) +$(eval $(call libdoc,rustc,$(COMPILER_CRATE),$(CFG_BUILD))) +$(eval $(call libdoc,syntax,$(LIBSYNTAX_CRATE),$(CFG_BUILD))) ifdef CFG_DISABLE_DOCS From e53e86a3f35a7d36308c758d67238c2cdc927ed3 Mon Sep 17 00:00:00 2001 From: Corey Richardson Date: Sun, 29 Dec 2013 00:13:19 -0500 Subject: [PATCH 2/3] Add a compiler-docs target --- mk/docs.mk | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/mk/docs.mk b/mk/docs.mk index f11bb084726..add5f8c07ed 100644 --- a/mk/docs.mk +++ b/mk/docs.mk @@ -13,6 +13,7 @@ ###################################################################### DOCS := +CDOCS := DOCS_L10N := BASE_DOC_OPTS := --from=markdown --standalone --toc --number-sections @@ -232,12 +233,21 @@ doc/$(1)/index.html: $$(RUSTDOC) $$(TLIB2_T_$(3)_H_$(3))/$(CFG_STDLIB_$(3)) DOCS += doc/$(1)/index.html endef +define compiledoc +doc/$(1)/index.html: $$(RUSTDOC) $$(TLIB2_T_$(3)_H_$(3))/$(CFG_STDLIB_$(3)) + @$$(call E, rustdoc: $$@) + $(Q)$(RUSTDOC) --cfg stage2 $(2) + +CDOCS += doc/$(1)/index.html +endef + $(eval $(call libdoc,std,$(STDLIB_CRATE),$(CFG_BUILD))) $(eval $(call libdoc,extra,$(EXTRALIB_CRATE),$(CFG_BUILD))) $(eval $(call libdoc,native,$(LIBNATIVE_CRATE),$(CFG_BUILD))) $(eval $(call libdoc,green,$(LIBGREEN_CRATE),$(CFG_BUILD))) -$(eval $(call libdoc,rustc,$(COMPILER_CRATE),$(CFG_BUILD))) -$(eval $(call libdoc,syntax,$(LIBSYNTAX_CRATE),$(CFG_BUILD))) + +$(eval $(call compiledoc,rustc,$(COMPILER_CRATE),$(CFG_BUILD))) +$(eval $(call compiledoc,syntax,$(LIBSYNTAX_CRATE),$(CFG_BUILD))) ifdef CFG_DISABLE_DOCS @@ -260,6 +270,7 @@ doc/version_info.html: version_info.html.template $(MKFILE_DEPS) \ GENERATED += doc/version.md doc/version_info.html docs: $(DOCS) +compiler-docs: $(CDOCS) docs-l10n: $(DOCS_L10N) From 7b382e58b1b2cbacf8d70fa4bb759db5050a2e8a Mon Sep 17 00:00:00 2001 From: Corey Richardson Date: Sun, 29 Dec 2013 00:13:29 -0500 Subject: [PATCH 3/3] Fix rustdoc bug involving PatLit --- src/librustdoc/clean.rs | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/src/librustdoc/clean.rs b/src/librustdoc/clean.rs index 7d80cea23c1..bd5103d767c 100644 --- a/src/librustdoc/clean.rs +++ b/src/librustdoc/clean.rs @@ -1123,6 +1123,8 @@ fn lit_to_str(lit: &ast::lit) -> ~str { fn name_from_pat(p: &ast::Pat) -> ~str { use syntax::ast::*; + debug!("Trying to get a name from pattern: {:?}", p); + match p.node { PatWild => ~"_", PatWildMulti => ~"..", @@ -1134,9 +1136,12 @@ fn name_from_pat(p: &ast::Pat) -> ~str { PatBox(p) => name_from_pat(p), PatUniq(p) => name_from_pat(p), PatRegion(p) => name_from_pat(p), - PatLit(..) => fail!("tried to get argument name from pat_lit, \ - which is not allowed in function arguments"), - PatRange(..) => fail!("tried to get argument name from pat_range, \ + PatLit(..) => { + warn!("tried to get argument name from PatLit, \ + which is silly in function arguments"); + ~"()" + }, + PatRange(..) => fail!("tried to get argument name from PatRange, \ which is not allowed in function arguments"), PatVec(..) => fail!("tried to get argument name from pat_vec, \ which is not allowed in function arguments")