annotate docs/makefile @ 5671:8c5f2c37b911

strip: remove experimental.prunestrip option

marmoute decided to drop it because it's "neither documented nor a good idea".

This extensions was assemble to deal with Facebook willingness to check `hg
strip` semantic for its user. Changing `hg strip` semantic is overall a pretty
bad idea, because `stripping` is a specific operation, that is problematic in
distributed version control but have a narrow set of valid usecase (eg:
maintenance). Diverting user away from `prune` in favor of a modified `strip` is
a bad idea, because it mask the legitimate `strip` usage and introduce confusion
in user heads, The verb is not appropriate and the behavior of `prunestrip` does
not match the one of vanillia `strip`.

Facebook is no longer using this, and the lack of documentation is a good hint
that nobody else is. So lets drop it.

SPHINXBUILD ?= python3 -m sphinx -b html

.PHONY: all
all: tutorials/tutorial.rst tutorials/topic-tutorial.rst static/logo-evolve.ico
	$(SPHINXBUILD) . ../html/

tutorials/tutorial.rst: tutorials/tutorial.t test2rst.py
	python3 test2rst.py $<

tutorials/topic-tutorial.rst: tutorials/topic-tutorial.t test2rst.py
	python3 test2rst.py $<

static/logo-evolve.ico: static/logo-evolve.svg
	convert -resize 36x36 $< $@

.PHONY: clean
clean:
	rm -rf ../html
	rm -f static/logo-evolve.ico
	rm -f tutorials/tutorial.rst
	rm -f tutorials/topic-tutorial.rst