umgeher/cowboy
0
Fork 0
mirror of https://github.com/ninenines/cowboy.git synced 2025-07-14 12:20:24 +00:00
Code Issues Wiki Activity

Convert the documentation to Asciidoc

Browse source 
A few small revisions were made, and Erlang.mk has been updated.
This commit is contained in:
Loïc Hoguin 2016-01-14 13:35:25 +01:00
parent b7d666cfc7
commit 4023e7f4e4
55 changed files with 5701 additions and 1889 deletions
Download patch file Download diff file Expand all files Collapse all files

52
Makefile
View file

@ -45,55 +45,3 @@ app:: rebar.config
ci-setup:: clean deps test-deps
$(gen_verbose) cp ~/.kerl/builds/$(CI_OTP_RELEASE)/otp_src_git/lib/ssl/test/erl_make_certs.erl deps/ct_helper/src/
# Documentation.
dep_ezdoc = git https://github.com/ninenines/ezdoc master
$(eval $(call dep_target,ezdoc))
build-doc-deps: $(DEPS_DIR)/ezdoc
$(MAKE) -C $(DEPS_DIR)/ezdoc
define ezdoc_script
io:format("Building manual~n"),
[begin
AST = ezdoc:parse_file(F),
BF = filename:rootname(filename:basename(F)),
io:format(" ~s~n", [BF]),
file:write_file("doc/markdown/manual/" ++ BF ++ ".md", ezdoc_markdown:export(AST)),
case BF of
"cowboy" ++ _ when BF =/= "cowboy_app" ->
file:write_file("doc/man3/" ++ BF ++ ".3", ezdoc_man:export(3, AST));
_ when BF =/= "index" ->
file:write_file("doc/man7/" ++ BF ++ ".7", ezdoc_man:export(7, AST));
_ ->
ok
end
end || F <- filelib:wildcard("doc/src/manual/*.ezdoc")],
io:format("Building guide~n"),
[begin
AST = ezdoc:parse_file(F),
BF = filename:rootname(filename:basename(F)),
io:format(" ~s~n", [BF]),
file:write_file("doc/markdown/guide/" ++ BF ++ ".md", ezdoc_markdown:export(AST))
end || F <- filelib:wildcard("doc/src/guide/*.ezdoc")],
io:format("Done.~n"),
init:stop().
endef
export ezdoc_script
docs:: clean-docs build-doc-deps
@mkdir -p doc/man3 doc/man7 doc/markdown/guide doc/markdown/manual
$(gen_verbose) erl -noinput -pa ebin deps/ezdoc/ebin -eval "$$ezdoc_script"
@gzip doc/man3/*.3 doc/man7/*.7
@cp doc/src/guide/*.png doc/markdown/guide
clean-docs:
$(gen_verbose) rm -rf doc/man3 doc/man7 doc/markdown
MAN_INSTALL_PATH ?= /usr/local/share/man
install-docs:
mkdir -p $(MAN_INSTALL_PATH)/man3/ $(MAN_INSTALL_PATH)/man7/
install -g 0 -o 0 -m 0644 doc/man3/*.gz $(MAN_INSTALL_PATH)/man3/
install -g 0 -o 0 -m 0644 doc/man7/*.gz $(MAN_INSTALL_PATH)/man7/