languages/rust
languages/rust
1
0
Fork 0
mirror of https://github.com/rust-lang/rust synced 2024-09-15 14:40:45 +00:00
Code Issues Packages Projects Releases Wiki Activity
rust/mk/docs.mk

40 lines
1.2 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: $@)
Silence texi2pdf during make
2011-06-27 19:43:19 +00:00
$(Q)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: $@)
$(Q)cp $< $@
Reference in a new issue Copy permalink