X-Git-Url: http://nitlanguage.org
diff --git a/src/nitdoc.nit b/src/nitdoc.nit
index 18e1d0c..205caca 100644
--- a/src/nitdoc.nit
+++ b/src/nitdoc.nit
@@ -24,27 +24,27 @@ import abstracttool
# Store knowledge and facilities to generate files
class DocContext
-special AbstractCompiler
+ super AbstractCompiler
# Destination directory
- readable writable attr _dir: String = "."
+ readable writable var _dir: String = "doc"
# Content of a generated file
- attr _stage_context: StageContext = new StageContext(null)
+ var _stage_context: StageContext = new StageContext(null)
# Add a string in the content
- meth add(s: String) do
+ fun add(s: String) do
_stage_context.content.add(s)
_stage_context.validate = true
end
# Add a string in the content iff some other string are added
- meth stage(s: String) do _stage_context.content.add(s)
+ fun stage(s: String) do _stage_context.content.add(s)
# Create a new stage in the content
- meth open_stage do _stage_context = new StageContext(_stage_context)
+ fun open_stage do _stage_context = new StageContext(_stage_context)
# Close the current stage in the content
- meth close_stage
+ fun close_stage
do
var s = _stage_context.parent
if _stage_context.validate then
@@ -56,9 +56,8 @@ special AbstractCompiler
end
# Write the content to a new file
- meth write_to(filename: String)
+ fun write_to(filename: String)
do
- print "Generate {filename}"
var f = new OFStream.open(filename)
for s in _stage_context.content do
f.write(s)
@@ -66,209 +65,330 @@ special AbstractCompiler
f.close
end
- # Currently computed module
- readable attr _module: nullable MMSrcModule
+ # Start a new file
+ fun clear
+ do
+ _stage_context = new StageContext(null)
+ end
- # Is the current directory module computed as a simple modude ?
- readable writable attr _inside_mode: Bool = false
+ # Sorter of entities in alphabetical order
+ var _sorter: AlphaSorter[MMEntity] = new AlphaSorter[MMEntity]
- # Is the current module computed as a intruded one ?
- readable writable attr _intrude_mode: Bool = false
+ # Sort entities in the alphabetical order
+ fun sort(array: Array[MMEntity])
+ do
+ _sorter.sort(array)
+ end
- # Compued introducing entities (for the index)
- attr _entities: Array[MMEntity] = new Array[MMEntity]
+ readable var _opt_dir: OptionString = new OptionString("Directory where doc is generated", "-d", "--dir")
+ readable var _opt_source: OptionString = new OptionString("What link for source (%f for filename, %l for first line, %L for last line)", "--source")
+ readable var _opt_public: OptionBool = new OptionBool("Generate only the public API", "--public")
+ readable var _opt_private: OptionBool = new OptionBool("Generate the private API", "--private")
+ readable var _opt_nodot: OptionBool = new OptionBool("Do not generate graphes with graphviz", "--no-dot")
- # Register an entity (for the index)
- meth register(e: MMEntity)
+ fun public_only: Bool
do
- _entities.add(e)
- if e isa MMSrcModule then
- _module = e
- end
+ if self._opt_public.value == true then return true
+ return false
end
- # Start a new file
- meth clear
+ fun with_private: Bool
do
- _stage_context = new StageContext(null)
+ if self._opt_private.value == true then return true
+ return false
end
- # Generate common files (frames, index, overview)
- meth extract_other_doc
+ # The current processed filename
+ var filename: String
+
+ # The main virtual module
+ var mainmod: nullable MMVirtualModule
+
+ redef fun perform_work(mods)
do
- _module = null
- inside_mode = false
- intrude_mode = false
- clear
- add("\n")
- add("Overview \n")
- add("Index \n")
- var modules = modules.to_a
- sort(modules)
-
- var rootdirs = new Array[MMDirectory]
- for m in modules do
- var md = m.directory
- if md.parent == null and not rootdirs.has(md) then
- rootdirs.add(md)
+ mainmod = new MMVirtualModule(self, mods)
+
+ dir.mkdir
+
+ # Compute the set of direct owned nested modules
+ var owns = new HashMap[MMModule, Array[MMModule]]
+ for mod in modules do
+ owns[mod] = new Array[MMModule]# [mod]
+ end
+ for mod in modules do
+ if mod == mainmod then continue
+ var d = mod.directory
+ loop
+ var o = d.owner
+ if o != null and o != mod then
+ owns[o].add(mod)
+ end
+ var dp = d.parent
+ if dp == null or dp == d then break
+ d = dp
end
end
- var done = new Array[MMModule]
- for root in rootdirs do
- var dirstack = [root]
- var curdir = root
- add("{root.name} \n")
- var indent = " "
- while not dirstack.is_empty do
- var redo = false
- for m in modules do
- if done.has(m) then continue
- var md = m.directory
- if md.owner == m and md.parent == curdir then
- # It's a directory module
- add("{indent}{m} \n")
- curdir = md
- dirstack.push(curdir)
- indent = " " * dirstack.length
- redo = true
- break # restart to preserve alphabetic order
- else if md == curdir then
- if md.owner == m then
- add("{indent}{m} \n")
- else
- add("{indent}{m} \n")
- end
- done.add(m)
- redo = true
- end
- end
- if not redo then
- dirstack.pop
- if not dirstack.is_empty then
- curdir = dirstack[dirstack.length-1]
- indent = " " * dirstack.length
- end
+ # Builds the various module hierarchies
+ var mnh = new PartialOrder[MMModule] # nested module hierarchy
+ var tmh = new PartialOrder[MMModule] # top module import hierrchy
+ var ms = mainmod.mhe.linear_extension.reversed
+ for m in ms do
+ if ms == mainmod then continue
+ m.mnhe_ = mnh.add(m, owns[m])
+ var pub = new Array[MMModule]
+ for m2 in m.mhe.greaters do
+ if m2.toplevel_owner != m2 and m2.toplevel_owner != m.toplevel_owner then continue
+ if m.mnhe <= m2 then continue
+ if m.visibility_for(m2) <= 0 then
+ # nothing
+ else if m.visibility_for(m2) == 1 then
+ else
+ pub.add(m2)
end
end
+ m.tmhe_ = tmh.add(m, pub)
end
- add("\n")
- write_to("{dir}/menu-frame.html")
+ var head = "" +
+ "\n" +
+ "\n" +
+ ""
+
+ var action_bar = "\n"
+
+ # generate the index
+ self.filename = "index.html"
clear
- add_header("Index")
- add("
\n")
- sort(_entities)
- for e in _entities do
- add("
")
+ var modss = mainmod.mhe.greaters_and_self.to_a
+ sort(modss)
+ for mod in modss do
+ if not mod.is_toplevel then continue
+ if not mod.require_doc(self) then continue
+ assert mod isa MMSrcModule
+ add("
{mod.html_link(self)} {mod.short_doc}
")
+
end
- add("\n")
- write_to("{dir}/index-1.html")
+ add("
")
- clear
- add_header("Overview")
- add("
\n")
- add("
Overview of all Modules
\n")
- for m in modules do
- add("
{m.html_link(self)}
{m.short_doc}
\n")
+ var op = new Buffer
+ op.append("digraph dep \{ rankdir=BT; node[shape=none,margin=0,width=0,height=0,fontsize=10]; edge[dir=none,color=gray]; ranksep=0.2; nodesep=0.1;\n")
+ for mod in modss do
+ if not mod.is_toplevel then continue
+ if not mod.require_doc(self) then continue
+ op.append("\"{mod.name}\"[URL=\"{mod.html_name}.html\"];\n")
+ for mod2 in mod.tmhe.direct_greaters do
+ if not modss.has(mod2) then continue
+ op.append("\"{mod.name}\"->\"{mod2.name}\";\n")
+ end
end
- add("