File: edoc_doclet.html

package info (click to toggle)
erlang-doc-html 1%3A11.b.2-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 23,284 kB
  • ctags: 10,724
  • sloc: erlang: 505; ansic: 323; makefile: 62; perl: 61; sh: 45
file content (94 lines) | stat: -rw-r--r-- 4,181 bytes parent folder | download
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
83
84
85
86
87
88
89
90
91
92
93
94
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Module edoc_doclet</title>
<link rel="stylesheet" type="text/css" href="stylesheet.css">
</head>
<body bgcolor="white">

<h1>Module edoc_doclet</h1>
Standard doclet module for EDoc.
<p>Copyright  2003 Richard Carlsson</p>
<ul><li><a href="#description">Description</a></li><li><a href="#types">Data Types</a></li><li><a href="#index">Function Index</a></li><li><a href="#functions">Function Details</a></li></ul>
<p><b>Authors:</b> Richard Carlsson (<a href="mailto:richardc@csd.uu.se"><tt>richardc@csd.uu.se</tt></a>).</p>
<p><b>See also:</b> <a href="edoc.html">edoc</a>.</p>

<h2><a name="description">Description</a></h2>Standard doclet module for EDoc.
<h2><a name="types">Data Types</a></h2>

<h3><a name="type-doclet_gen">doclet_gen()</a></h3>
<p><tt>doclet_gen() = #doclet_gen{sources = [string()], app = <a href="#type-no_app">no_app()</a> | atom(), packages = [atom()], modules = [atom()], modules = [atom()], filemap = function()}</tt></p>


<h3><a name="type-doclet_toc">doclet_toc()</a></h3>
<p><tt>doclet_toc() = #doclet_gen{paths = [string()], indir = string()}</tt></p>


<h3><a name="type-edoc_context">edoc_context()</a></h3>
<p><tt>edoc_context() = #context{dir = string(), env = <a href="edoc_lib.html#type-edoc_env">edoc_lib:edoc_env()</a>, opts = [term()]}</tt></p>


<h3><a name="type-no_app">no_app()</a></h3>
<p><b>abstract datatype</b>: <tt>no_app()</tt></p>
<p>A value used to mark absence of an Erlang application
     context. Use the macro <code>NO_APP</code> defined in
     <a href="../include/edoc_doclet.hrl"><code>edoc_doclet.hrl</code></a>
     to produce this value.</p>

<h2><a name="index">Function Index</a></h2>
<table width="100%" border="1"><tr><td valign="top"><a href="#run-2">run/2</a></td><td>Main doclet entry point.</td></tr>
</table>

<h2><a name="functions">Function Details</a></h2>

<h3><a name="run-2">run/2</a></h3>
<p><tt>run(Command::<a href="#type-doclet_gen">doclet_gen()</a> | <a href="#type-doclet_toc">doclet_toc()</a>, Ctxt::<a href="#type-edoc_context">edoc_context()</a>) -&gt; ok</tt></p>
<p><p>Main doclet entry point. See the file <a href="../include/edoc_doclet.hrl"><code>edoc_doclet.hrl</code></a> for the data  
structures used for passing parameters.</p>
 
  <p>Also see <a href="edoc.html#layout-2"><code>edoc:layout/2</code></a> for layout-related options, and
  <a href="edoc.html#get_doc-2"><code>edoc:get_doc/2</code></a> for options related to reading source  
files.</p>
 
  Options:
  <dl>
   <dt><code>{file_suffix, string()}</code>
   </dt>
   <dd>Specifies the suffix used for output files. The default value is
       <code>".html"</code>.
   </dd>
   <dt><code>{hidden, bool()}</code>
   </dt>
   <dd>If the value is <code>true</code>, documentation of hidden modules and
       functions will also be included. The default value is <code>false</code>.
   </dd>
   <dt><code>{overview, <a href="edoc.html#type-filename">edoc:filename()</a>}</code>
   </dt>
   <dd>Specifies the name of the overview-file. By default, this doclet
       looks for a file <code>"overview.edoc"</code> in the target directory.
   </dd>
   <dt><code>{private, bool()}</code>
   </dt>
   <dd>If the value is <code>true</code>, documentation of private modules and
       functions will also be included. The default value is <code>false</code>.
   </dd>
   <dt><code>{stylesheet, string()}</code>
   </dt>
   <dd>Specifies the URI used for referencing the stylesheet. The
       default value is <code>"stylesheet.css"</code>. If an empty string is
       specified, no stylesheet reference will be generated.
   </dd>
   <dt><code>{stylesheet_file, <a href="edoc.html#type-filename">edoc:filename()</a>}</code>
   </dt>
   <dd>Specifies the name of the stylesheet file. By default, this
       doclet uses the file <code>"stylesheet.css"</code> in the <code>priv</code>
       subdirectory of the EDoc installation directory. The named file
       will be copied to the target directory.
   </dd>
   <dt><code>{title, string()}</code>
   </dt>
   <dd>Specifies the title of the overview-page.
   </dd>
  </dl></p>
</body>
</html>