summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authortheiw <none@none>2010-03-04 13:00:14 +0000
committertheiw <none@none>2010-03-04 13:00:14 +0000
commita88d70c627ad038a6ffc227a103bb0e0c1579add (patch)
tree59cd6e977a716449c96aeb090fd86017fbec77b6 /src
parent623200ec17c23973e137f2169a48d6837dd57a3c (diff)
Include EDoc generation support
Diffstat (limited to 'src')
-rw-r--r--src/rebar_edoc.erl62
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 "'$(&lt;app_name&gt;)'"
+%% '"."' '[&lt;options&gt;]')</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).