nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2024-11-28 01:34:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
39e0009190
rust/mk/docs.mk

44 lines
1.3 KiB
Makefile
Raw Normal View History

Start splitting up Makefile.in
2011-05-01 20:18:52 +00:00
######################################################################
# Doc variables and rules
######################################################################
Add a make docs target
2011-10-27 22:02:32 +00:00
docs: $(DOCS)
Start splitting up Makefile.in
2011-05-01 20:18:52 +00:00
doc/version.texi: $(MKFILES) rust.texi
Fixes to speed and clean up makefiles.
2011-06-25 19:23:27 +00:00
@$(call E, version-stamp: $@)
$(Q)echo "@macro gitversion" >$@
$(Q)echo "$(CFG_VERSION)" >>$@
$(Q)echo "@end macro" >>$@
Start splitting up Makefile.in
2011-05-01 20:18:52 +00:00
doc/%.pdf: %.texi doc/version.texi
Fixes to speed and clean up makefiles.
2011-06-25 19:23:27 +00:00
@$(call E, texi2pdf: $@)
docs: work around texi2dvi bug. (#1134)
2011-11-05 16:32:58 +00:00
@# LC_COLLATE=C works around a bug in texi2dvi; see
@# https://bugzilla.redhat.com/show_bug.cgi?id=583011 and
@# https://github.com/graydon/rust/issues/1134
$(Q)LC_COLLATE=C texi2pdf --silent --batch -I doc -o $@ --clean $<
Start splitting up Makefile.in
2011-05-01 20:18:52 +00:00
doc/%.html: %.texi doc/version.texi
Fixes to speed and clean up makefiles.
2011-06-25 19:23:27 +00:00
@$(call E, makeinfo: $@)
$(Q)makeinfo -I doc --html --ifhtml --force --no-split --output=$@ $<
Start splitting up Makefile.in
2011-05-01 20:18:52 +00:00
docsnap: doc/rust.pdf
Fixes to speed and clean up makefiles.
2011-06-25 19:23:27 +00:00
@$(call E, snap: doc/rust-$(shell date +"%Y-%m-%d")-snap.pdf)
$(Q)mv $< doc/rust-$(shell date +"%Y-%m-%d")-snap.pdf
Begin documenting std and add doc generation using naturaldocs Naturaldocs isn't really that great but it seems easier to get something working than with doxygen, for which we would need to convert rust code to something C++ish. We probably want to just write a rustdoc utility at some point.
2011-10-24 22:25:41 +00:00
Use web-style paragraphs in std docs
2011-10-26 18:55:28 +00:00
doc/std/index.html: nd/std/Languages.txt nd/std/Topics.txt nd/std/std.css \
Begin documenting std and add doc generation using naturaldocs Naturaldocs isn't really that great but it seems easier to get something working than with doxygen, for which we would need to convert rust code to something C++ish. We probably want to just write a rustdoc utility at some point.
2011-10-24 22:25:41 +00:00
$(STDLIB_CRATE) $(STDLIB_INPUTS)
@$(call E, naturaldocs: $@)
Use web-style paragraphs in std docs
2011-10-26 18:55:28 +00:00
naturaldocs -i $(S)src/lib -o HTML doc/std -p nd/std -r -s Default std
Begin documenting std and add doc generation using naturaldocs Naturaldocs isn't really that great but it seems easier to get something working than with doxygen, for which we would need to convert rust code to something C++ish. We probably want to just write a rustdoc utility at some point.
2011-10-24 22:25:41 +00:00
nd/std/Languages.txt: $(S)doc/Languages.txt
@$(call E, cp: $@)
$(Q)cp $< $@
nd/std/Topics.txt: $(S)doc/Topics.txt
@$(call E, cp: $@)
$(Q)cp $< $@
Use web-style paragraphs in std docs
2011-10-26 18:55:28 +00:00
nd/std/std.css: $(S)doc/std.css
@$(call E, cp: $@)
docs: work around texi2dvi bug. (#1134)
2011-11-05 16:32:58 +00:00
$(Q)cp $< $@
Reference in New Issue Copy Permalink