summaryrefslogtreecommitdiff
path: root/deps/edown/doc/edown_make.md
blob: 09f30f40612117e6303a537456c8191ff8c17c82 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82


# Module edown_make #
* [Function Index](#index)
* [Function Details](#functions)


<a name="index"></a>

## Function Index ##


<table width="100%" border="1" cellspacing="0" cellpadding="2" summary="function index"><tr><td valign="top"><a href="#from_script-1">from_script/1</a></td><td>Reads ConfigFile and calls <a href="edoc.md#application-3"><code>edoc:application/3</code></a></td></tr><tr><td valign="top"><a href="#main-1">main/1</a></td><td>Escript entry point for building edown (or edoc) documentation.</td></tr></table>


<a name="functions"></a>

## Function Details ##

<a name="from_script-1"></a>

### from_script/1 ###


<pre><code>
from_script(Config::ConfigFile) -&gt; ok | {error, Reason}
</code></pre>
<br />


Reads ConfigFile and calls [`edoc:application/3`](edoc.md#application-3)



The ConfigFile will be read using [`file:script/1`](file.md#script-1), and should return
`{App, Dir, Options}`, as required by [`edoc:application/3`](edoc.md#application-3).


This function does not manage dependencies. It is simply a wrapper around
[`edoc:application/3`](edoc.md#application-3).
<a name="main-1"></a>

### main/1 ###


<pre><code>
main(Args::[Config]) -&gt; no_return()
</code></pre>
<br />


Escript entry point for building edown (or edoc) documentation



Usage: edown_make -config ConfigFile [-pa P] [-pz P]



Calls [from_script(ConfigFile)](#from_script-1) and then terminates,
with a normal or non-normal exit code, depending on the outcome.



Make sure `$EDOWN/edown_make` is runnable, and in the command path, and
that the edown BEAM files are in the Erlang path (e.g. using $ERL_LIBS).
The `edown_make` escript also accepts `-pa P` and/or `-pz P` flags as a
means of locating the edown byte code.



Note, however, that the function `edoc_make:main/1` only expects the
config file as an input argument, corresponding to



`escript edoc_make.beam ConfigFile`


(The reason for this is that if the beam file can be passed directly to
the escript command, setting the path should also be doable that way).