diff options
author | theiw <none@none> | 2010-03-04 13:00:14 +0000 |
---|---|---|
committer | theiw <none@none> | 2010-03-04 13:00:14 +0000 |
commit | a88d70c627ad038a6ffc227a103bb0e0c1579add (patch) | |
tree | 59cd6e977a716449c96aeb090fd86017fbec77b6 | |
parent | 623200ec17c23973e137f2169a48d6837dd57a3c (diff) |
Include EDoc generation support
-rw-r--r-- | src/rebar_edoc.erl | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/src/rebar_edoc.erl b/src/rebar_edoc.erl new file mode 100644 index 0000000..ed7c226 --- /dev/null +++ b/src/rebar_edoc.erl @@ -0,0 +1,62 @@ +%% -*- tab-width: 4;erlang-indent-level: 4;indent-tabs-mode: nil -*- +%% ex: ts=4 sw=4 et +%% ------------------------------------------------------------------- +%% +%% rebar: Erlang Build Tools +%% +%% Copyright (c) 2010 Dave Smith (dizzyd@dizzyd.com) +%% +%% Permission is hereby granted, free of charge, to any person obtaining a copy +%% of this software and associated documentation files (the "Software"), to deal +%% in the Software without restriction, including without limitation the rights +%% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +%% copies of the Software, and to permit persons to whom the Software is +%% furnished to do so, subject to the following conditions: +%% +%% The above copyright notice and this permission notice shall be included in +%% all copies or substantial portions of the Software. +%% +%% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +%% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +%% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +%% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +%% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +%% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +%% THE SOFTWARE. +%% ------------------------------------------------------------------- +%% @author Dave Smith <dizzyd@dizzyd.com> +%% @doc rebar_edoc supports the following command: +%% <ul> +%% <li>doc (essentially erl -noshell -run edoc_run application "'$(<app_name>)'" +%% '"."' '[<options>]')</li> +%% <li>clean</li> +%% </ul> +%% EDoc options can be given in the <code>edoc_opts</code> option in <code>rebar.config</code>. +%% @copyright 2010 Dave Smith +%% ------------------------------------------------------------------- +-module(rebar_edoc). + +-export([doc/2, clean/2]). + +-include("rebar.hrl"). + +%% =================================================================== +%% Public API +%% =================================================================== + +%% @doc Generate Erlang program documentation. +%% @spec doc(#config{}, string()) -> ok +-spec(doc(Config::#config{}, File::string()) -> ok). +doc(Config, File) -> + {ok, AppName, _AppData} = rebar_app_utils:load_app_file(File), + EDocOpts = rebar_config:get(Config, edoc_opts, []), + ok = edoc:application(AppName, ".", EDocOpts), + ok. + +%% @doc Remove the generated Erlang program documentation. +%% @spec clean(#config{}, string()) -> ok +-spec(clean(Config::#config{}, File::string()) -> ok). +clean(Config, _File) -> + EDocOpts = rebar_config:get(Config, edoc_opts, []), + DocDir = proplists:get_value(dir, EDocOpts, "doc"), + rebar_file_utils:rm_rf(DocDir). |